Windsurf rules

1---
2name: run-planning
3model: sonnet
4description: "DISCOVER-PHASE ADVANCER — Drive the discover-phase checklist (specs/planning-status.yaml) through survey-context → scope-work → research-first → elaborate-spec → plan-release → slice-tasks. NOT a duplicate of plan-work or the planning spine; it orchestrates the pre-coding discover phase only."
5---
6 
7# story: e24s03
8 
9# Run Planning
10 
11> **HARD GATE** — Before running planning skills, confirm the epic capsule exists and the active story is clear. Planning without a target is noise.
12>
13> **Role:** DISCOVER-PHASE ADVANCER — orchestrates the discover-phase sequence; hands off to the scope-work → slice-tasks → plan-work spine for implementation planning.
14 
15Updates `specs/planning-status.yaml` as discover-phase skills complete. This is NOT a duplicate of plan-work — it orchestrates the *pre-coding* discovery phase only (Discover phase in the 6-phase PMBOK lifecycle), handing off to the planning spine for implementation detail.
16 
17## When to use
18 
19- Starting a brand-new feature or initiative with no prior planning artifacts
20- Returning to a stalled initiative and needing to resume the discovery workflow
21- After `orchestrate-project` hands off to the Discover phase
22- When a new epic emerges from `change-request` and needs to go through full discovery
23 
24## Pre-flight
25 
26- [ ] Does `specs/planning-status.yaml` exist? If not, create it with the default workflow keys.
27- [ ] Does `specs/state.yaml` have `active_flow: planning`? Set it if not already.
28- [ ] Is the epic identified in `release-plan.yaml`? The epic must exist before discovery begins.
29 
30## Workflows (default keys)
31 
32- `survey-context` → `scope-work` → `research-first` → `elaborate-spec` (optional) → `plan-release` → `slice-tasks`
33 
34Each key maps to a skill invocation. Optional keys can be skipped; required keys must complete before the phase advances.
35 
36## Process
37 
381. **Read state** — Read `specs/planning-status.yaml` and `specs/state.yaml`. Understand where discovery stands: which workflow keys are `done`, which are `pending`, and which are `optional` (can be skipped).
39 
402. **Find next step** — Find the first workflow key with `status: pending`. If the key is `optional`, check if the user wants to run it. If not, mark it `skipped`.
41 
422a. **Context capsule check** — Before invoking `elaborate-spec`, check whether a fresh `specs/planning-context.yaml` exists:
43```bash
44   test -f specs/planning-context.yaml && python3 -c "
45import yaml, datetime
46d = yaml.safe_load(open('specs/planning-context.yaml'))
47written = d.get('written_at','')
48if written:
49    age = (datetime.datetime.now(datetime.timezone.utc) - datetime.datetime.fromisoformat(written)).total_seconds() / 3600
50    print(f'Context age: {age:.1f}h')
51" 2>/dev/null || echo "No context or no written_at"
52```
53   - If context is **< 24h old**, ask: `"Planning context from Xh ago exists for '<feature_name>'. Re-run elaborate-spec? [y/N]"`. Skip elaborate-spec on N.
54   - If context is **≥ 24h old** or absent, run elaborate-spec normally.
55   - On planning cycle completion (all required keys done), clear the capsule: delete `specs/planning-context.yaml` and set `planning-status.yaml` `context_capsule: null`.
56 
573. **Invoke the matching skill** — Run the skill that matches the workflow key:
58   - `survey-context` — where are we?
59   - `scope-work` — what's in and out?
60   - `research-first` — what already exists?
61   - `elaborate-spec` — refine the idea (optional)
62   - `plan-release` — sequence epics by WSJF
63   - `slice-tasks` — cut vertical slices
64 
654. **Update status** — On successful completion, set `status: done` for that workflow key in `planning-status.yaml`.
66 
675. **Advance** — Set `state.yaml` `active_flow: planning` while in this chain. When all required keys are done, set `handoff.next_skill` to `plan-work`.
68 
69## Workflow Keys Schema
70 
71In `specs/planning-status.yaml`:
72```yaml
73context_capsule:             # written by elaborate-spec; cleared on cycle completion
74  written_at: "2026-06-22T03:00:00Z"
75  written_by: elaborate-spec
76  feature_name: "add dark mode"
77workflows:
78  survey-context:
79    required: true
80    status: done
81  scope-work:
82    required: true
83    status: pending
84  research-first:
85    required: false
86    status: optional
87    note: "Skip if no external dependencies"
88  elaborate-spec:
89    required: false
90    status: optional
91  plan-release:
92    required: true
93    status: pending
94  slice-tasks:
95    required: true
96    status: pending
97```
98 
99## Verify
100 
101→ verify: `test -f specs/planning-status.yaml && [ "$(grep -c 'status: done' specs/planning-status.yaml)" -ge 3 ]`
102