SPARC methodology -- Specification, Pseudocode, Architecture, Refinement, Completion phases with quality gates between each phase.
Drives features through a rigorous five-phase development lifecycle. Each phase has a quality gate that must pass before advancing. The orchestrator spawns specialized agents per phase (researcher, planner, system-architect, coder/tester, reviewer) and stores all artifacts and gate results in memory for traceability.
claude --plugin-dir plugins/ruflo-sparc| Skill | Usage | Description |
|---|---|---|
sparc-spec |
/sparc-spec <feature-description> |
Run the Specification phase -- gather requirements, define acceptance criteria, identify constraints |
sparc-implement |
/sparc-implement |
Run the Architecture and Implementation phases -- design modules, write pseudocode, implement, test |
sparc-refine |
/sparc-refine |
Run Refinement and Completion -- review code, improve coverage, validate against spec, generate docs |
sparc init <feature> # Initialize a new SPARC workflow
sparc status # Show current phase and gate history
sparc advance # Attempt gate check, advance to next phase
sparc phase <phase-name> # Jump to a specific phase (spec/pseudo/arch/refine/complete)
sparc report # Generate full SPARC methodology report with traceability matrix| Phase | Name | Gate Criteria | Spawned Agent |
|---|---|---|---|
| 1 | Specification | >= 3 acceptance criteria, constraints, edge cases | researcher |
| 2 | Pseudocode | Covers all ACs, error paths explicit, complexity annotated | planner |
| 3 | Architecture | All constraints addressed, typed API contracts, no circular deps | system-architect |
| 4 | Refinement | All ACs have passing tests, review approved, coverage >= 80% | coder + tester |
| 5 | Completion | All tests green, docs complete, deployment checklist verified | reviewer |
| Namespace | Purpose |
|---|---|
sparc-state |
Current phase tracking per feature |
sparc-phases |
Phase artifacts (specs, pseudocode, ADRs, reports) |
sparc-gates |
Gate check results and history |
patterns |
Learned SPARC execution patterns |
- CLI: pinned to
@claude-flow/cliv3.6 major+minor. - Verification:
bash plugins/ruflo-sparc/scripts/smoke.shis the contract.
Each SPARC phase has a canonical handoff plugin that owns its deeper tooling:
| Phase | Owner | What it provides |
|---|---|---|
| Specification | ruflo-goals (deep-research) | Multi-source research orchestration to gather requirements |
| Pseudocode | ruflo-sparc (this plugin) |
Pseudocode generation + complexity annotation |
| Architecture | ruflo-adr + ruflo-ddd | ADR creation + bounded-context modeling |
| Refinement | ruflo-jujutsu + ruflo-testgen | Diff-aware refactor + test gap analysis |
| Completion | ruflo-docs | Auto-generated documentation |
This plugin orchestrates the lifecycle; sibling plugins do the deep work per phase.
This plugin owns three AgentDB namespaces, all kebab-case compliant per ruflo-agentdb ADR-0001 §"Namespace convention":
Additionally, the shared patterns (plural) namespace is consumed (not owned) for cross-feature SPARC pattern learning — note the pluralization (different from the singular pattern ReasoningBank target). Reserved namespaces (pattern, claude-memories, default) MUST NOT be shadowed.
bash plugins/ruflo-sparc/scripts/smoke.sh
# Expected: "11 passed, 0 failed"ruflo-agentdb— namespace convention owner; backing store for sparc-state/-phases/-gatesruflo-goals— Specification phase deep-researchruflo-adr-- Architecture decisions recorded as ADRs in Phase 3ruflo-ddd-- Architecture phase uses DDD bounded context patternsruflo-jujutsu-- Refinement phase diff analysisruflo-docs-- Completion phase documentation generation
MIT