Sdd Plan

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 (SDD skills only)
[ ] User confirmed current action (sim)
-> If any unchecked: STOP

Skill: sdd-plan

Trigger

Invoke when the user asks for: /sdd-plan, create plan, execution plan.

Outcome

A PLAN in the user chat language (or preferences.json / manifest artifact_language when set) at a canonical path under features/NNN-slug/USnn/PLAN/PLAN_NNN_*.md (same story as the PRD; global under {{SDD_ROOT}}/<repo-id>/features/...). Root/flat PLAN/ is not a valid Classic SDD path. Same NNN as PRD. Each step = one sdd-develop session. Paths and test names in English; no code blocks. Include ## Execution policy from templates/sdd/PLAN.md (orchestrator mode, parent/child validation, handoff).

PLAN magro: do not paste SQL/DDL/JSON/OpenAPI into the PLAN. Refuse to omit those bodies from PLAN unless the canonical path already exists (bank phase 2 database-schema.md / api-contracts.md / component-catalog.md, or story ARCH/ / ANALYSIS/). If missing, O1/O2 must create the canonical file first; PLAN only cites the path.

Lazy-load (only when needed)

Never by default: do not preload references/command.md before Step -1 gates; do not preload all references/*.md, full sdd-spec/develop packs, all templates, or all backlog-item-types/*. Contract first (PIPELINE + STORAGE); after gates load references/command.md for step discovery; load one references/<section>.md per Process step (SKILL-REFERENCE-RETRIEVAL.md). Load story-sizing.md / anti-task-shatter.md only when sizing or rewriting step titles.

Process

After gates: Read references/command.md for ordered step discovery (prefer over dumping this Process into prompts). Then load references/<section>.md for authoring tables — not full reference.md.

Step -1b - Caveman Mode (Lite cap)

1. Read {{SDD_ROOT}}/preferences.json (create { "caveman_mode": false, "caveman_level": "full", "orchestrator_mode": "always", "artifact_language": null } if missing).
2. If caveman_mode is false: continue without compression.
3. If true: load {{TOOLKIT_ROOT}}/skills/_shared/caveman/CAVEMAN.md; apply Lite participation cap + prefs caveman_level (Lite skills never escalate); show once: [Caveman] Modo ativo (respostas compactas, level={effective}). Digite caveman off para desativar.
4. Honor caveman on|off|status|lite|full|ultra (and stop caveman / normal mode) during the session.
5. Auto-Clarity + never-compress gates/drafts/paths per CAVEMAN.md.

-1. Pipeline and mode

Load STORAGE.md and PIPELINE.md. Use STORAGE.md schema v2 and run the dynamic storage resolution algorithm with parameter $Workflow = classic. Resolve storage_mode and path for the active repository. If this is the first run for the repository, execute storage mode selection and persist it in manifest.json. Resolve invocation_context per INVOCATION-CONTEXTS.md (IC-DIRECT-ORCHESTRATED): default direct unless parent handoff marks orchestrated. Apply the matching observable table. Honor CONTRACT-PROVENANCE.md (CP-AGREED-VS-INVENTED) when mapping PRD → steps: treat unlabeled REQs as agreed; do not promote invented assumptions into Aceite as locked criteria. Phase A/B as for sdd-spec. No PRD authoring; no production/test code.

0. Workspace

Target repo. Read AGENTS.md / README.md if present.

1. Resolve PRD

Glob canonical PRDs under features/**/PRD/ only (workspace + global feature root). Do not resolve or execute against root/flat PRD/ or docs/PRD/.

Summarize PRD (cite portable path — must not paste the full PRD body into chat dumps, PLAN, or child prompts; SELECTIVE-RETRIEVAL.md / SR-NO-FULL-DUMP). Ask to proceed.

2-4. Explore, technical questions (<=10), baby steps

Glob/Grep/Read (selective bank paths only — never dump entire memory-bank/; references/selective-retrieval.md). When story ARCH/ / ANALYSIS/ exist, cite those portable paths in step notes / Decisões (PLAN magro — do not paste bodies). Steps ~20-45 min each (references/baby-step-sizing.md). Map every PRD REQ-NNN into Mapa REQ → passo (complete coverage — no orphan REQs). Each step Aceite must cite at least one REQ-NNN and/or CA with non-vague verifiable outcomes. Challenge vague Aceite ("as expected", "funciona") and anti file-named steps (title ≠ only file/class/script) — references/challenge-vagueness.md; lazy-load story-sizing.md / anti-task-shatter.md when titles look task-shaped.

5. Context checkpoint

context-management.mdc; PLAN draft in chat if >=40%.

5.5 PLAN storage

STORAGE.md; global PLAN if PRD is global; else manifest or prompt.

5.75 Confirm before write

PIPELINE.md section Confirm before write - PLAN_NNN_*, portable path (STORAGE.md § Portable path), PRD link, step count. sim required before Write in Agent. Confirm chat may show OS absolute; artifact Writes use portable paths only.

6. Write PLAN (Agent + sim only)

1. Validate canonical PLAN path under same story as PRD (features/.../PLAN/); NNN equals PRD NNN. Do not write or update PLANs at repo-root PLAN/.
2. Repository mode: .gitignore per STORAGE.md (include /features/; keep /PRD/ /PLAN/ as safety net only; do not add /memory-bank/ — commit bank when product knowledge; never commit secrets). Global mode: do not edit .gitignore.
3. Body from templates/sdd/PLAN.md (authoring: references/template-usage.md, references/filename-numbering.md, references/storage-gitignore.md, references/status-legend.md); include ## Execution policy; PRD header = portable path to PRD (STORAGE.md § Portable path); steps Pendente; 0/N; REQ→step map complete; every step Aceite lists REQ-NNN and/or CA.
4. PLAN magro: if the PLAN would omit SQL/DDL/JSON/OpenAPI, the canonical path (bank phase 2 or ARCH/ / ANALYSIS/) must already exist; if missing, STOP — O1/O2 creates that file first; PLAN cites the path only (references/plan-magro.md).
5. Warn if overwriting PLAN with completed steps.

6.5 Structural validate before advance

After a successful Write, run structural validate-plan (and prefer a prior validate-prd on the source PRD) before handoff (references/validate-plan.md):

.\scripts\validation\validate-prd.ps1 -Path <source-prd-path>
.\scripts\validation\validate-plan.ps1 -Path <written-plan-path> -PrdPath <source-prd-path>

Exit ≠ 0 → STOP; fix REQ→step coverage (or PRD structure); re-run until exit 0. Do not advance to /sdd-develop on failure. Enforcement smoke: Assert-ValidatePrdPlan.ps1.

7. Validate with user

Present steps, deps, risks. Confirm first sdd-develop step.

Must not

• Write PLAN in a language other than user chat / artifact_language without override; embed implementation code
• Omit SQL/DDL/JSON/OpenAPI from PLAN when no canonical path exists (bank phase 2 or ARCH/ / ANALYSIS/) — O1/O2 must create that file first; PLAN then cites the path
• Paste SQL/DDL/JSON/OpenAPI into PLAN when a canonical path already exists (cite the path only — PLAN magro)
• Create or overwrite PRD; sdd-develop or commit here
• Write PLAN without canonical PRD (except explicit user choice 2 with specs)
• Skip confirm-before-write; claim PLAN saved without Write
• NNN mismatch vs PRD; new writes outside features/.../PLAN/
• Do not dump entire memory-bank/ or paste full PRD into PLAN/prompts (SELECTIVE-RETRIEVAL.md / SR-NO-FULL-DUMP)
• Do not ignore IC-DIRECT-ORCHESTRATED — resolve and apply direct vs orchestrated (INVOCATION-CONTEXTS.md)
• Do not ignore CP-AGREED-VS-INVENTED — do not re-label invented PRD assumptions as agreed Aceite (CONTRACT-PROVENANCE.md)
• Do not omit REQ→step coverage or ship vague Aceite without challenge
• Do not ship steps whose titles are only a file/class/script/path name (anti-task-shatter.md / story-sizing.md)
• Do not paste ARCH/ANALYSIS bodies into the PLAN when portable paths exist (cite paths only)
• Do not hand off to sdd-develop when validate-plan (or validate-prd on the source) exits ≠ 0
• Write SDD artifacts containing OS absolute paths matching ^[A-Za-z]:/ or user-home InstallRoot embeds (…/.cursor/sdd/…, …/.claude/sdd/…) — use portable paths per STORAGE.md § Portable path

Handoff

/sdd-develop - features/NNN-slug/US01/PLAN/PLAN_NNN_slug.md - Step 1

(Global: prefix with sdd/<repo-id>/ — portable path relative to InstallRoot.)

One session = one PLAN step.