plugins/ruflo-sparc/README.md
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
| Agent | Model | Role |
|---|---|---|
sparc-orchestrator | sonnet | Orchestrate 5-phase SPARC lifecycle, enforce gate checks, spawn phase-specific agents, track state in memory |
| 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 |
@claude-flow/cli v3.6 major+minor.bash plugins/ruflo-sparc/scripts/smoke.sh is 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 four AgentDB namespaces, all kebab-case compliant per ruflo-agentdb ADR-0001 §"Namespace convention":
| Namespace | Purpose |
|---|---|
sparc-state | Current phase tracking per feature |
sparc-phases | Phase artifacts (specs, pseudocode, ADRs, reports) |
sparc-gates | Gate check results and history |
The reserved patterns (plural) namespace is consumed 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 generationMIT