By simon-potter
28 workflow skills covering the full engineering cycle: capture, challenge, spec, plan, build, test, review, simplify, ship, learn, and quality maintenance
Cross-cutting — Audit both the project .claude/ and personal ~/.claude/ for quality issues. Covers CLAUDE.md scope and length, agent descriptions, skill frontmatter, and settings.json conflicts. Always audits both scopes. Produces a prioritised P1/P2/P3 fix list.
Phase 2 — Approve plan. Reviews the task list from spec for quality (atomicity, testability, clarity), then applies four adversarial lenses (Skeptic, Architect, Minimalist, Security) as advisory input for the human reviewer. Quality issues are blocking; adversarial findings are advisory. Security lens identifies tasks touching auth, billing, user input, or secrets so the builder has explicit awareness before writing those tasks. Presents everything for explicit human go/no-go before building starts.
Phase 3 orchestrator — Full Red-Green-Refactor cycle. For each pending task: invokes write-tests (Red: write failing tests), then opsx:apply (Green: implement via OpenSpec), then run-tests (Verify: confirm green before moving on). Loops until all tasks complete. After all tasks complete, runs opsx:verify (spec sign-off), then recommends simplify (Refactor).
Pre-phase orchestrator — accepts any input (issue tracker ticket, Slack message, file, or freeform description), classifies it as a bug or a change, then routes to the appropriate path. Bug path runs systematic root-cause investigation and produces todo/BUG-{slug}.md. Change path runs a lightweight qualification check and produces todo/{slug}.md. Both outputs feed /spwf:challenge.
Gate — Challenge a plan, ideation file, or design relentlessly. Accepts a file path as $ARGUMENTS (defaults to the most recent file in todo/ if omitted). Reads the file first, interviews until all open questions are resolved, then runs a scope-sizing check — recommends splitting into multiple changes if the work spans independent boundaries, or proceeding as one change if tightly coupled.
Modifies files
Hook triggers on file write and edit operations
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Simon's engineering workflow, packaged as two installable Claude Code plugins.
[status] → [Capture] → Challenge → Spec → Approve plan → Build → Simplify → PR Create → PR Review → Close
(orient) (pre) (gate) (1) (2) (3) (4) (5) (6) (post)
| Step | Command | Invokes | Why | Produces |
|---|---|---|---|---|
| Orient | /spwf:wfstatus | — | Start of session: where am I, what's incomplete, what's next — heuristics across git state, OpenSpec changes, and todo backlog | Dashboard + suggested next action |
| Capture | /spwf:capture [source] | Issue tracker MCP (YouTrack default; Jira supported) | Accepts a tracker ticket (e.g. ACAD-42), file, or freeform description; classifies as bug or change automatically. Bug path: systematic root-cause investigation → hypothesis. Change path: lightweight qualification, one question at a time. | todo/{slug}.md or todo/BUG-{slug}.md |
| Challenge | /spwf:challenge todo/{slug}.md | — | Interviews relentlessly until all open questions are resolved, then runs a scope-sizing check — recommends splitting into independent changes if the work spans natural boundaries, or proceeds as one change if tightly coupled | Resolved ideation file; or N child todo files + original marked status: split |
| Spec | /spwf:spec todo/{slug}.md | openspec CLI | Formalises the challenged idea into a structured spec | openspec/changes/{id}/proposal.md, design.md, tasks.md, specs/ |
| Approve plan | /spwf:approve-plan | — | Quality check (blocking) + adversarial review via Skeptic/Architect/Minimalist lenses (advisory); explicit human go/no-go before building | Approved task list or flagged issues to resolve |
| Build | /spwf:build | write-tests → opsx:apply → run-tests → debug-recovery → opsx:verify | Red-Green-Verify per task, loops until all done; spec sign-off after all tasks complete | All tasks complete, tests green, spec aligned |
| Simplify (TDD Refactor) | /spwf:simplify | — | Clean up the implementation with tests as a safety net; flags judgment calls | Cleaner diff; flag list |
| PR / MR Create | /spwf:pr-create | dep-audit · forge CLI (glab default; gh supported) | Pre-flight checks (gitleaks, semgrep, dep-audit across all ecosystems + Docker) then request creation via the forge auto-detected from git remote; CI/CD owns the rest | PR / MR URL |
| PR / MR Review | /spwf:pr-review <ref> | forge CLI (glab mr view/diff default; gh pr view/diff supported) | Structured review before merge; catches regressions and drift | Review report with verdict |
| Close | /spwf:close [todo/{slug}.md] | retrospective → opsx:archive → Issue tracker MCP | Final phase — runs the full retrospective (learn-from-mistakes, spec audit, doc-lint, workflow-lint, optional changelog), then after explicit confirmation marks the todo file complete, archives the OpenSpec change, and transitions the linked tracker ticket to its done state (per .spwf/tracker.yaml) | Closed todo, archived change, tracker ticket marked done |
A second class of skills sits outside the main workflow. These are cross-cutting maintenance tools — run them between sessions, on a cadence, or when something feels off. They don't produce code; they keep the workspace itself in good shape.
npx claudepluginhub simon-potter/spwf --plugin spwf14 specialist subagents covering every phase of the SPWorkflow engineering cycle
Tools to maintain and improve CLAUDE.md files - audit quality, capture session learnings, and keep project memory current.
A growing collection of Claude-compatible academic workflow bundles. Covers scientific figures, manuscript writing and polishing, reviewer assessment, citation retrieval, data availability, paper reading, literature search, response letters, paper-to-PPTX conversion, and evidence-grounded Chinese invention patent drafting. Rules are organized as reusable skill folders with explicit workflows and quality checks.
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Harness-native ECC operator layer - 67 agents, 271 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Superpowers Plus core skills library for Claude Code: planning, execution routing, TDD, debugging, and collaboration workflows
Browser automation and end-to-end testing MCP server by Microsoft. Enables Claude to interact with web pages, take screenshots, fill forms, click elements, and perform automated browser testing workflows.