specflow-cc 1.0.0

package/commands/sf/fix.md

@@ -0,0 +1,272 @@
+---
+name: sf:fix
+description: Fix implementation based on review feedback
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+---
+
+<purpose>
+Fix the implementation based on review feedback. Can apply all fixes, specific numbered items, or custom fixes described by user. Creates atomic commits for each fix.
+</purpose>
+
+<context>
+@.specflow/STATE.md
+@.specflow/PROJECT.md
+@~/.claude/specflow-cc/agents/spec-executor.md
+</context>
+
+<workflow>
+
+## Step 1: Verify Initialization
+
+```bash
+[ -d .specflow ] && echo "OK" || echo "NOT_INITIALIZED"
+```
+
+**If NOT_INITIALIZED:**
+```
+SpecFlow not initialized.
+
+Run `/sf init` first.
+```
+Exit.
+
+## Step 2: Get Active Specification
+
+Read `.specflow/STATE.md` and extract Active Specification.
+
+**If no active specification:**
+```
+No active specification to fix.
+
+Run `/sf new "task description"` to create one.
+```
+Exit.
+
+## Step 3: Load Specification
+
+Read the active spec file: `.specflow/specs/SPEC-XXX.md`
+
+**If status is not 'review':**
+```
+Specification SPEC-XXX is not in review status (status: {status}).
+
+{If not yet run:}
+Run `/sf run` first to implement the specification.
+
+{If already done:}
+Specification already completed.
+```
+Exit.
+
+## Step 4: Extract Latest Review
+
+Find the most recent "Review v[N]" section in Review History.
+
+**If no review exists:**
+```
+Specification SPEC-XXX has no review history.
+
+Run `/sf review` first to get feedback.
+```
+Exit.
+
+## Step 5: Parse Arguments
+
+| Argument | Action |
+|----------|--------|
+| (none) | Interactive mode — show issues, ask what to fix |
+| "all" | Apply all critical AND major AND minor fixes |
+| "1,2,3" | Apply only numbered items |
+| "..." | Treat as custom fix instructions |
+
+### If Interactive Mode (no arguments):
+
+Display review findings:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ FIX: SPEC-XXX
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Last review (v{N}) found:
+
+**Critical:**
+1. {Issue} — `path/file.ts:line`
+
+**Major:**
+2. {Issue} — `path/file.ts:line`
+
+**Minor:**
+3. {Issue}
+
+---
+
+What to fix?
+```
+
+Use AskUserQuestion with options:
+- "Fix all issues" → treat as "all"
+- "Fix critical and major only (1, 2)" → treat as "1,2"
+- "Custom selection" → ask for numbers or description
+
+## Step 6: Apply Fixes
+
+For each issue to fix:
+
+### 6.1 Locate
+
+Find the file and location mentioned.
+
+### 6.2 Fix
+
+Apply the fix following:
+- The reviewer's suggestion
+- Project patterns from PROJECT.md
+- Specification requirements
+
+### 6.3 Commit
+
+Create atomic commit:
+
+```bash
+git add <files>
+git commit -m "fix(sf-XXX): {brief description}
+
+- Fixed: {issue description}
+"
+```
+
+## Step 7: Record Fix Response
+
+Append to Review History:
+
+```markdown
+### Fix Response v[N] ([date] [time])
+**Applied:** {scope description}
+
+**Fixes:**
+1. [✓/✗] {Issue} — {what was done}
+   - Commit: {hash}
+2. [✓/✗] {Issue} — {what was done}
+   - Commit: {hash}
+
+{If any skipped:}
+**Skipped:** {reason}
+```
+
+## Step 8: Update STATE.md
+
+- Status → "review" (ready for re-review)
+- Next Step → "/sf review"
+
+## Step 9: Display Result
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ FIXES APPLIED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Specification:** SPEC-XXX
+**Review:** v{N} → Fix Response v{N}
+
+### Fixes Applied
+
+1. [✓] {Issue} — {what was done}
+   - Commit: {hash}
+2. [✓] {Issue} — {what was done}
+   - Commit: {hash}
+
+{If any skipped:}
+### Skipped
+
+3. [✗] {Issue} — {reason}
+
+---
+
+## Next Step
+
+`/sf review` — re-review to verify fixes
+```
+
+</workflow>
+
+<fallback>
+
+**If complex fixes needed**, spawn executor agent in fix mode:
+
+```
+Task(prompt="
+<specification>
+@.specflow/specs/SPEC-XXX.md
+</specification>
+
+<project_context>
+@.specflow/PROJECT.md
+</project_context>
+
+<fix_scope>
+{Parsed scope: "all", "1,2", or custom instructions}
+</fix_scope>
+
+<review_findings>
+{Latest review findings from spec}
+</review_findings>
+
+Fix the implementation issues identified in the review.
+Create atomic commits for each fix.
+Record Fix Response in Review History.
+", subagent_type="sf-spec-executor", description="Fix implementation")
+```
+
+## Inline Fix (for simple fixes)
+
+### Locate Issues
+
+Parse review findings with file paths and line numbers.
+
+### Apply Each Fix
+
+1. Read the file
+2. Make the correction
+3. Verify fix works
+4. Commit:
+```bash
+git add <file>
+git commit -m "fix(sf-XXX): {description}"
+```
+
+### Record Response
+
+Get fix response version:
+```bash
+FIX_COUNT=$(grep -c "### Fix Response v" .specflow/specs/SPEC-XXX.md 2>/dev/null || echo 0)
+NEXT_VERSION=$((FIX_COUNT + 1))
+```
+
+Append to Review History.
+
+### Update STATE.md
+
+- Status → "review"
+- Next Step → "/sf review"
+
+</fallback>
+
+<success_criteria>
+- [ ] Active specification identified
+- [ ] Latest review parsed
+- [ ] Fix scope determined (all/specific/custom)
+- [ ] All requested fixes applied
+- [ ] Atomic commits created for each fix
+- [ ] Fix Response recorded in Review History
+- [ ] STATE.md updated
+- [ ] Clear summary of fixes shown
+</success_criteria>

package/commands/sf/help.md

@@ -0,0 +1,263 @@
+---
+name: sf:help
+description: Show SpecFlow help and command reference
+allowed-tools:
+  - Read
+  - Glob
+---
+
+<purpose>
+Display comprehensive help for SpecFlow commands. Without arguments, shows an overview of all commands grouped by category. With a command name, shows detailed help including examples and related commands.
+</purpose>
+
+<context>
+@~/.claude/specflow-cc/commands/sf/*.md
+</context>
+
+<arguments>
+- `[command]` — Command name to get detailed help for (e.g., `new`, `audit`). Optional — shows overview if omitted.
+</arguments>
+
+<workflow>
+
+## Step 1: Check for Arguments
+
+**If command argument provided:** Go to Step 2a (Detailed Help)
+**If no arguments:** Go to Step 2b (Overview)
+
+## Step 2a: Detailed Command Help
+
+### Validate Command
+
+Check if command exists:
+```bash
+[ -f ~/.claude/specflow-cc/commands/sf/{command}.md ] && echo "FOUND" || echo "NOT_FOUND"
+```
+
+**If NOT_FOUND:**
+```
+Unknown command: {command}
+
+Run `/sf help` for available commands.
+```
+Exit.
+
+### Display Detailed Help
+
+Read the command file and extract:
+- Name and description from frontmatter
+- Purpose from `<purpose>` section
+- Arguments from `<arguments>` section
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ /sf {command}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+{Description from frontmatter}
+
+## Usage
+
+```
+/sf {command} {arguments syntax}
+```
+
+## Description
+
+{Purpose section content, summarized}
+
+## Arguments
+
+{Arguments section content}
+
+## Examples
+
+{Generate contextual examples based on command}
+
+## Related Commands
+
+{List 2-4 related commands with brief descriptions}
+
+## See Also
+
+- DESIGN.md section {relevant section}
+```
+
+### Command-Specific Examples
+
+**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
+```
+```
+
+**For `/sf audit`:**
+```
+## Examples
+
+```
+/sf audit                  # Audit active specification
+/sf audit SPEC-003         # Audit specific specification
+```
+```
+
+**For `/sf run`:**
+```
+## Examples
+
+```
+/sf run                    # Run active specification
+/sf run SPEC-003           # Run specific specification
+```
+```
+
+**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"
+```
+```
+
+**For `/sf split`:**
+```
+## Examples
+
+```
+/sf split                  # Split active specification
+/sf split SPEC-001         # Split specific specification
+```
+```
+
+**For `/sf todo`:**
+```
+## Examples
+
+```
+/sf todo "Add caching layer for API"
+/sf todo "Research WebSocket alternatives"
+/sf todo "Refactor authentication flow"
+```
+```
+
+Exit.
+
+## Step 2b: Overview Help
+
+Display full command reference:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ SPECFLOW HELP
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**SpecFlow** — Spec-driven development for Claude Code
+
+Workflow: Spec → Audit → Revise → Run → Review → Fix → Done
+
+---
+
+## Core Workflow
+
+| 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           |
+
+## 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           |
+
+## 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                 |
+
+## Decomposition
+
+| Command      | Description                             |
+|--------------|-----------------------------------------|
+| /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        |
+
+## Utilities
+
+| Command      | Description                             |
+|--------------|-----------------------------------------|
+| /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
+
+## 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
+```
+
+---
+
+**Detailed help:** `/sf help <command>`
+
+**Documentation:** See DESIGN.md for full specification
+```
+
+</workflow>
+
+<success_criteria>
+- [ ] Command argument parsed correctly
+- [ ] Unknown commands handled gracefully
+- [ ] Detailed help shows usage, examples, related commands
+- [ ] Overview shows all commands grouped by category
+- [ ] Quick start guide included
+- [ ] Typical session example provided
+- [ ] Clear formatting with tables
+</success_criteria>