specflow-cc 1.1.0 → 1.3.0

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
 
@@ -191,9 +191,15 @@ Append to Review History:
 
 ---
 
+📄 File: .specflow/specs/SPEC-XXX.md
+
+---
+
 ## Next Step
 
-`/sf review` — re-review to verify fixes
+`/sf:review` — re-review to verify fixes
+
+<sub>/clear recommended → reviewer needs fresh context</sub>
 ```
 
 </workflow>
@@ -256,7 +262,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"`
 
 ---
 

package/commands/sf/new.md

@@ -34,7 +34,7 @@ Create a new specification from a task description. Asks critical questions if n
 ```
 SpecFlow not initialized.
 
-Run `/sf init` first.
+Run `/sf:init` first.
 ```
 Exit.
 
@@ -94,22 +94,24 @@ The agent will:
 
 - [List assumptions agent made]
 
-### File
+---
 
-`.specflow/specs/SPEC-XXX.md`
+📄 **File:** `.specflow/specs/SPEC-XXX.md`
 
 ---
 
 ## Next Step
 
-`/sf audit` — audit specification before implementation
+`/sf:audit` — audit specification before implementation
+
+<sub>/clear recommended → auditor needs fresh context</sub>
 
 {If complexity is large:}
 
 ### Warning
 
 Specification is large (>150k tokens estimated).
-Consider `/sf split SPEC-XXX` to decompose into smaller specs.
+Consider `/sf:split SPEC-XXX` to decompose into smaller specs.
 ```
 
 </workflow>
@@ -153,7 +155,7 @@ Create `.specflow/specs/SPEC-XXX.md` with:
 
 - **Active Specification:** SPEC-XXX
 - **Status:** drafting
-- **Next Step:** /sf audit
+- **Next Step:** /sf:audit
 ```
 
 Add to Queue table.
@@ -167,5 +169,5 @@ Add to Queue table.
 - [ ] Complexity estimated (small/medium/large)
 - [ ] Assumptions documented
 - [ ] STATE.md updated with new spec
-- [ ] User knows next step is /sf audit
+- [ ] User knows next step is /sf:audit
 </success_criteria>

package/commands/sf/next.md

@@ -28,7 +28,7 @@ Find the highest priority specification that needs action, set it as active in S
 ```
 SpecFlow not initialized.
 
-Run `/sf init` to start.
+Run `/sf:init` to start.
 ```
 Exit.
 
@@ -47,8 +47,8 @@ ls -1 .specflow/specs/SPEC-*.md 2>/dev/null
 No specifications ready for work.
 
 **Options:**
-- `/sf new "description"` — create new specification
-- `/sf todos` — view idea backlog
+- `/sf:new "description"` — create new specification
+- `/sf:todos` — view idea backlog
 ```
 Exit.
 
@@ -91,9 +91,9 @@ Choose spec with highest score.
 All specifications are either completed or blocked.
 
 **Options:**
-- `/sf new "description"` — create new specification
-- `/sf todos` — view idea backlog
-- `/sf list` — see all specifications
+- `/sf:new "description"` — create new specification
+- `/sf:todos` — view idea backlog
+- `/sf:list` — see all specifications
 ```
 Exit.
 
@@ -108,12 +108,12 @@ Update `.specflow/STATE.md`:
 
 | Status | Recommended Command | Description |
 |--------|---------------------|-------------|
-| draft | `/sf audit` | Audit specification |
+| draft | `/sf:audit` | Audit specification |
 | auditing | Continue audit | Complete the audit |
-| revision_requested | `/sf revise` | Address audit comments |
-| audited | `/sf run` | Implement specification |
-| running | Continue or `/sf review` | Complete implementation |
-| review | `/sf fix` or `/sf done` | Address review or finalize |
+| revision_requested | `/sf:revise` | Address audit comments |
+| audited | `/sf:run` | Implement specification |
+| running | Continue or `/sf:review` | Complete implementation |
+| review | `/sf:fix` or `/sf:done` | Address review or finalize |
 
 ## Step 7: Display Next Task
 
@@ -156,7 +156,7 @@ From {audit/review} v{N}:
 
 **If status is revision_requested:**
 ```
-**Tip:** Review audit comments with `/sf show {ID}` before revising.
+**Tip:** Review audit comments with `/sf:show {ID}` before revising.
 ```
 
 **If status is review:**
@@ -166,7 +166,7 @@ From {audit/review} v{N}:
 
 **If complexity is large:**
 ```
-**Tip:** Consider `/sf split {ID}` to break into smaller specs.
+**Tip:** Consider `/sf:split {ID}` to break into smaller specs.
 ```
 
 </workflow>

package/commands/sf/pause.md

@@ -29,7 +29,7 @@ Save the current work context to enable seamless resumption later. Creates a pau
 ```
 SpecFlow not initialized.
 
-Run `/sf init` to start.
+Run `/sf:init` to start.
 ```
 Exit.
 
@@ -192,7 +192,7 @@ Under Current Position, add:
 
 **Session saved successfully.**
 
-Resume with: `/sf resume`
+Resume with: `/sf:resume`
 ```
 
 </workflow>

package/commands/sf/plan.md

@@ -23,7 +23,7 @@ Convert a to-do item from the backlog into a full specification. Reuses the spec
 </context>
 
 <arguments>
-- `[ID or #]` — Optional. Either TODO-XXX ID or list number from `/sf todos`. If omitted, shows todos and prompts for selection.
+- `[ID or #]` — Optional. Either TODO-XXX ID or list number from `/sf:todos`. If omitted, shows todos and prompts for selection.
 </arguments>
 
 <workflow>
@@ -38,7 +38,7 @@ Convert a to-do item from the backlog into a full specification. Reuses the spec
 ```
 SpecFlow not initialized.
 
-Run `/sf init` to start.
+Run `/sf:init` to start.
 ```
 Exit.
 
@@ -52,7 +52,7 @@ Exit.
 ```
 No to-do items found.
 
-Add ideas first with `/sf todo "your idea"`.
+Add ideas first with `/sf:todo "your idea"`.
 ```
 Exit.
 
@@ -95,7 +95,7 @@ Read the selected todo:
 ```
 Todo "{arg}" not found.
 
-Use `/sf todos` to see available items.
+Use `/sf:todos` to see available items.
 ```
 Exit.
 
@@ -161,14 +161,14 @@ Update `*Last updated:` timestamp.
 
 ## Next Step
 
-`/sf audit` — audit specification before implementation
+`/sf:audit` — audit specification before implementation
 
 {If complexity is large:}
 
 ### Warning
 
 Specification is large (>150k tokens estimated).
-Consider `/sf split SPEC-{YYY}` to decompose.
+Consider `/sf:split SPEC-{YYY}` to decompose.
 ```
 
 </workflow>
@@ -183,9 +183,9 @@ Consider `/sf split SPEC-{YYY}` to decompose.
 
 Read from TODO.md.
 
-### Create Spec (same as /sf new)
+### Create Spec (same as /sf:new)
 
-Use `/sf new "{todo description}"` logic:
+Use `/sf:new "{todo description}"` logic:
 1. Generate SPEC-XXX ID
 2. Create spec with todo context
 3. Set priority from todo

package/commands/sf/priority.md

@@ -30,7 +30,7 @@ Interactively prioritize specifications and to-do items. Allows reordering, sett
 ```
 SpecFlow not initialized.
 
-Run `/sf init` to start.
+Run `/sf:init` to start.
 ```
 Exit.
 
@@ -179,7 +179,7 @@ After changes:
 
 ---
 
-Use `/sf next` to work on highest priority task.
+Use `/sf:next` to work on highest priority task.
 ```
 
 </workflow>