Sdd Spec

--- name: sdd-spec description: Create a PRD for a new feature or change (agent PRD .md, pt-BR default under features/). Feeds sdd-plan. Use when creating a spec or invoking /sdd-spec.

STOP - Read before ANY tool call

1. Read E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/codex/rules/guardrails.md
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-spec

Trigger

Invoke when the user asks for: /sdd-spec, create spec, new feature.

Outcome

A complete PRD (agent .md artifact) in Brazilian Portuguese (pt-BR) at a canonical path under features/NNN-slug/USnn/PRD/ (Classic SDD default story US01; or TSnn). Global: E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/codex/sdd/<repo-id>/features/.... Root/flat PRD/ is not a valid Classic SDD path. English only if the user overrides in this invocation. Mandatory input for sdd-plan.

PRD boundaries

The PRD answers what, not how. No implementation code. Identifiers (types, APIs, paths) in English.

Lazy-load (only when needed)

Process

Step -1b - Caveman Mode (Lite cap)

1. Read E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/codex/sdd/preferences.json (create { "caveman_mode": false, "caveman_level": "full" } if missing).
2. If caveman_mode is false: continue without compression.
3. If true: load E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/codex/plugin/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 the storage mode selection flow and persist it in manifest.json. Apply Phase A/B: in Plan/Ask, draft in chat only until Agent + user sim on section Confirm below. Pipeline lock: no PLAN, no Edit/Write on *.cs, *.csproj, migrations.

0. Workspace

Target repo (not this toolkit repo unless subject). Read AGENTS.md / README.md. Detect stack. Resolve <repo-id> and classic feature root (STORAGE.md). Glob PRDs under features/**/PRD/ only (workspace + global feature root) for NNN. Classic SDD default story folder = US01 when unspecified.

1. Requirements

Prior context (chat, code-review, backlog, feature siblings, promoted bank): structured summary + max 3 gap questions - skip full questionnaire (PIPELINE.md section Prior context + Feature / story siblings).

Resolve-PRD / cited .md: If the user cited a non-feature .md (including .cursor/plans/), follow PIPELINE.md § Promote: Read and copy rich content into memory-bank phase 2 and/or story ARCH|SEC|ANALYSIS before synthesizing the PRD. Prefer promoted siblings and memory-bank over re-asking. Pointer-only citations are not Prior context.

When under features/NNN-slug/, load FEATURE.md, CONTINUITY.md, STORY.md, REFINE/ when present (optional / on demand), and ANALYSIS|ARCH|SEC when the matching FEATURE needs_* (or brownfield) is true (those folders are required, not optional). Prefer sibling/bank content over re-asking; still max 3 gap questions.

Required siblings STOP: If FEATURE needs_* is true (or brownfield) and the story lacks the matching ANALYSIS/ / ARCH/ / SEC/ folder/files: STOP. Do not Write PRD. Return to O1 (/orchestrate-analyze) or create those folders first. Max-3 gap questions do not replace this gate.

Otherwise ask (pt-BR):

Vou criar o PRD. Informe:
1) Feature - o que construir ou alterar?
2) Comportamento atual
3) Comportamento esperado
4) Contexto adicional (opcional)
5) ID de rastreamento (opcional)

Wait for answers.

2-5. Confirm repo, explore code, clarify (<=5), technical analysis

Per existing skill intent: branch confirmation, Glob/Grep/Read, brief impact/risks for the PRD.

6. Context checkpoint

context-management.mdc. At >=40%, draft in chat or partial file; warn before continuing.

6.75 Confirm before write

Show title, NNN, full canonical path (resolved under the active storage-mode directory), storage mode, bullets, and status Pronto para planejamento. Wait for sim / ajustar / cancelar. In Plan/Ask without sim in Agent: Phase A message only.

Record artifact_language (default pt-BR) from manifest or user override.

7. Write PRD (Agent + sim only)

1. Validate path per PIPELINE.md section Path validation - abort if non-canonical (writes only under features/.../PRD/).
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. Path: features/NNN-slug/US01/PRD/NNN_short_feature_slug.md (adjust story id); body from reference.md.
4. Product docs/ in scope: ask doc language first.

Report path, storage, language, .gitignore changes. Handoff with full feature path:

/sdd-plan - features/NNN-slug/US01/PRD/NNN_short_feature_slug.md

Must not

• English PRD body by default; implementation code in PRD
• Write outside canonical feature PRD folders (never root/flat PRD/); skip confirm-before-write
• Write PRD when flag-gated required siblings (ANALYSIS/ / ARCH/ / SEC/) are missing for true FEATURE needs_* / brownfield — STOP; max-3 gap questions do not replace this gate
• Edit/Write production or test code; create PLAN in this session
• Claim "PRD saved" without successful Write
• External trackers; paste full guideline bodies into PRD

Handoff

/sdd-plan - <full-prd-path-under-features>