Orchestrate Develop

--- name: orchestrate-develop description: Orchestrated Delivery O3: one Task subagent per PLAN step (sdd-develop contract); parent never writes app code. Updates CONTINUITY; handoff to code-review. Use when invoking /orchestrate-develop.

STOP - Read before ANY tool call

1. Read {{GUARDRAILS_PATH}}
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 references/command.md before Step -1 gates; 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; after gates load references/command.md for step discovery; fan-out to MEMORY-BANK.md at Step 0, SPAWN.md before spawn, sdd-develop contract into the child prompt path only, and one references/<section>.md per Process step — never full reference.md when a section file exists (SKILL-REFERENCE-RETRIEVAL.md).

Reference routing

Process

After gates: Read references/command.md for ordered step discovery (do not dump this Process section into child prompts). Then load references/<section>.md for the current step only — not full reference.md. Do not skip gates.

Step -1b - Caveman Mode (Full cap)

Apply Full caveman prefs when active. Read references/process-common.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.

1b. Resolve invocation context

Load INVOCATION-CONTEXTS.md. This skill defaults to orchestrated (IC-DIRECT-ORCHESTRATED). Apply orchestrated observable rules; every develop child handoff must include invocation_context: orchestrated (path cite only — no contract body dump).

2. Resolve feature / PLAN set

Load STORAGE.md; resolve feature + bank_root; path sanitize; build PLAN queue or STOP if missing. Read references/process-common.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. Read references/preconditions.md § Step 0 - Memory Bank Gate.

4. Build step queue (deps)

Parse pending steps; respect Deps; resolve execution mode (serial default); present queue; wait for sim. Read references/execution-modes.md and references/step-queue-spawn.md.

5. Spawn exactly one step child (CA5)

SPAWN first; honor execution mode + PLAN-LEDGER claim (Invoke-ExecutionModeGate / Invoke-PlanLedgerClaim); 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. Read references/execution-modes.md, references/step-queue-spawn.md, and references/anti-bypass.md.

5.5 Post-implement verifier (opt-in)

When preferences.json has verify_mode: true, spawn a read-only verifier child after a successful implementer return and before CONTINUITY update / next spawn. Default verify_mode is false — skip when unset. Read references/step-verifier.md.

6. Safe parallelism (optional)

Default serial mode. Parallel only when mode is parallel and all independence conditions + user sim + distinct SESSION files; cap ≤4. Mode violations reject/audit — never silent ignore. Read references/execution-modes.md and references/parallelism.md.

7. Stop conditions

Stop on story/feature done, context pressure, child blocked, or cancelar. Read references/continuity-handoff.md § Process — Stop conditions.

8. CONTINUITY

Update phase / Memory-bank / estado / handoff at each milestone. Read references/continuity-handoff.md.

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

When a child changed app files: confirm → refresh-light → CONTINUITY refreshed (or skip). Read references/continuity-handoff.md § Process — Step N refresh-light and references/preconditions.md § Step N - refresh-light.

10. Handoff - code-review + manual alternative

Emit review + manual /sdd-develop + continue O3 strings. Read references/continuity-handoff.md § Handoff copy.

Anti-bypass checklist (must enforce)

Parent and children must not bypass CA5. Enforce the full table in references/anti-bypass.md 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 references/must-not.md. Critical always-on: no parent app code; no multi-step children; no hard-fail when Task unavailable (fallback /sdd-develop); portable paths only; do not ignore IC-DIRECT-ORCHESTRATED (INVOCATION-CONTEXTS.md).

Handoff

Canonical strings

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

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

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