claude-swe-workflows

claude-swe-workflows

A system of composable software engineering workflows for [Claude Code][cc]. Plan projects, implement tickets, and run quality passes — from a single ticket to a multi-batch project, using the same layered architecture.

Installation

claude plugin marketplace add https://github.com/chrisallenlane/claude-swe-workflows.git
claude plugin install claude-swe-workflows@claude-swe-workflows

Layered Composition

The skills are arranged as layered composition — higher-level skills invoke lower-level ones. Enter at the layer that matches your task. The deepest stack:

/lead-project                              ← autonomous tech lead (decides what to do next)
└── invokes any skill below
    /implement-project                     ← full-lifecycle project execution
    └── /implement-batch                   ← one batch of related tickets
        └── /implement                     ← one ticket, end-to-end
            └── SME agents                 ← language-specific specialists

Three other entry points orchestrate bounded autonomous loops:

• /lead-bug-hunt — loops /bug-hunt → /implement-batch until bugs converge below a severity floor.
• /lead-refactor — /refactor → loops /review-arch + /implement-batch → /refactor.
• /lead-review — runs every /review-* sub-skill once.

Planning feeds implementation: /scope-project → /implement-project, or /scope → /implement. Supporting skills (/think-*, /review-*, /bug-*, /tidy-*) compose into any of the orchestrators above or run standalone.

Namespaces

Skills are grouped by namespace for discoverability. Each namespace gathers skills with a related purpose.

Namespace	Purpose	Skills
/lead-*	Autonomous orchestrators	/lead-project, /lead-bug-hunt, /lead-refactor, /lead-review
/implement-*	Implement tickets (mutate the working tree)	/implement, /implement-batch, /implement-project
/scope-*	Plan and produce tickets	/scope, /scope-project
/review-*	Advisory audits — no code changes	/review-arch, /review-test, /review-perf, /review-a11y, /review-health, /review-security, /review-release
/think-*	Reasoning support — no artifacts	/think-reframe, /think-brainstorm, /think-diagnose, /think-ach, /think-deliberate, /think-premortem, /think-scrutinize, /think-reflect
/tidy-*	Mechanical hygiene	/tidy-docs, /tidy-git
/bug-*	Find and fix bugs	/bug-fix, /bug-hunt
/test-*	Test-quality work	/test-mutation
(standalone)	Skills that don't share a namespace	/refactor, /pre-compact, /release

The /lead-* and /implement-* namespaces additionally share an autonomy discipline (commander's intent, pre-loaded options, pre-rebutted recommendations, risk budgets) — see references/autonomy.md. The /think-* namespace shares a design discipline (practitioner-sourced countermeasures to specific cognitive failure modes) — see references/think.md.

Choosing a Workflow

Not everything needs the full pipeline. Enter at the level that matches your task: