specflow-cc 1.0.0 → 1.2.0

package/commands/sf/audit.md

@@ -32,7 +32,7 @@ Audit the active specification using a fresh context subagent. The auditor evalu
 ```
 SpecFlow not initialized.
 
-Run `/sf init` first.
+Run `/sf:init` first.
 ```
 Exit.
 
@@ -44,7 +44,7 @@ Read `.specflow/STATE.md` and extract Active Specification.
 ```
 No active specification to audit.
 
-Run `/sf new "task description"` to create one.
+Run `/sf:new "task description"` to create one.
 ```
 Exit.
 
@@ -56,7 +56,7 @@ Read the active spec file: `.specflow/specs/SPEC-XXX.md`
 ```
 Specification SPEC-XXX is already audited (status: {status}).
 
-Use `/sf run` to implement or `/sf status` to see current state.
+Use `/sf:run` to implement or `/sf:status` to see current state.
 ```
 Exit.
 
@@ -90,7 +90,7 @@ The agent will:
 
 ## Step 6: Display Result
 
-### If APPROVED:
+### If APPROVED (no recommendations):
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -106,7 +106,31 @@ The agent will:
 
 ## Next Step
 
-`/sf run` — implement specification
+`/sf:run` — implement specification
+```
+
+### If APPROVED (with optional recommendations):
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ AUDIT PASSED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Specification:** SPEC-XXX
+**Status:** APPROVED
+
+### Recommendations (Optional)
+
+1. [Recommendation 1]
+2. [Recommendation 2]
+
+---
+
+## Next Steps
+
+Choose one:
+• `/sf:run` — implement specification as-is
+• `/sf:revise` — apply optional recommendations first ({N} items)
 ```
 
 ### If NEEDS_REVISION:
@@ -132,12 +156,12 @@ The agent will:
 
 ## Next Step
 
-`/sf revise` — address critical issues
+`/sf:revise` — address critical issues
 
 Options:
-- `/sf revise all` — apply all feedback
-- `/sf revise 1,2` — fix specific issues
-- `/sf revise [instructions]` — custom changes
+- `/sf:revise all` — apply all feedback
+- `/sf:revise 1,2` — fix specific issues
+- `/sf:revise [instructions]` — custom changes
 ```
 
 </workflow>
@@ -194,8 +218,8 @@ Append to spec's Audit History:
 
 ### Update STATE.md
 
-- If APPROVED: Status → "audited", Next Step → "/sf run"
-- If NEEDS_REVISION: Status → "revision_requested", Next Step → "/sf revise"
+- If APPROVED: Status → "audited", Next Step → "/sf:run"
+- If NEEDS_REVISION: Status → "revision_requested", Next Step → "/sf:revise"
 
 </fallback>
 

package/commands/sf/deps.md

@@ -33,7 +33,7 @@ Display the dependency graph between specifications. Shows which specs can be wo
 ```
 SpecFlow not initialized.
 
-Run `/sf init` first.
+Run `/sf:init` first.
 ```
 Exit.
 
@@ -51,7 +51,7 @@ ls .specflow/specs/SPEC-*.md 2>/dev/null
 
 No specifications found.
 
-Create your first spec: `/sf new "task description"`
+Create your first spec: `/sf:new "task description"`
 ```
 Exit.
 
@@ -88,7 +88,7 @@ Build dependency map:
 ```
 Specification {ID} not found.
 
-Use `/sf list` to see available specifications.
+Use `/sf:list` to see available specifications.
 ```
 Exit.
 
@@ -128,12 +128,12 @@ None — no other specifications depend on this.
 {If blocked:}
 **Blocked by:** {blocking spec ID} must complete first.
 
-When {blocking ID} is done, run: `/sf run {ID}`
+When {blocking ID} is done, run: `/sf:run {ID}`
 
 {If ready:}
 **Ready:** All dependencies satisfied.
 
-Next: `/sf audit {ID}` or `/sf run {ID}`
+Next: `/sf:audit {ID}` or `/sf:run {ID}`
 
 {If done:}
 **Complete:** This specification is done.
@@ -212,11 +212,11 @@ SPEC-003 [audited] → SPEC-004 [draft]
 **Next actionable:**
 {List specs that are ready to work on, sorted by priority}
 
-- `/sf run SPEC-001b` (running)
-- `/sf audit SPEC-005` (audited)
-- `/sf audit SPEC-002` (draft)
+- `/sf:run SPEC-001b` (running)
+- `/sf:audit SPEC-005` (audited)
+- `/sf:audit SPEC-002` (draft)
 
-**Tip:** `/sf deps SPEC-XXX` for details on a specific spec.
+**Tip:** `/sf:deps SPEC-XXX` for details on a specific spec.
 ```
 
 </workflow>

package/commands/sf/done.md

@@ -31,7 +31,7 @@ Finalize the completed specification. Archives the spec, updates STATE.md, extra
 ```
 SpecFlow not initialized.
 
-Run `/sf init` first.
+Run `/sf:init` first.
 ```
 Exit.
 
@@ -43,7 +43,7 @@ Read `.specflow/STATE.md` and extract Active Specification.
 ```
 No active specification to finalize.
 
-Run `/sf new "task description"` to create one.
+Run `/sf:new "task description"` to create one.
 ```
 Exit.
 
@@ -89,7 +89,7 @@ Continue anyway?
 
 Use AskUserQuestion with options:
 - "Yes, finalize anyway" → continue, log warning
-- "No, run review first" → exit with `/sf review` suggestion
+- "No, run review first" → exit with `/sf:review` suggestion
 
 **If user proceeds anyway:**
 Log in STATE.md Warnings table:
@@ -147,7 +147,7 @@ mv .specflow/specs/SPEC-XXX.md .specflow/archive/
 
 - Active Specification → "none"
 - Status → "idle"
-- Next Step → "/sf new or /sf next"
+- Next Step → "/sf:new or /sf:next"
 
 ### Remove from Queue
 
@@ -213,13 +213,13 @@ git commit -m "docs(sf): complete SPEC-XXX
 {If queue has more specs:}
 **Next in queue:** SPEC-YYY — {title}
 
-Run `/sf next` to start the next specification.
+Run `/sf:next` to start the next specification.
 
 {If queue is empty:}
 Queue is empty.
 
-Run `/sf new "task"` to create a new specification
-or `/sf todos` to see pending ideas.
+Run `/sf:new "task"` to create a new specification
+or `/sf:todos` to see pending ideas.
 ```
 
 </workflow>
@@ -244,7 +244,7 @@ mv .specflow/specs/SPEC-XXX.md .specflow/archive/
 
 1. Set Active Specification to "none"
 2. Set Status to "idle"
-3. Set Next Step to "/sf new or /sf next"
+3. Set Next Step to "/sf:new or /sf:next"
 4. Remove from Queue table
 5. Add any extracted decisions
 

package/commands/sf/fix.md

@@ -34,7 +34,7 @@ Fix the implementation based on review feedback. Can apply all fixes, specific n
 ```
 SpecFlow not initialized.
 
-Run `/sf init` first.
+Run `/sf:init` first.
 ```
 Exit.
 
@@ -46,7 +46,7 @@ Read `.specflow/STATE.md` and extract Active Specification.
 ```
 No active specification to fix.
 
-Run `/sf new "task description"` to create one.
+Run `/sf:new "task description"` to create one.
 ```
 Exit.
 
@@ -59,7 +59,7 @@ Read the active spec file: `.specflow/specs/SPEC-XXX.md`
 Specification SPEC-XXX is not in review status (status: {status}).
 
 {If not yet run:}
-Run `/sf run` first to implement the specification.
+Run `/sf:run` first to implement the specification.
 
 {If already done:}
 Specification already completed.
@@ -74,7 +74,7 @@ Find the most recent "Review v[N]" section in Review History.
 ```
 Specification SPEC-XXX has no review history.
 
-Run `/sf review` first to get feedback.
+Run `/sf:review` first to get feedback.
 ```
 Exit.
 
@@ -165,7 +165,7 @@ Append to Review History:
 ## Step 8: Update STATE.md
 
 - Status → "review" (ready for re-review)
-- Next Step → "/sf review"
+- Next Step → "/sf:review"
 
 ## Step 9: Display Result
 
@@ -193,7 +193,7 @@ Append to Review History:
 
 ## Next Step
 
-`/sf review` — re-review to verify fixes
+`/sf:review` — re-review to verify fixes
 ```
 
 </workflow>
@@ -256,7 +256,7 @@ Append to Review History.
 ### Update STATE.md
 
 - Status → "review"
-- Next Step → "/sf review"
+- Next Step → "/sf:review"
 
 </fallback>
 

package/commands/sf/help.md

@@ -38,7 +38,7 @@ Check if command exists:
 ```
 Unknown command: {command}
 
-Run `/sf help` for available commands.
+Run `/sf:help` for available commands.
 ```
 Exit.
 
@@ -51,7 +51,7 @@ Read the command file and extract:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- /sf {command}
+ /sf:{command}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 {Description from frontmatter}
@@ -59,7 +59,7 @@ Read the command file and extract:
 ## Usage
 
 ```
-/sf {command} {arguments syntax}
+/sf:{command} {arguments syntax}
 ```
 
 ## Description
@@ -85,68 +85,68 @@ Read the command file and extract:
 
 ### Command-Specific Examples
 
-**For `/sf new`:**
+**For `/sf:new`:**
 ```
 ## Examples
 
 ```
-/sf new "Add user authentication with JWT"
-/sf new "Fix pagination bug in user list"
-/sf new "Refactor UserService to use repository pattern"
-/sf new                    # Interactive mode
+/sf:new "Add user authentication with JWT"
+/sf:new "Fix pagination bug in user list"
+/sf:new "Refactor UserService to use repository pattern"
+/sf:new                    # Interactive mode
 ```
 ```
 
-**For `/sf audit`:**
+**For `/sf:audit`:**
 ```
 ## Examples
 
 ```
-/sf audit                  # Audit active specification
-/sf audit SPEC-003         # Audit specific specification
+/sf:audit                  # Audit active specification
+/sf:audit SPEC-003         # Audit specific specification
 ```
 ```
 
-**For `/sf run`:**
+**For `/sf:run`:**
 ```
 ## Examples
 
 ```
-/sf run                    # Run active specification
-/sf run SPEC-003           # Run specific specification
+/sf:run                    # Run active specification
+/sf:run SPEC-003           # Run specific specification
 ```
 ```
 
-**For `/sf revise`:**
+**For `/sf:revise`:**
 ```
 ## Examples
 
 ```
-/sf revise                 # Interactive — shows audit comments
-/sf revise all             # Apply all audit comments
-/sf revise 1,2             # Apply only comments 1 and 2
-/sf revise "add error handling, ignore item 3"
+/sf:revise                 # Interactive — shows audit comments
+/sf:revise all             # Apply all audit comments
+/sf:revise 1,2             # Apply only comments 1 and 2
+/sf:revise "add error handling, ignore item 3"
 ```
 ```
 
-**For `/sf split`:**
+**For `/sf:split`:**
 ```
 ## Examples
 
 ```
-/sf split                  # Split active specification
-/sf split SPEC-001         # Split specific specification
+/sf:split                  # Split active specification
+/sf:split SPEC-001         # Split specific specification
 ```
 ```
 
-**For `/sf todo`:**
+**For `/sf:todo`:**
 ```
 ## Examples
 
 ```
-/sf todo "Add caching layer for API"
-/sf todo "Research WebSocket alternatives"
-/sf todo "Refactor authentication flow"
+/sf:todo "Add caching layer for API"
+/sf:todo "Research WebSocket alternatives"
+/sf:todo "Refactor authentication flow"
 ```
 ```
 
@@ -171,81 +171,81 @@ Workflow: Spec → Audit → Revise → Run → Review → Fix → Done
 
 | Command      | Description                             |
 |--------------|-----------------------------------------|
-| /sf init     | Initialize project, analyze codebase    |
-| /sf new      | Create specification from task          |
-| /sf audit    | Audit specification (fresh context)     |
-| /sf revise   | Revise spec based on audit feedback     |
-| /sf run      | Execute specification                   |
-| /sf review   | Review implementation (fresh context)   |
-| /sf fix      | Fix implementation based on review      |
-| /sf done     | Finalize, commit, and archive           |
+| /sf:init     | Initialize project, analyze codebase    |
+| /sf:new      | Create specification from task          |
+| /sf:audit    | Audit specification (fresh context)     |
+| /sf:revise   | Revise spec based on audit feedback     |
+| /sf:run      | Execute specification                   |
+| /sf:review   | Review implementation (fresh context)   |
+| /sf:fix      | Fix implementation based on review      |
+| /sf:done     | Finalize, commit, and archive           |
 
 ## Navigation
 
 | Command      | Description                             |
 |--------------|-----------------------------------------|
-| /sf status   | Show current state and next step        |
-| /sf list     | List all specifications                 |
-| /sf show     | Show specification details              |
-| /sf next     | Work on highest priority task           |
+| /sf:status   | Show current state and next step        |
+| /sf:list     | List all specifications                 |
+| /sf:show     | Show specification details              |
+| /sf:next     | Work on highest priority task           |
 
 ## To-Do
 
 | Command      | Description                             |
 |--------------|-----------------------------------------|
-| /sf todo     | Add idea to backlog                     |
-| /sf todos    | List all to-do items                    |
-| /sf plan     | Convert to-do to specification          |
-| /sf priority | Change to-do priorities                 |
+| /sf:todo     | Add idea to backlog                     |
+| /sf:todos    | List all to-do items                    |
+| /sf:plan     | Convert to-do to specification          |
+| /sf:priority | Change to-do priorities                 |
 
 ## Decomposition
 
 | Command      | Description                             |
 |--------------|-----------------------------------------|
-| /sf split    | Split large spec into sub-specs         |
-| /sf deps     | Show dependency graph                   |
+| /sf:split    | Split large spec into sub-specs         |
+| /sf:deps     | Show dependency graph                   |
 
 ## Sessions
 
 | Command      | Description                             |
 |--------------|-----------------------------------------|
-| /sf pause    | Save session context for later          |
-| /sf resume   | Restore previous session context        |
+| /sf:pause    | Save session context for later          |
+| /sf:resume   | Restore previous session context        |
 
 ## Utilities
 
 | Command      | Description                             |
 |--------------|-----------------------------------------|
-| /sf help     | This help (or detailed: /sf help new)   |
-| /sf history  | View completed specifications           |
-| /sf metrics  | Project statistics and insights         |
+| /sf:help     | This help (or detailed: /sf:help new)   |
+| /sf:history  | View completed specifications           |
+| /sf:metrics  | Project statistics and insights         |
 
 ---
 
 ## Quick Start
 
-1. `/sf init` — Initialize project (once)
-2. `/sf new "task"` — Create specification
-3. `/sf audit` — Audit the spec
-4. `/sf run` — Implement
-5. `/sf review` — Review implementation
-6. `/sf done` — Complete and archive
+1. `/sf:init` — Initialize project (once)
+2. `/sf:new "task"` — Create specification
+3. `/sf:audit` — Audit the spec
+4. `/sf:run` — Implement
+5. `/sf:review` — Review implementation
+6. `/sf:done` — Complete and archive
 
 ## Typical Session
 
 ```
-/sf status        # Where am I?
-/sf next          # What should I work on?
-/sf audit         # Audit current spec
-/sf revise all    # Apply audit feedback
-/sf run           # Implement
-/sf review        # Review implementation
-/sf done          # Complete
+/sf:status        # Where am I?
+/sf:next          # What should I work on?
+/sf:audit         # Audit current spec
+/sf:revise all    # Apply audit feedback
+/sf:run           # Implement
+/sf:review        # Review implementation
+/sf:done          # Complete
 ```
 
 ---
 
-**Detailed help:** `/sf help <command>`
+**Detailed help:** `/sf:help <command>`
 
 **Documentation:** See DESIGN.md for full specification
 ```

package/commands/sf/history.md

@@ -33,7 +33,7 @@ Display completed specifications from the archive. Shows completion dates, audit
 ```
 SpecFlow not initialized.
 
-Run `/sf init` first.
+Run `/sf:init` first.
 ```
 Exit.
 
@@ -54,9 +54,9 @@ No completed specifications yet.
 Complete your first spec to see it here.
 
 **Workflow:**
-1. `/sf new "task"` — Create specification
-2. `/sf audit` → `/sf run` → `/sf review`
-3. `/sf done` — Archives the specification
+1. `/sf:new "task"` — Create specification
+2. `/sf:audit` → `/sf:run` → `/sf:review`
+3. `/sf:done` — Archives the specification
 ```
 Exit.
 
@@ -78,10 +78,10 @@ Exit.
 Specification {ID} not found in archive.
 
 It may be:
-- Still in progress: `/sf show {ID}`
-- Never existed: `/sf list` to see all specs
+- Still in progress: `/sf:show {ID}`
+- Never existed: `/sf:list` to see all specs
 
-Use `/sf history` to see archived specifications.
+Use `/sf:history` to see archived specifications.
 ```
 Exit.
 
@@ -241,7 +241,7 @@ Most recent first.
 
 ---
 
-**View details:** `/sf history SPEC-001`
+**View details:** `/sf:history SPEC-001`
 
 **Insights:**
 {If first-pass audit rate < 50%:}

package/commands/sf/init.md

@@ -30,7 +30,7 @@ Initialize SpecFlow in the current project. Analyzes the codebase to understand
 ```
 SpecFlow already initialized in this project.
 
-Use `/sf status` to see current state.
+Use `/sf:status` to see current state.
 ```
 Exit.
 
@@ -133,7 +133,7 @@ Create `.specflow/STATE.md`:
 
 - **Active Specification:** none
 - **Status:** idle
-- **Next Step:** /sf new
+- **Next Step:** /sf:new
 
 ## Queue
 
@@ -193,7 +193,7 @@ Create `.specflow/config.json`:
 
 ## Next Step
 
-`/sf new "your task description"` — create first specification
+`/sf:new "your task description"` — create first specification
 
 ---
 
@@ -213,5 +213,5 @@ Create `.specflow/config.json`:
 - [ ] PROJECT.md created with detected stack
 - [ ] STATE.md created with initial state
 - [ ] config.json created with defaults
-- [ ] User knows next step is /sf new
+- [ ] User knows next step is /sf:new
 </success_criteria>

package/commands/sf/list.md

@@ -27,7 +27,7 @@ Display all specifications from `.specflow/specs/` with their basic info: ID, ti
 ```
 SpecFlow not initialized.
 
-Run `/sf init` to start.
+Run `/sf:init` to start.
 ```
 Exit.
 
@@ -50,7 +50,7 @@ ls -1 .specflow/specs/SPEC-*.md 2>/dev/null
 No specifications found.
 
 Create your first specification:
-`/sf new "task description"`
+`/sf:new "task description"`
 ```
 Exit.
 
@@ -95,9 +95,9 @@ Total: 3 specs | {archived} complete | {in_progress} in progress
 ---
 
 **Actions:**
-- `/sf show SPEC-XXX` — view details
-- `/sf next` — work on highest priority
-- `/sf new "task"` — create new specification
+- `/sf:show SPEC-XXX` — view details
+- `/sf:next` — work on highest priority
+- `/sf:new "task"` — create new specification
 ```
 
 ## Step 8: Show Status Legend (if helpful)

package/commands/sf/metrics.md

@@ -32,7 +32,7 @@ Calculate and display project statistics including completion rates, quality met
 ```
 SpecFlow not initialized.
 
-Run `/sf init` first.
+Run `/sf:init` first.
 ```
 Exit.
 
@@ -147,7 +147,7 @@ Based on calculated metrics, generate 2-4 actionable insights:
 - "Specs may benefit from better scoping upfront"
 
 **If large specs > 20% of total:**
-- "Consider splitting large specs earlier (/sf split)"
+- "Consider splitting large specs earlier (/sf:split)"
 
 **If first-pass review rate > 70%:**
 - "Good implementation quality — specs are well-defined"
@@ -156,7 +156,7 @@ Based on calculated metrics, generate 2-4 actionable insights:
 - "Many specs in progress — consider completing before starting new"
 
 **If TODO_COUNT > 5 and conversion rate < 30%:**
-- "Backlog growing — consider /sf priority or /sf plan"
+- "Backlog growing — consider /sf:priority or /sf:plan"
 
 **If all metrics good:**
 - "Project health is excellent — keep up the discipline!"
@@ -250,7 +250,7 @@ Based on calculated metrics, generate 2-4 actionable insights:
 {If no todos:}
 No to-do items.
 
-Add ideas: `/sf todo "idea"`
+Add ideas: `/sf:todo "idea"`
 
 ---
 
@@ -287,7 +287,7 @@ No specifications created yet.
 
 Create your first specification to start tracking metrics:
 
-`/sf new "task description"`
+`/sf:new "task description"`
 
 ---