Orchestrate Develop

STOP - Read before ANY tool call

1. Read E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/cursor-install-root/rules/guardrails.mdc
2. Read _shared/sdd-artifacts/SESSION.md; load session-state for $Cwd
3. If the relevant gate is not approved: STOP - ask user (pt-BR) - do NOT Write/Shell
4. SDD/develop skills: after ONE step/task, STOP session - handoff only
5. 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-develop

Trigger

Invoke when the user asks for: /orchestrate-develop, orchestrate develop, /orchestrate-develop, or Orchestrated Delivery O3 after O2 handoff.

Required: full feature path or a specific PLAN/PLAN_NNN_*.md path under a story.

Outcome

1. Pending PLAN step(s) executed via Task children when subagents=native (SPAWN.md), each following the sdd-develop contract (one PLAN step per child / session); when subagents=none or Task unavailable → fallback handoff to manual /sdd-develop (parent never writes app code; never hard-fail)
2. Feature CONTINUITY.md updated (phase develop, progress, typed next invoke, Memory-bank path + status)
3. Handoff to code-review (- single or - multi-angle; skill asks if omitted) and/or next step / next story

Step 0 (required): Memory Bank Gate (MEMORY-BANK.md, policy auto) before building the step queue / spawning children. Resolve bank_root via STORAGE.md. CONTINUITY stays the feature phase/handoff source.

Step N (after code changes): when at least one develop child succeeded with app file changes, run memory-bank-init mode refresh-light at bank_root before final handoff (MEMORY-BANK.md Step N). Confirm (pt-BR) first.

Parent orchestrator never writes application code, never marks multiple PLAN steps done in one child, and never bypasses sdd-develop gates (step_confirmed, tests before complete).

Alternative (always valid): user runs manual /sdd-develop - <portable-plan-path> - Step N without this skill (RF05 / CA5). Manual Classic SDD does not require memory-bank (CA7).

Mental map (ids unchanged): O3 ≈ apply (implement PLAN steps via sdd-develop). O1 ≈ explore; O2 ≈ FEATURE+PRD+CHANGE. See CHANGE-CONTRACT.md.

Evidence verifier (REQ-005 / CA4): children record features/NNN-slug/EVD/ + STATE.md and run validate-evidence inside sdd-develop. Verifier ≠ O3 — do not use O3 / Task parallelism as the evidence verifier mechanism (sequential script gate only). Levels: off | cheap | standard | strict. Contract: EVD-STATE-CONTRACT.md.

Living loop / TRACE (REQ-006 / CA5): at feature-wave close, children (or the final develop child) append features/NNN-slug/TRACE.jsonl and run converge → sync current → archive, then validate-trace -RequireArchiveComplete. Parent must not use O3 parallelism as the archive verifier. Contract: TRACE-ARCHIVE-CONTRACT.md.

Lazy-load (only when needed)

Never by default: do not preload sdd-develop + all developer guideline packs into the parent, or paste guideline bodies into develop children. Parent loads contracts and SPAWN; children load sdd-develop for their one step.

Progressive load: PIPELINE.md + STORAGE.md first; fan-out to MEMORY-BANK.md at Step 0, SPAWN.md before spawn, sdd-develop contract into the child prompt path only, and orchestrate-develop/reference.md for Process step details / anti-bypass / parallelism / Must not when needed.

Reference routing

Process

Read reference.md for procedural tables, prompts, and checklists under each step. Do not skip gates.

Step -1b - Caveman Mode (Full cap)

Apply Full caveman prefs when active. Details: reference.md § Process — Caveman (Full 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. Ask user sim before spawning the first develop child.

2. Resolve feature / PLAN set

Load STORAGE.md; resolve feature + bank_root; path sanitize; build PLAN queue or STOP if missing. Details: reference.md § Process — Resolve feature / PLAN set.

3. Step 0 - Memory Bank Gate

Follow MEMORY-BANK.md (policy default auto). Bank root = resolved bank_root - not under features/. Pass bank_path into every develop child as read-only Prior context. Details: reference.md § Step 0 - Memory Bank Gate.

4. Build step queue (deps)

Parse pending steps; respect Deps; present queue; wait for sim. Details: reference.md § Process — Build step queue + § Step queue algorithm.

5. Spawn exactly one step child (CA5)

SPAWN first; one Task = one PLAN step = full sdd-develop contract; omit Task model by default; fallback to manual /sdd-develop when Task unavailable. Parent updates CONTINUITY only after child returns. Details: reference.md § Process — Spawn one step child + § Task child prompt skeleton + § Anti-bypass checklist.

6. Safe parallelism (optional)

Default serial. Parallel only when all independence conditions + user sim + distinct SESSION files; cap ≤4. Details: reference.md § Process — Safe parallelism + § Safe parallelism rules.

7. Stop conditions

Stop on story/feature done, context pressure, child blocked, or cancelar. Details: reference.md § Process — Stop conditions.

8. CONTINUITY

Update phase / Memory-bank / estado / handoff at each milestone. Details: reference.md § Process — CONTINUITY fields + § CONTINUITY checklist.

9. Step N - Memory Bank refresh-light (after code changes)

When a child changed app files: confirm → refresh-light → CONTINUITY refreshed (or skip). Details: reference.md § Process — Step N refresh-light + § Step N - refresh-light.

10. Handoff - code-review + manual alternative

Emit review + manual /sdd-develop + continue O3 strings. Details: reference.md § Handoff copy.

Anti-bypass checklist (must enforce)

Parent and children must not bypass CA5. Enforce the full table in reference.md § Anti-bypass checklist before every spawn and before marking any step done. Critical: parent writes no app code; one child = one PLAN step; sim before next spawn; PLAN-scoped SESSION files for parallel children.

Must not

Enforce the full list in reference.md § Must not (full). Critical always-on: no parent app code; no multi-step children; no hard-fail when Task unavailable (fallback /sdd-develop); portable paths only.

Handoff

Canonical strings

/orchestrate-develop - <portable-feature-path>

/sdd-develop - <portable-plan-path> - Step N

/code-review
/code-review - multi-angle