STOP - Read before ANY tool call
- Read
E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/rules/guardrails.mdc - Read
_shared/sdd-artifacts/SESSION.md; load session-state for$Cwd - If the relevant gate is not approved: STOP - ask user (pt-BR) - do NOT Write/Shell
- SDD/develop skills: after ONE step/task, STOP session - handoff only
- This skill body is English; user-facing prompts may be (pt-BR)
Step -1 - Gate check (report in chat before continuing)
Gate check:
[ ] guardrails.mdc read
[ ] SESSION.md read; session-state loaded
[ ] PIPELINE.md read (required for orchestrate-*)
[ ] User confirmed current action (sim)
-> If any unchecked: STOP
Skill: orchestrate-deliver
Trigger
Invoke when the user asks for: /orchestrate-deliver, orchestrate deliver, /orchestrate-deliver, or Orchestrated Delivery O2 after an approved O1 backlog.
Required: full feature path (or resolvable features/NNN-slug/).
Outcome
Under each approved story folder (USnn / TSnn):
PRD/NNN_*.md- viasdd-speccontract (what, not how)PLAN/PLAN_NNN_*.md- viasdd-plancontract (baby steps)- Feature-root
CHANGE.md- required when FEATURE Nature is brownfield (ADDED | MODIFIED | REMOVED vs currentmemory-bank/docs; greenfield must not force an empty stub) —CHANGE-CONTRACT.md/sdd-spec - Feature
CONTINUITY.md- phasedeliver, decisions, typed multi-path handoff, Memory-bank path + status
Mental map (ids unchanged): O2 ≈ FEATURE + PRD + CHANGE (then PLAN). O1 ≈ explore; O3 ≈ apply. Skill ids stay orchestrate-*.
Step 0 (required): Memory Bank Gate (MEMORY-BANK.md, policy auto) before mode selection / story contracts. Resolve bank_root via STORAGE.md - never under features/. CONTINUITY remains the feature phase/handoff source; bank does not replace it.
Human gate: PRD/PLAN approval per story or batch (sim / ajustar / cancelar). Silence ≠ approval (RN01).
Orchestrator does not implement application code. Does not rewrite sdd-spec / sdd-plan process - load those skills and run their contracts per story. Does not call trackers.
Lazy-load (only when needed)
| When | Path (after scripts/sync-cursor.ps1) |
|---|---|
| Caveman Mode (if active) | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/_shared/caveman/CAVEMAN.md - Lite cap |
| Pipeline Orchestrated Delivery, confirm, paths | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/_shared/sdd-artifacts/PIPELINE.md |
| Storage, manifest, feature tree | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/_shared/sdd-artifacts/STORAGE.md |
| Step 0 Memory Bank Gate | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/_shared/sdd-artifacts/MEMORY-BANK.md |
| Memory-bank create/refresh | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/memory-bank-init/SKILL.md |
| CONTINUITY / FEATURE templates | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/_shared/templates/features/ |
| Spec contract | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/sdd-spec/SKILL.md (+ E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/sdd-spec/reference.md as needed) |
| Plan contract | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/sdd-plan/SKILL.md (+ E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/sdd-plan/reference.md as needed) |
| CHANGE brownfield / current | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/_shared/sdd-artifacts/CHANGE-CONTRACT.md |
| Process details, modes, approval, Must not | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/orchestrate-deliver/reference.md |
Spawn native vs fallback (capability subagents) |
E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/_shared/agents/SPAWN.md |
| Task subagent model (default omit; rare premium gate) | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/_shared/agents/SUBAGENT-MODEL.md |
| Context pressure | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/rules/context-management.mdc |
Never by default: do not preload both sdd-spec and sdd-plan full bodies plus all templates and SPAWN/SUBAGENT-MODEL before mode selection. Load contracts when running that story stage; load SPAWN only when choosing paralelo / spawning drafts.
Progressive load: PIPELINE.md + STORAGE.md first; fan-out to MEMORY-BANK.md at Step 0, then sdd-spec → sdd-plan per story, and orchestrate-deliver/reference.md for Process step details / mode / approval / Must not when needed.
Reference routing
| Situation | Path |
|---|---|
| Gate / Orchestrated Delivery / siblings STOP | PIPELINE.md |
| Feature / bank roots | STORAGE.md |
| Step 0 Memory Bank | MEMORY-BANK.md |
| Before paralelo Task wave | SPAWN.md |
| Write PRD (after sim) | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/sdd-spec/SKILL.md |
| Write PLAN (after sim) | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/sdd-plan/SKILL.md |
| Process steps / mode / batch approval / Must not | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/skills/orchestrate-deliver/reference.md |
Process
Read reference.md for procedural tables, prompts, and checklists under each step. Do not skip gates.
Step -1b - Caveman Mode (Lite cap)
Apply Lite caveman prefs when active. Details: reference.md § Process — Caveman (Lite cap).
1. Gate check
Report the Step -1 gate checklist in chat. Load PIPELINE.md (Orchestrated Delivery) and SESSION.md. STOP if any gate unchecked.
2. Resolve feature and storage
Load STORAGE.md; resolve feature + bank roots; path sanitize; STOP if FEATURE/CONTINUITY missing. Details: reference.md § Process — Resolve feature and storage.
3. Step 0 - Memory Bank Gate
Follow MEMORY-BANK.md (policy default auto). Bank root = resolved bank_root - not under features/. Update CONTINUITY Memory-bank fields; pass bank_path into parallel draft Tasks read-only. Details: reference.md § Step 0 - Memory Bank Gate.
4. Preconditions (approved backlog)
Verify backlog sim/approved; discover stories; STOP if flag-gated ANALYSIS|ARCH|SEC missing. Details: reference.md § Process — Preconditions + § Preconditions checklist.
5. Choose mode (RF03)
Ask série vs paralelo (never assume); load SPAWN.md before paralelo; omit Task model by default. Details: reference.md § Process — Choose mode + § Mode comparison (RF03).
6. Per-story contracts (reuse, do not rewrite)
Run sdd-spec then sdd-plan per story (série in-parent, or paralelo draft-only children + parent Write after sim). Per-story STOP if required siblings missing. Details: reference.md § Process — Per-story contracts + § Contract reuse + § Task child prompt skeleton.
7. Approval - per story or batch (RN01)
Present summary; sim / ajustar / cancelar (por história | lote). Details: reference.md § Process — Approval answers + § Approval gates.
8. CONTINUITY + multi-path handoff (RF04)
Update CONTINUITY phase deliver; run cross-artifact analyze (CHANGE-CONTRACT.md: Nature↔CHANGE, complexity↔TASKS, validate-change when CHANGE exists); emit manual sdd-develop + O3 handoff paths. Details: reference.md § Process — CONTINUITY + multi-path handoff + § Example handoff + § Cross-artifact analyze.
9. Context pressure (TE02 / RNF02)
Honor context-management.mdc; persist CONTINUITY; resume invoke. Details: reference.md § Process — Context pressure.
Must not
Enforce the full list in reference.md § Must not (full). Critical always-on: no app code; no PRD/PLAN without required siblings; no child disk Write of PRD/PLAN; no silence-as-sim; no hard-fail when Task unavailable (fallback série in-parent); portable paths only.
Handoff
| Situation | Next |
|---|---|
| All stories approved | /orchestrate-develop - <portable-feature-path> or per-story sdd-develop |
| Context pause mid-O2 | /orchestrate-deliver - <portable-feature-path> |
| Backlog not approved | /orchestrate-analyze - <portable-feature-path> |
| Required siblings missing | /orchestrate-analyze - <portable-feature-path> (do not Write PRD/PLAN) |
| Single story only (skip O2) | /sdd-spec then sdd-plan (Classic SDD) |
Canonical develop handoffs
/sdd-develop - <portable-plan-path> - Step 1
/orchestrate-develop - <portable-feature-path>