/ruflo-sparc

name: ruflo-sparc
description: SPARC methodology commands — initialize, track, advance, and report on Specification-Pseudocode-Architecture-Refinement-Completion workflows

$ARGUMENTS

Handle SPARC methodology commands based on the subcommand:

Subcommands

`sparc init <feature>`

Initialize a new SPARC workflow for the given feature: 1. Create a feature slug from the feature name (lowercase, hyphenated) 2. Call `mcp__plugin_ruflo-core_ruflo__memory_store` with namespace `sparc-state`, key `current-phase-{slug}`, value `{ "phase": 1, "phaseName": "Specification", "feature": "<feature>", "startedAt": "<ISO timestamp>", "gateAttempts": 0, "artifacts": [] }` 3. Call `mcp__plugin_ruflo-core_ruflo__memory_store` with namespace `sparc-phases`, key `spec-{slug}`, value `{ "status": "pending", "requirements": [], "acceptanceCriteria": [], "constraints": [], "edgeCases": [] }` 4. Display: "SPARC workflow initialized for **<feature>**. Current phase: **1 - Specification**. Run `/sparc status` to view progress or begin the specification phase with `/sparc-spec <feature-description>`."

`sparc status`

Show current SPARC phase and gate check results: 1. Call `mcp__plugin_ruflo-core_ruflo__memory_search` with namespace `sparc-state` and query `current-phase` to list all active SPARC workflows 2. For each workflow, display:

• Feature name and slug
• Current phase number and name (1-Specification, 2-Pseudocode, 3-Architecture, 4-Refinement, 5-Completion)
• Phase start time and duration
• Gate attempt count

3. Call `mcp__plugin_ruflo-core_ruflo__memory_search` with namespace `sparc-gates` and query matching the feature slug to list gate check history 4. For each gate result, show: phase, passed/failed, criteria details, blockers if any 5. Display a progress bar: `[=====> ] Phase 3/5 — Architecture`

`sparc advance`

Attempt to pass the current gate and advance to the next phase: 1. Retrieve current state from `sparc-state` namespace 2. Retrieve phase artifacts from `sparc-phases` namespace 3. Run the gate check for the current phase:

• **Phase 1 gate**: Verify spec has >= 3 acceptance criteria, explicit constraints, and edge cases identified
• **Phase 2 gate**: Verify pseudocode covers all acceptance criteria, error paths are explicit, complexity annotated
• **Phase 3 gate**: Verify architecture addresses all constraints, API contracts are typed, no circular dependencies
• **Phase 4 gate**: Verify all acceptance criteria have passing tests, code review approved, coverage >= 80%
• **Phase 5 gate**: Verify all tests green, docs complete, deployment checklist verified, traceability matrix complete

4. Store gate result in `sparc-gates` namespace with key `gate-{phase}-{slug}-{timestamp}` 5. If gate passes:

• Increment phase in `sparc-state`
• Display: "Gate **passed**. Advancing to Phase {N} — {PhaseName}."
• If advancing past Phase 5: "SPARC workflow **complete** for {feature}. All gates passed."

6. If gate fails:

• Increment `gateAttempts` in state
• Display: "Gate **failed**. Blockers:" followed by the list of failing criteria
• Suggest specific actions to address each blocker

`sparc phase <phase-name>`

Jump to a specific phase (for re-entry or iteration): 1. Validate phase-name is one of: `specification`, `pseudocode`, `architecture`, `refinement`, `completion` (or `spec`, `pseudo`, `arch`, `refine`, `complete` as aliases, or a number 1-5) 2. Retrieve current state from `sparc-state` namespace 3. Update phase number and name in state 4. Store warning if jumping forward (skipping gates): "Jumping forward skips gate checks. Run `/sparc advance` from previous phases to ensure quality." 5. Display: "Phase set to **{N} — {PhaseName}** for {feature}."

`sparc report`

Generate a full SPARC methodology report: 1. Retrieve all data from `sparc-state`, `sparc-phases`, and `sparc-gates` namespaces for the active feature 2. Generate a structured report:

   # SPARC Report: {Feature}

   ## Phase Summary
   | Phase | Status | Gate | Attempts | Duration |
   |-------|--------|------|----------|----------|
   | 1 - Specification | Complete | Passed | 1 | 2h |
   | 2 - Pseudocode | Complete | Passed | 2 | 3h |
   | 3 - Architecture | In Progress | — | 0 | 1h |
   | 4 - Refinement | Pending | — | — | — |
   | 5 - Completion | Pending | — | — | — |

   ## Specification
   - Requirements: [list]
   - Acceptance Criteria: [list]
   - Constraints: [list]

   ## Pseudocode
   - Algorithms: [summary]
   - Data Structures: [summary]

   ## Architecture
   - Bounded Contexts: [list]
   - API Contracts: [summary]

   ## Gate History
   [chronological list of gate attempts with pass/fail details]

   ## Traceability Matrix
   | Acceptance Criterion | Test | Status |
   |---------------------|------|--------|
   | AC-1: ... | test_xxx | Pass |

3. Display the report