Windsurf rules

1---
2name: compose-workflow
3model: sonnet
4description: "Chain multiple bigpowers skills into a custom workflow recipe saved in specs/. Use when a project repeats a non-standard skill sequence, or user wants a documented playbook beyond orchestrate-project modes."
5---
6 
7# story: e09s01
8# story: e45s27
9# story: e21s04
10 
11# Compose Workflow
12> **HARD GATE** — **HARD GATE** — Workflows are orchestration, not automation. Do NOT create workflows for tasks that should be single skills. Workflow complexity must be justified.
13 
14 
15## Process
16 
171. Interview: goal, phases, which skills, gates between steps.
182. Write `specs/workflows/<name>.yaml`:
19   - `name`, `command`, `description`, `skills[]`, `verify`
20   - Optional: `args` for skill-specific arguments
213. Register in state.yaml Active Decisions.
224. Optional: reference from `orchestrate-project` Ad-Hoc mode.
23 
24> **Prefer the YAML recipe format** over the legacy `specs/WORKFLOW-<name>.md` markdown format.
25> YAML recipes are command-mappable, machine-readable, and listed in the Standard Recipe Library.
26 
27## Terminal-state taxonomy (e45s27)
28 
29Every workflow step and `/loop` tick MUST exit with exactly one terminal state:
30 
31| State | Meaning | Next action |
32|-------|---------|-------------|
33| `success` | Step verify passed; artifacts written | Advance to next skill in recipe |
34| `no-op` | Nothing to do (already green / already applied) | Skip step; advance |
35| `blocked` | External gate (approval, red CI, missing dep) | `diagnose-stall` or escalate to user |
36| `exhausted` | Max iterations/cycles reached (review cap, dispatch cycles) | Stop; human decision required |
37 
38Record terminal state in `specs/state.yaml` `handoff.last_terminal_state` when a recipe step completes. `/loop` ticks that produce no progress for two consecutive wakes → invoke `diagnose-stall`.
39 
40## Standard Recipe Library
41 
42Pre-built recipes in `specs/workflows/` map agentic stack commands to skill chains.
43Reference them in AGENTS.md so `/command` directly invokes the matching recipe.
44 
45| Command | Workflow | Skill chain |
46|---------|----------|-------------|
47| `/check-stack` | check-stack | survey-context → assess-impact → setup-environment |
48| `/ship` | ship | audit-code → commit-message → release-branch |
49| `/tdd` | tdd | develop-tdd → enforce-first |
50| `/code-review` | code-review | audit-code → request-review → respond-review |
51| `/security` | security | audit-code → request-review |
52| `/plan` | plan | survey-context → research-first → plan-work |
53| `/build-fix` | build-fix | investigate-bug → diagnose-root → develop-tdd → validate-fix |
54| `/e2e` | e2e | smoke-test → verify-work |
55 
56Add to `AGENTS.md`:
57```
58/check-stack = compose-workflow check-stack
59/ship        = compose-workflow ship
60```
61 
62## Verify
63 
64→ verify: `[ "$(ls specs/workflows/*.yaml 2>/dev/null | wc -l | tr -d ' ')" -ge 8 ]`
65 
66See [REFERENCE.md](REFERENCE.md) for template.
67 
68---
69 
70# Workflow template
71 
72```markdown
73# WORKFLOW: <name>
74 
75**Trigger:** Use when ...
76 
77| Step | Skill | Output | verify |
78|------|-------|--------|--------|
79| 1 | survey-context | state.yaml handoff | ... |
80| 2 | research-first | Prior Art in SCOPE_LATEST.yaml | ... |
81| 3 | plan-work | epics/eNN-*.yaml tasks | ... |
82```
83