specflow-cc 1.14.2 → 1.15.0

package/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.15.0] - 2026-03-11
+
+### Fixed
+
+- **TODO lifecycle cleanup** — TODOs now reliably removed when converted to specs via `/sf:plan` and completed via `/sf:done`
+  - `spec-creator` agent writes `source: TODO-XXX` in spec frontmatter when created from a todo
+  - `/sf:plan` Step 7 marked as CRITICAL with mandatory verification (re-reads TODO.md after removal)
+  - `/sf:done` adds Step 7.5 safety net: checks spec `source:` field and cleans up any remaining TODO
+  - Spec template updated with optional `source:` frontmatter field
+
 ## [1.14.1] - 2026-03-05
 
 ### Added

package/agents/spec-creator.md

@@ -139,7 +139,7 @@ If no specs exist in either directory, start with SPEC-001.
 
 Write to `.specflow/specs/SPEC-XXX.md` using the template structure:
 
-1. **Frontmatter:** id, type, status (draft), priority, complexity, created
+1. **Frontmatter:** id, type, status (draft), priority, complexity, created, source (if `<todo_context>` provided — set to the TODO ID, e.g., `source: TODO-006`)
 2. **Title:** Clear, action-oriented
 3. **Context:** Why this is needed
    - **If `<prior_discussion>` provided:** Add "Prior Discussion" subsection linking to PRE-XXX or DISC-XXX with key decisions

package/commands/sf/done.md

@@ -219,6 +219,20 @@ If significant decisions found, add to STATE.md Decisions table:
 | {date} | SPEC-XXX | {decision description} |
 ```
 
+## Step 7.5: Clean Up Source TODO (safety net)
+
+Check if the spec frontmatter contains a `source:` field (e.g., `source: TODO-006`).
+
+**If `source:` field exists:**
+
+1. Read `.specflow/todos/TODO.md`
+2. Check if the referenced TODO-XXX entry still exists in the file
+3. **If it exists** — remove it (the entire block from `## TODO-XXX` heading through the next `---` separator, inclusive)
+4. Update `*Last updated:` timestamp with note: `TODO-XXX cleaned up (completed via SPEC-YYY)`
+5. Write the updated TODO.md
+
+**If no `source:` field or TODO already removed:** Skip — no action needed.
+
 ## Step 8: Archive Specification
 
 Move spec to archive:
@@ -364,6 +378,7 @@ git commit -m "docs(sf): complete SPEC-XXX"
 - [ ] Spec status updated to "done"
 - [ ] Completion section added
 - [ ] Decisions extracted (if any)
+- [ ] Source TODO cleaned up (if `source:` field exists in spec)
 - [ ] Spec moved to archive
 - [ ] STATE.md updated (cleared active, removed from queue)
 - [ ] Final commit created

package/commands/sf/plan.md

@@ -147,11 +147,15 @@ Use the priority from the todo as the spec's initial priority.
 ", subagent_type="sf-spec-creator", model="{profile_model}", description="Create specification from todo")
 ```
 
-## Step 7: Remove Todo from List
+## Step 7: Remove Todo from List — CRITICAL
 
-After spec is successfully created, remove the todo entry from TODO.md.
+**This step is MANDATORY. Do NOT skip it after the agent returns.**
 
-Update `*Last updated:` timestamp.
+1. Read `.specflow/todos/TODO.md`
+2. Remove the entire todo block (from `## TODO-XXX` heading through the next `---` separator, inclusive)
+3. Update `*Last updated:` timestamp with note: `TODO-XXX converted to SPEC-YYY`
+4. Write the updated TODO.md
+5. **Verify** by reading TODO.md again — the converted todo MUST NOT appear
 
 **Important:** Only remove after confirmed spec creation.
 

package/package.json

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

package/templates/spec.md

@@ -5,6 +5,7 @@ status: draft | auditing | revision_requested | audited | running | review | don
 priority: high | medium | low
 complexity: small | medium | large
 created: YYYY-MM-DD
+source: TODO-XXX (optional — set when spec is created from a todo via /sf:plan)
 ---
 
 # [Task Title]