This page is the canonical step sequence (15 steps, which part owns each). It is a reference table — not a daily runbook and not the prompt library.
| Need | Open |
|---|---|
| Step order and part ownership | This page |
| Copy-paste prompts | Session prompt standard |
| Rules, scripts, phase checklists | Daily runbook |
| Planning → SPDD → SDLC entry paths | Three-part operating path |
The workflow is hybrid: SDLC Agents supplies the lifecycle; SPDD supplies the REASONS Canvas contract; Planning supplies roadmap, milestone, and session-note narrative.
ROADMAP.md / milestone-*.md / requirements/milestones/ / session-notes/
-> inform and summarize
spdd/canvas/ + agent-context/
-> govern and remember
code / reviews / sync logs
-> execute and validate
Claim the Work ID, then open a session brief. Prefer ./sdlc-spdd/scripts/sdlc.sh claim → start; paste the Resume Prompt from current-session.md — see Session prompt standard. Orient anytime with ./sdlc-spdd/scripts/sdlc.sh next or /sdlc-spdd-whereami.
/sdlc-spdd-* steps are assistant commands (Cursor/Copilot/Claude Code chat). ./sdlc-spdd/scripts/* steps are shell commands (terminal). How to run assistant commands.
| Step | Part | Action |
|---|---|---|
| 1 | SDLC | Set up prompts and memory — from orchestrator repo: ./scripts/setup-agent-prompts.sh --target /path/to/app --all |
| 2 | SDLC | Initialize — /sdlc-spdd-init |
| 3 | Planning → SPDD | Map milestone work when needed — ./sdlc-spdd/scripts/create-work-from-milestone.sh --target . --milestone milestone-1.md --all |
| 4 | SDLC | Claim + start session — ./sdlc-spdd/scripts/sdlc.sh claim <WORK-ID> then sdlc.sh start (or resume + start) → paste Resume Prompt |
| 5 | SPDD (+ Planning) | Analysis — /sdlc-spdd-analysis @requirements/my-feature.md @ROADMAP.md @milestone-1.md, then ./sdlc-spdd/scripts/index-spdd-analysis.sh --target . --work-id <WORK-ID> |
| 6 | SPDD (+ Planning) | Plan — /sdlc-spdd-plan @spdd/analysis/<WORK-ID>-analysis.md (requires the analysis artifact from step 5) |
| 7 | SPDD | Architect — /sdlc-spdd-architect @spdd/canvas/<WORK-ID>.md |
| 8 | SDLC + SPDD | Code — /sdlc-spdd-code @spdd/canvas/<WORK-ID>.md operation T01 (one operation at a time) |
| 9 | SPDD | API test — /sdlc-spdd-api-test @spdd/canvas/<WORK-ID>.md |
| 10 | SPDD | Review — /sdlc-spdd-review @spdd/canvas/<WORK-ID>.md |
| 11 | SPDD | Prompt update when intent changes — /sdlc-spdd-prompt-update @spdd/canvas/<WORK-ID>.md |
| 12 | SDLC | Retro — /sdlc-spdd-retro @spdd/canvas/<WORK-ID>.md |
| 13 | SPDD | Sync — /sdlc-spdd-sync @spdd/canvas/<WORK-ID>.md |
| 14 | SDLC | Sunset — /sdlc-spdd-sunset <WORK-ID> (engine collects GitHub PR, GitHub issue, commit, and Jira state into the ledger) |
| 15 | SDLC + Planning | Capture memory and session notes — ./sdlc-spdd/scripts/sdlc.sh capture ... (milestone auto-detected when Work ID is in milestone-*.md) |
| 16 | Planning ← SPDD | Refresh roadmap summary — ./sdlc-spdd/scripts/sync-roadmap-from-spdd.sh --target . |
Use prefixes: FEAT, BUG, REF, SPIKE, DOC, TEST, CHORE.
Example: FEAT-001-order-status-api
See agent-context/harness/quality-gates.md.
In your installed project, runtime scripts live under sdlc-spdd/scripts/:
./sdlc-spdd/scripts/validate-reasons-canvas.sh spdd/canvas/
For the full documentation map, see docs/README.md. Daily essentials:
- Daily runbook — operational rhythm and checklists
- Session prompt standard — copy-paste prompts
- Agent session scripts — setup, resync, capture scripts