claudecodex

factor-harness

Architecture-aware review, refactor, and cross-implementation dedup — surfaces bugs, smells, and precedent gaps, then emits specs for Superpowers to execute.

0 on GitHubby Steve Morinv0.2.0MITupdated yesterdayDeveloper Tools
/

Plugin factor-harness from marketplace smorinlabs-skills in smorinlabs/smorinlabs-skills. Commands read from the repo's manifest — today.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (4)

  • factor-architect

    Architectural review of a plan before code is written, or of delivered code after, against precedent, conventions, and external references, producing a refactor spec for writing-plans. Use when the user asks "review this plan", "is this architecturally sound?", or "any refactor opportunities?". Not

  • factor-dedup

    Consolidate several similar implementations by classifying their divergences as intentional or accidental and proposing a unified design, as a spec for writing-plans. Use when the user says "consolidate these", "DRY this up", "these all look the same", or "extract common code". Not for architecture

  • factor-scan

    Sweep a directory, file set, or recent changes for bugs, quality issues, and architectural smells, walking findings one at a time into a spec for writing-plans. Use when the user asks "any bugs in this?", "audit these files", "what's wrong here?", or "code health check". Not for architecture review

  • using-factor-harness

    Route code-quality requests to the right factor-harness skill, factor-architect for architecture review, factor-scan for bug and quality sweeps, or factor-dedup for consolidating duplicates. Use when the user asks for an architecture review, refactor opportunities, or duplicate consolidation without

Subagents (3)

  • factor-comparator

    Read-only comparator subagent dispatched by factor-dedup (and factor-architect) to read one implementation in detail and report its structure, behavior, and notable details in a form suitable for cross-comparison. Returns observations only — never proposes consolidation direction.

  • factor-researcher

    Read-only research subagent dispatched by factor-architect (and factor-dedup) to consult external sources for canonical architectural patterns, ecosystem idioms, and good-pattern references. Returns sourced recommendations with attribution; never modifies the codebase.

  • factor-scanner

    Read-only scanner subagent dispatched by factor-scan (and occasionally factor-architect) to scan one file or directory for bugs, quality issues, and architectural smells. Returns a structured finding list with severity, evidence, and recommended actions.

Hooks (1)

  • SessionStart

    "${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd" session-start

View source on GitHub

More from smorinlabs/smorinlabs-skills

All 16 plugins →

project-harness

claudecodex

Lightweight PROJECTS.md project management — capture, scope, decompose, triage, and drift-audit projects as auto-triggering skills that hand execution off to Superpowers.

5 skills · 2 agents · hooks

0

repo-hygiene

claudecodex

Repo & release-readiness checks — CI fix and audit (measured, targeted, escalating), version drift, README sync, manual test guides, a PR merge flow that resolves every review thread before merging, and a Dependabot sweep that clears open dependency PRs across configured orgs.

6 skills

0

session

claudecodex

Session-state quintet for coding sessions: session-recap orients when returning to one (arc, done/open, git/PR/worktree state, ranked next steps, close-or-continue verdict — strictly read-only); session-loose-ends is its acting sibling — sweeps working-state artifacts, processes, unfulfilled promises, and tracking drift, reports each with evidence and a keep-or-clean recommendation both ways, then executes and verifies only what was confirmed item by item; session-handoff faces forward — it packages the current session into a self-contained, machine-portable handoff (outcome, repo identity, resume state, and the tacit context that dies on compaction) for a fresh zero-context session to pick up cold; session-status is the mid-flight glance — a manually-triggered, plain-language progress map of the active stream (done rolled up, what's left fine-grained where you stand), probe-free and read-only, with an ASCII kanban board of what's left when work runs in parallel or much remains; session-agent-list finds and lists Claude Code, Codex, Muse, and OpenCode sessions across the machine as action-ready cards — end-state triage (open / handed off / closed clean / loose ends), each tool's session name, what is running now, lineage, and copy-paste resume or transcript commands, filterable by tool.

5 skills

0

use-html-theme

claudecodex

Themed-HTML toolkit, three pure skills sharing one context-triage preflight. use-html-theme: on any HTML-generation request, offer a catalog of visual themes (Birchline warm-editorial, Technical-minimal docs-site, High-contrast-dark dashboard), apply the chosen theme to all subsequent HTML in the session, and optionally persist it per-project — natural language and [theme: x] inline-flag control, side-by-side preview on request. html-codesign: interactive 'pick and export' decision pages, opened as a step-through wizard by default (Next/Back, progress dots, Finish-to-review; full-list view one toggle away) — every question opens with a collapsible context-and-recommendation preamble (free-form rich content on a clarity scaffold) in clear, plain, self-explanatory language (sharpened by clear-technical-communication when installed, an embedded digest otherwise), the reader answers, skips, or raises a question on each section, folds answered sections to dense summary rows for review, then exports the decision as Markdown/JSON (slim by default, full ADR-style by toggle) with stable IDs for diffable iteration. html-explain: read-only explainer pages for settled material — authoring maps which parts are intrinsically hardest and budgets the page around them, then enriches with diagrams, annotated figures, build-up sequences, and manipulable widgets ONLY where comprehension actually breaks; clarity canon (Mayer, Sweller, Minto, Heath, Tufte, Bertin, Cleveland) carried as advisory aids, with a standalone encoding fallback for surfaces where the bundled dataviz skill does not exist. Both page skills read recent context and ALWAYS confirm before generating — codesign for unanswered questions, explain for settled work — and hand off to each other when triage disagrees with the request. Both page skills close delivery the same way: the full absolute path on its own line, then conditional convenience offers — open it in the browser only when the session can reach one, add it to

3 skills

0

fusion-runner

claudecodex

Prepare Windows in VMware Fusion for local standard-account checks or GitHub Actions, then start, inspect, stop, or explicitly reset the working VM.

2 skills

0

Decision requests from an agent to a human during a run. Checks existing authorization, investigates discoverable facts, and requests unavailable human-supplied information without turning it into an approval. Sizes preparation and explanation by seven axes into three tiers, rechecks uncertainty after verification, and keeps material caveats visible beyond the length targets. Uses same-input tables, worked examples, event sequences, and ASCII diagrams with exact verbatim content. Questions and options have stable meanings; revised choices supersede old IDs. Recommendations use option A when supported, with an explicit neutral form otherwise. Silence and skip never grant authority. Adapts a self-contained brief to the available question tool or ordinary text, with independent work continuing while required answers remain pending. Significant decisions retain their rationale and approval scope. Includes behavioral evaluation cases. Never produces HTML artifacts.

1 skill

0

Similar plugins

Matt Pocock's agent skills for real engineering (grilling, spec/ticket flows, TDD, code review, domain modelling and more).

39 skills

mattpocock/skills 323,108

superpowers

claudecodex

Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques

15 skills · hooks

obra/superpowers 316,836

AI-powered codebase understanding — analyze, visualize, and explain any project

9 skills · 10 agents · hooks

Egonex-AI/Understand-Anything 92,410

diagram-design

claudecodex

Editorial diagrams in your brand, as self-contained HTML and SVG. Architecture, flowcharts, sequence, state machines, ER and database schemas, timelines, swimlanes, org charts, Gantt, Wardley maps, user journeys, service blueprints, UML class, lifecycle phase maps, and charts from bar, line and scatter to Sankey, treemap and heatmap, plus many more. Redraws draw.io, Mermaid, Excalidraw and PlantUML files. Exports SVG and PNG.

1 skill · 7 commands

cathrynlavery/diagram-design 66,757

context7

claudecodex

Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.

1 MCP server

upstash/context7 64,709

Use Alibaba Open Code Review from local Codex.

2 skills

alibaba/open-code-review 50,068

Maintain factor-harness?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins16 plugins