You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
/flow-next:plan Add a contact form with validation
@@ -219,6 +222,8 @@ flowctl ready --epic fn-1 # What's ready to work on
219
222
220
223
That's it. Flow-Next handles research, task ordering, reviews, and audit trails.
221
224
225
+
**Already know what you want to build?** Skip strategy and prospect — go straight to plan or work. Strategy and prospect are upstream grounding tools, not gates. See [When to Use What](#when-to-use-what) for the full route map.
226
+
222
227
### When to Use What
223
228
224
229
Flow-next is flexible. There's no single "correct" order — the right sequence depends on how well-defined your spec already is.
@@ -287,8 +292,9 @@ Best for: bug fixes, small features, well-scoped changes that don't need task sp
287
292
288
293
| Starting point | Recommended sequence |
289
294
|----------------|---------------------|
290
-
| No target yet, want ranked candidates | Prospect → (promote) → Plan → Work ([details](#prospecting)) |
| Conversation already in flight | Capture → Interview/Plan → Work |
293
299
| Free-form discussion, lock it down | Capture → Plan → Work |
294
300
| New feature, want solid spec first | Spec → Interview/Plan → Work |
@@ -297,12 +303,15 @@ Best for: bug fixes, small features, well-scoped changes that don't need task sp
297
303
| Well-understood, needs task splitting | Plan → Work |
298
304
| Small single-task, spec complete | Work directly (creates 1 epic + 1 task) |
299
305
300
-
**Prospect vs Capture vs Spec vs Interview vs Plan:**
306
+
Strategy is **upstream of every route** — set it once, every downstream skill (prospect / plan / interview / capture / sync) reads `STRATEGY.md` as advisory grounding. Skip it if you don't want a strategic anchor; everything still works the same way as before 0.40.0. See [Project Strategy](#project-strategy) for details.
307
+
308
+
**Strategy vs Prospect vs Capture vs Spec vs Interview vs Plan:**
309
+
-**Strategy** (`/flow-next:strategy`) writes/maintains a repo-root `STRATEGY.md` (target problem, approach, personas, key metrics, tracks). Run once early, revisit per-section as direction shifts. Downstream skills read it as advisory grounding (never auto-supersedes). Optional — skip if your repo has no strategic intent worth recording.
301
310
-**Prospect** (`/flow-next:prospect [hint]`) generates many candidate ideas, critiques each one, and writes a ranked artifact under `.flow/prospects/`. Use when you don't have a target yet. Promote a survivor to an epic via `flowctl prospect promote` (direct path to plan), or hand the survivor to `/flow-next:capture` for a richer conversation-driven spec.
302
-
-**Capture** (`/flow-next:capture`) synthesizes conversation context into an epic spec — the automated alternative to manual `flowctl epic create + epic set-plan`. Use after prospect-promotion or after a free-form design discussion. Source-tags every acceptance criterion (`[user]` / `[paraphrase]` / `[inferred]`); mandatory read-back loop; never silently invents requirements. Output goes to `.flow/specs/<epic-id>.md`.
311
+
-**Capture** (`/flow-next:capture`) synthesizes conversation context into an epic spec — the automated alternative to manual `flowctl epic create + epic set-plan`. Use after prospect-promotion or after a free-form design discussion. Source-tags every acceptance criterion (`[user]` / `[paraphrase]` / `[inferred]` / `[strategy:<track>]`); mandatory read-back loop; never silently invents requirements. Output goes to `.flow/specs/<epic-id>.md`.
303
312
-**Spec** (just ask "create a spec") creates an epic with structured requirements (goal, architecture, API contracts, edge cases, acceptance criteria, boundaries). Same destination as capture, but the manual heredoc path — useful for scripted callers.
304
-
-**Interview** refines an epic via deep Q&A (40+ questions). Writes back to the epic spec only — no tasks.
305
-
-**Plan** researches best practices, analyzes existing patterns, and creates sized tasks with dependencies.
313
+
-**Interview** refines an epic via deep Q&A (40+ questions). Doc-aware mode reads glossary + decisions + strategy and surfaces conflicts. Writes back to the epic spec only — no tasks.
314
+
-**Plan** researches best practices, analyzes existing patterns, and creates sized tasks with dependencies. Reads strategy if present and emits a `## Strategy Alignment` section listing which active tracks the plan serves.
306
315
307
316
You can always run interview again after planning to catch anything missed. Interview writes back to the epic spec only — it won't modify existing tasks.
308
317
@@ -2125,9 +2134,32 @@ Flow-Next uses the same defaults in manual and Ralph runs. Ralph bypasses prompt
2125
2134
2126
2135
Override via flags or `scripts/ralph/config.env`.
2127
2136
2137
+
### Strategy Phase (optional, upstream of everything)
2138
+
2139
+
Run once early or whenever direction shifts. Sets a repo-wide strategic anchor that downstream skills read as advisory grounding.
2140
+
2141
+
1.**Run**`/flow-next:strategy` — interview-driven Q&A populates 5 required sections (Target problem / Our approach / Who it's for / Key metrics / Tracks) + 2 optional (Milestones / Not working on). 2-round pushback per section against fluff / vanity / feature-list answers
2142
+
2.**Re-run anytime** with section name (e.g., `/flow-next:strategy metrics`) to revisit one block — preserves the rest byte-identical, bumps `last_updated`
2143
+
3.**Downstream consumers** auto-detect and ground against `STRATEGY.md`:
2144
+
- Prospect — Phase 0 grounding scan emits approach + tracks verbatim into the candidate-generation prompt; adds `out-of-scope-vs-strategy` to the rejection taxonomy
2145
+
- Plan — research scan reads strategy; epic spec gets a `## Strategy Alignment` section listing tracks served + read-only `## Strategy drift flagged for review` block on conflict
2146
+
- Interview — doc-aware mode adds a `## Strategy Conflicts` section parallel to `## Glossary Conflicts`; throttled to ≤1 strategy question per turn
2147
+
- Capture — Phase 0 reads strategy; tags strategy-derived acceptance criteria as `[strategy:<track-name>]`; refuses to write contradicting specs without `--override-strategy` (which prompts for a decision-record write)
2148
+
- Plan-sync — surfaces strategy drift read-only; renames update inline with breadcrumb; never auto-supersedes
2149
+
2150
+
Skip this phase entirely if your repo has no strategic intent worth recording. All downstream skills run identically when `STRATEGY.md` is absent or empty (husk).
2151
+
2152
+
### Prospecting Phase (optional, when no target yet)
2153
+
2154
+
Run when you don't know what to build next. Generates ranked candidates grounded in repo + strategy + memory + open epics.
0 commit comments