specflow-cc 1.7.0 → 1.7.2

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to SpecFlow will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.7.2] - 2026-01-30
+
+### Changed
+
+- Standardized output format across all commands:
+  - Unified bullet points to `•` for options
+  - Unified "Next Step" section naming (singular)
+  - Unified file reference format with 📄 emoji
+  - Replaced `<sub>` tags with "Tip:" and "Note:" prefixes
+
+---
+
+## [1.7.1] - 2026-01-30
+
+### Fixed
+
+- `/sf:audit` now shows `/sf:revise` option when recommendations exist (previously only showed `/sf:run`)
+
+---
+
 ## [1.7.0] - 2026-01-28
 
 ### Added

package/agents/spec-auditor.md

@@ -541,7 +541,8 @@ N+1. [recommendation]
 ## Step 8: Update STATE.md
 
 Update status:
-- If APPROVED: Status → "audited", Next Step → "/sf:run"
+- If APPROVED (no recommendations): Status → "audited", Next Step → "/sf:run"
+- If APPROVED (with recommendations): Status → "audited", Next Step → "/sf:run or /sf:revise"
 - If NEEDS_DECOMPOSITION: Status → "needs_decomposition", Next Step → "/sf:split or /sf:run --parallel"
 - If NEEDS_REVISION: Status → "revision_requested", Next Step → "/sf:revise"
 
@@ -609,7 +610,7 @@ Choose one:
 
 ---
 
-{If APPROVED:}
+{If APPROVED without recommendations:}
 
 ### Summary
 
@@ -618,6 +619,25 @@ Choose one:
 ### Next Step
 
 `/sf:run` — implement specification
+
+---
+
+{If APPROVED with recommendations:}
+
+### Summary
+
+[Brief comment on spec quality]
+
+### Recommendations (Optional)
+
+N. [recommendation]
+N+1. [recommendation]
+
+### Next Steps
+
+Choose one:
+- `/sf:run` — implement specification as-is
+- `/sf:revise` — apply optional recommendations first ({N} items)
 ```
 
 </output>

package/commands/sf/audit.md

@@ -184,7 +184,7 @@ Options:
 • `/sf:revise 1,2,5` — apply specific items
 • `/sf:discuss SPEC-XXX` — discuss items before deciding
 
-<sub>External feedback should be critically evaluated, not blindly applied.</sub>
+Note: External feedback should be critically evaluated, not blindly applied.
 ```
 
 Exit.
@@ -357,7 +357,7 @@ fi
 
 ---
 
-## Next Steps
+## Next Step
 
 Choose one:
 • `/sf:run` — implement specification as-is
@@ -394,11 +394,9 @@ Choose one:
 `/sf:revise` — address critical issues
 
 Options:
-- `/sf:revise all` — apply all feedback
-- `/sf:revise 1,2` — fix specific issues
-- `/sf:revise [instructions]` — custom changes
-
-<sub>Optional: `/sf:discuss SPEC-XXX` — clarify requirements before revising</sub>
+• `/sf:revise all` — apply all feedback
+• `/sf:revise 1,2` — fix specific issues
+• `/sf:revise [instructions]` — custom changes
 ```
 
 </workflow>

package/commands/sf/done.md

@@ -337,30 +337,27 @@ git commit -m "docs(sf): complete SPEC-XXX
 - **Audit cycles:** {count}
 - **Review cycles:** {count}
 
-### Archived To
-
-`.specflow/archive/SPEC-XXX.md`
-
 {If decisions extracted:}
 ### Decisions Recorded
 
-- {decision 1}
-- {decision 2}
+• {decision 1}
+• {decision 2}
 
 ---
 
-## Queue Status
+📄 File: .specflow/archive/SPEC-XXX.md
 
-{If queue has more specs:}
-**Next in queue:** SPEC-YYY — {title}
+---
 
-Run `/sf:next` to start the next specification.
+## Next Step
 
-{If queue is empty:}
-Queue is empty.
+{If queue has more specs:}
+`/sf:next` — start next specification (SPEC-YYY)
 
-Run `/sf:new "task"` to create a new specification
-or `/sf:todos` to see pending ideas.
+{If queue is empty:}
+Choose one:
+• `/sf:new "task"` — create new specification
+• `/sf:todos` — see pending ideas
 ```
 
 </workflow>

package/commands/sf/fix.md

@@ -199,7 +199,7 @@ Append to Review History:
 
 `/sf:review` — re-review to verify fixes
 
-<sub>/clear recommended → reviewer needs fresh context</sub>
+Tip: `/clear` recommended — reviewer needs fresh context
 ```
 
 </workflow>

package/commands/sf/new.md

@@ -141,11 +141,11 @@ The agent will:
 
 ### Assumptions Made
 
-- [List assumptions agent made]
+• [List assumptions agent made]
 
 ---
 
-📄 **File:** `.specflow/specs/SPEC-XXX.md`
+📄 File: .specflow/specs/SPEC-XXX.md
 
 ---
 
@@ -153,9 +153,7 @@ The agent will:
 
 `/sf:audit` — audit specification before implementation
 
-<sub>/clear recommended → auditor needs fresh context</sub>
-
-<sub>Optional: `/sf:discuss SPEC-XXX` — clarify assumptions before audit</sub>
+Tip: `/clear` recommended — auditor needs fresh context
 
 {If complexity is large:}
 

package/commands/sf/review.md

@@ -260,7 +260,7 @@ fi
 
 ---
 
-## Next Steps
+## Next Step
 
 Choose one:
 • `/sf:done` — finalize and archive as-is
@@ -309,9 +309,9 @@ Choose one:
 `/sf:fix` — address the issues
 
 Options:
-- `/sf:fix all` — apply all fixes
-- `/sf:fix 1,2` — fix specific issues
-- `/sf:fix [instructions]` — custom fixes
+• `/sf:fix all` — apply all fixes
+• `/sf:fix 1,2` — fix specific issues
+• `/sf:fix [instructions]` — custom fixes
 ```
 
 </workflow>

package/commands/sf/revise.md

@@ -360,7 +360,7 @@ The agent will:
 
 `/sf:audit` — re-audit revised specification
 
-<sub>/clear recommended → auditor needs fresh context</sub>
+Tip: `/clear` recommended — auditor needs fresh context
 ```
 
 **For external audit:**
@@ -395,7 +395,7 @@ Items {N, M} require clarification before deciding.
 
 ---
 
-## Next Steps
+## Next Step
 
 {If items need discussion:}
 `/sf:discuss SPEC-XXX` — clarify items {N, M}
@@ -404,7 +404,7 @@ Items {N, M} require clarification before deciding.
 `/sf:audit` — re-audit with applied changes
 
 {If deferred items exist:}
-<sub>Deferred items saved to `.specflow/todos/` for future consideration.</sub>
+Note: Deferred items saved to `.specflow/todos/` for future consideration.
 ```
 
 </workflow>

package/commands/sf/run.md

@@ -352,7 +352,7 @@ fi
 
 `/sf:review` — audit the implementation
 
-<sub>/clear recommended → reviewer needs fresh context</sub>
+Tip: `/clear` recommended — reviewer needs fresh context
 ```
 
 </workflow>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specflow-cc",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "description": "Spec-driven development system for Claude Code — quality-first workflow with explicit audit cycles",
   "bin": {
     "specflow-cc": "bin/install.js"