flow-cc 0.6.0 → 0.7.0

package/skills/flow-spec.md

@@ -28,7 +28,7 @@ You are executing the `/flow:spec` skill. This is the KEYSTONE skill of the flow
 
    2. **If no argument** — read ROADMAP.md and list all incomplete milestones. Use AskUserQuestion to let the user pick which milestone to spec. Pre-select the next unspecced milestone as the first option. Always show the picker, even if only one milestone is listed — the user may want to confirm or choose "Other" to define a new milestone first.
 
-   3. **Derive the PRD slug:** Take the milestone's version prefix and name (e.g., "v3: Dashboard Analytics"), lowercase it, replace spaces and special characters with hyphens, collapse consecutive hyphens. Result: `v3-dashboard-analytics`. The PRD path is `.planning/prds/{slug}.md`.
+   3. **Derive the PRD slug:** Take the milestone name (e.g., "Dashboard Analytics"), lowercase it, replace spaces and special characters with hyphens, collapse consecutive hyphens. Result: `dashboard-analytics`. The PRD path is `.planning/prds/{slug}.md`.
 
    4. **Check for existing PRD at that path:**
       - **If PRD exists** → Use AskUserQuestion: "A PRD already exists for this milestone at `.planning/prds/{slug}.md`. What would you like to do?"
@@ -171,9 +171,9 @@ Write the PRD to `.planning/prds/{slug}.md` (create `.planning/prds/` directory
 ```markdown
 # [Milestone Name] — Specification
 
-**Milestone:** [full milestone name, e.g., "v3: Dashboard Analytics"]
+**Milestone:** [full milestone name, e.g., "Dashboard Analytics"]
 **Status:** Ready for execution
-**Branch:** feat/[milestone-slug]
+**Branch:** feat/{milestone-slug}
 **Created:** [today's date]
 **Assigned To:** [developer name or "unassigned"]
 

package/skills/flow-status.md

@@ -57,7 +57,7 @@ Use this explicit decision tree:
 
 **IF all phases are complete AND no next milestone exists:**
 → Primary: `/flow:done` to finalize this milestone
-→ Then: `/flow:milestone` to add the next milestone
+→ Then: `/flow:triage` to add the next milestone
 → Alt: `/flow:task` for quick fixes or cleanup (no PRD needed)
 
 **IF no phases exist in ROADMAP (milestone defined but not planned):**

package/skills/flow-triage.md

@@ -32,6 +32,7 @@ For each distinct item in the brain dump, classify into one of:
 - **Linear Issue** — actionable task, bug, or feature → will become a Linear issue
 - **ROADMAP Entry** — future milestone or phase idea → append to ROADMAP.md Future section
 - **Lesson** — learning, pattern, or rule → append to tasks/lessons.md
+- **Milestone** — milestone-sized work item → add to ROADMAP.md as a planned milestone
 - **Discard** — not actionable, already done, duplicate, or too vague to action
 
 ## Step 4 — Present Plan
@@ -45,6 +46,7 @@ Show the full categorization in a table:
 | 2 | "Never use git add ." | Lesson | "Always stage specific files" |
 | 3 | "Maybe add dark mode" | ROADMAP | Future/Unscheduled |
 | 4 | "Had a thought about..." | Discard | Too vague to action |
+| 5 | "Student leasing rate modeling" | Milestone | Add to ROADMAP as planned milestone |
 ```
 
 Use AskUserQuestion: "Here's how I'd categorize your brain dump. Review and approve, or tell me what to change."
@@ -71,6 +73,14 @@ For approved items:
 - If that section doesn't exist, create it at the bottom of the file
 - Format: `| [name] | Unscheduled | — |`
 
+**Milestones:**
+- Add to `.planning/ROADMAP.md` main milestone table with status "Planned"
+- Add a section with the milestone goal: `## [Milestone Name]\n\n**Goal:** [goal]\n\n**Phases:** Run /flow:spec when this milestone is active.`
+- If no active milestone exists (all existing milestones are "Complete" or none exist):
+  - Set the first new milestone's status to "Pending — needs `/flow:spec`"
+  - Update STATE.md to point to the new milestone as current
+- Optionally create a Linear project (if Linear MCP tools available via `mcp__linear__list_teams`)
+
 **Lessons:**
 - Append to `tasks/lessons.md` as one-liners: `- **[topic]** The rule`
 - Enforce max 10 cap (promote most battle-tested to `CLAUDE.md ## Learned Rules` if full)
@@ -86,6 +96,7 @@ Print a compact completion block:
 Triage complete:
 - [N] Linear issues created (in [project names])
 - [N] ROADMAP entries added
+- [N] milestones added to ROADMAP
 - [N] lessons captured
 - [N] items discarded
 ```

package/templates/ROADMAP.md.template

@@ -1,18 +1,18 @@
-# {{PROJECT_NAME}} — Roadmap
-
-## Milestones
-
-| Version | Milestone | Status | Phases |
-|---------|-----------|--------|--------|
-| v1 | {{FIRST_MILESTONE}} | Pending — needs `/flow:spec` | TBD |
-{{ADDITIONAL_MILESTONES_TABLE}}
-
----
-
-## v1: {{FIRST_MILESTONE}}
-
-**Goal:** {{MILESTONE_GOAL}}
-
-**Phases:** Run `/flow:spec` to define implementation phases.
-
-{{ADDITIONAL_MILESTONES_SECTIONS}}
+# {{PROJECT_NAME}} — Roadmap
+
+## Milestones
+
+| Milestone | Status | Phases |
+|-----------|--------|--------|
+| {{FIRST_MILESTONE}} | Pending — needs `/flow:spec` | TBD |
+{{ADDITIONAL_MILESTONES_TABLE}}
+
+---
+
+## {{FIRST_MILESTONE}}
+
+**Goal:** {{MILESTONE_GOAL}}
+
+**Phases:** Run `/flow:spec` to define implementation phases.
+
+{{ADDITIONAL_MILESTONES_SECTIONS}}

package/templates/STATE.md.template

@@ -1,24 +1,24 @@
-# {{PROJECT_NAME}} — Project State
-
-## Current Position
-- **Milestone:** {{FIRST_MILESTONE}} (v1)
-- **Phase:** Not started — run `/flow:spec` to build PRD
-- **Branch:** main
-- **Active PRD:** None — run `/flow:spec` to create
-- **Last Session:** {{DATE}}
-
-## Milestone Progress
-
-| Phase | Name | Status |
-|-------|------|--------|
-| — | Run `/flow:spec` to define phases | — |
-
-## What Was Built (This Session)
-- Project initialized with `/flow:setup`
-- Created: CLAUDE.md, STATE.md, ROADMAP.md, tasks/lessons.md
-
-## Key Decisions
-- (none yet)
-
-## Next Actions
-1. Run `/flow:spec` to interview and generate PRD for {{FIRST_MILESTONE}}
+# {{PROJECT_NAME}} — Project State
+
+## Current Position
+- **Milestone:** {{FIRST_MILESTONE}}
+- **Phase:** Not started — run `/flow:spec` to build PRD
+- **Branch:** main
+- **Active PRD:** None — run `/flow:spec` to create
+- **Last Session:** {{DATE}}
+
+## Milestone Progress
+
+| Phase | Name | Status |
+|-------|------|--------|
+| — | Run `/flow:spec` to define phases | — |
+
+## What Was Built (This Session)
+- Project initialized with `/flow:setup`
+- Created: CLAUDE.md, STATE.md, ROADMAP.md, tasks/lessons.md
+
+## Key Decisions
+- (none yet)
+
+## Next Actions
+1. Run `/flow:spec` to interview and generate PRD for {{FIRST_MILESTONE}}

package/skills/flow-milestone.md

@@ -1,78 +0,0 @@
----
-name: flow:milestone
-description: Add new milestones to the roadmap
-user_invocable: true
----
-
-# /flow:milestone — Add New Milestones
-
-You are executing the `/flow:milestone` skill. This adds new milestones to the project roadmap.
-
-## Guard: Project Must Exist
-
-Check if `.planning/STATE.md` exists:
-- **If it does NOT exist** → Print: "No project found. Run `/flow:setup` first." and **STOP.**
-- **If it exists** → Continue.
-
-## Step 1: Read Context
-
-Read `.planning/STATE.md` and `.planning/ROADMAP.md` to understand:
-- Current milestone status (what's active, what's complete, what's planned)
-- What version numbers are already used
-
-## Step 2: Show Current Status
-
-Print a summary of the roadmap:
-- List all milestones with their status (Complete, Pending, Planned, In Progress)
-- Highlight the currently active milestone (if any)
-
-## Step 3: Check for Active Work
-
-If there is a milestone with status "Pending" or with incomplete phases (In Progress):
-- Print: "Note: [milestone name] is currently active. New milestones will be added after existing planned milestones."
-
-## Step 4: Gather New Milestones
-
-Use AskUserQuestion:
-- "How would you like to add milestones?" with options:
-  - "I'll paste or describe them"
-  - "One at a time (guided)"
-
-**If paste/describe:**
-- Accept free text (bullet list, paragraph, pasted doc — any format)
-- Parse into milestones, each with a name + brief goal
-- Print back: "Here's what I got:" followed by the parsed list
-- Use AskUserQuestion to confirm: "Does this look right?" with options:
-  - "Yes — looks good"
-  - "Let me adjust" (user re-enters)
-
-**If guided:**
-- Ask: "What's this milestone called?" (name) and "What's the goal?" (one-sentence description)
-- Then: "Add another milestone?" with options:
-  - "Yes — add another"
-  - "That's all"
-- Repeat until user says that's all
-
-## Step 5: Update Planning Docs
-
-**ROADMAP.md:**
-- Determine the next available version number (after existing milestones)
-- Add new milestone rows to the table with status "Planned"
-- Add new milestone sections with goals and "Run `/flow:spec` when this milestone is active."
-
-**If no active milestone** (all existing milestones are "Complete" or there are none):
-- Set the first new milestone's status to "Pending — needs `/flow:spec`"
-- Update STATE.md to point to the new milestone as current
-
-## Step 6: Print Completion Message
-
-```
-Added [N] milestone(s) to the roadmap:
-[list of added milestones with version numbers]
-
-[If a milestone was activated:]
-v[X] [name] is now active. Run /flow:spec to plan it.
-
-[If milestones were just queued:]
-These will activate in order as you complete current milestones.
-```