ORCHESTRATOR GATE: If you loaded this skill via the skill() tool, you are
the ORCHESTRATOR — STOP. Do NOT execute these instructions inline. Delegate to
the dedicated sdd-init sub-agent using your platform's delegation primitive
(e.g., task(...), sub-agent invocation, etc.). This skill is for EXECUTORS
only.
Executor Override
If you ARE the sdd-init sub-agent (NOT the orchestrator), the gate above does NOT apply to you. Continue with the phase work below. Do NOT delegate. Do NOT call the Skill tool. You are the executor — execute.
Activation Contract
Run this phase when the orchestrator/user asks to initialize SDD in a project. You are the phase executor: do the work yourself, do not delegate, and do not behave like the orchestrator.
Hard Rules
- Detect the real stack, conventions, architecture, testing tools, and persistence mode; never guess.
- In
engram mode, do not create openspec/.
- In
openspec mode, follow ../_shared/openspec-convention.md and write file artifacts.
- In
hybrid mode, write both openspec files and Engram observations.
- Always persist testing capabilities separately as
sdd/{project}/testing-capabilities or openspec/config.yaml testing:.
- Always build
.atl/skill-registry.md; also save skill-registry to Engram when available.
- Use
capture_prompt: false for automated SDD/config saves when supported; omit it if the tool schema lacks it.
- If
openspec/ already exists, report what exists and ask before updating it.
Decision Gates
| Input |
Action |
mode=engram |
Save context and capabilities to Engram only. |
mode=openspec |
Create/update openspec bootstrap files only. |
mode=hybrid |
Do both Engram and openspec persistence. |
mode=none |
Return detected context only; write no SDD artifacts except registry if required. |
| strict TDD marker/config found |
Use that value. |
| no marker/config but test runner exists |
Default strict_tdd: true. |
| no test runner |
Set strict_tdd: false and explain unavailable. |
Execution Steps
- Inspect project files (
package.json, go.mod, pyproject.toml, CI, lint/test config) and summarize stack/conventions.
- Detect test runner, test layers, coverage, linter, type checker, and formatter.
- Resolve Strict TDD from agent marker,
openspec/config.yaml, detected runner fallback, or no-runner fallback.
- Initialize persistence for the resolved mode.
- Build
.atl/skill-registry.md using the skill-registry scan rules.
- Persist testing capabilities and project context.
- Return the structured initialization envelope.
Output Contract
Return status, executive_summary, artifacts, next_recommended, and risks. Include project, stack, persistence mode, Strict TDD status, testing capability table, saved observation IDs/paths, registry path, and next /sdd-explore or /sdd-new step.
References
- references/init-details.md — detection checklist, Engram payloads, config skeleton, and output templates.
../_shared/engram-convention.md — Engram artifact naming.../_shared/openspec-convention.md — openspec layout and rules.
1---2name: sdd-init3description: Trigger: sdd init, iniciar sdd, openspec init. Initialize SDD context, testing capabilities, registry, and persistence.4license: MIT5---67> **ORCHESTRATOR GATE**: If you loaded this skill via the `skill()` tool, you are8> the ORCHESTRATOR — STOP. Do NOT execute these instructions inline. Delegate to9> the dedicated `sdd-init` sub-agent using your platform's delegation primitive10> (e.g., `task(...)`, sub-agent invocation, etc.). This skill is for EXECUTORS11> only.1213## Executor Override1415If you ARE the `sdd-init` sub-agent (NOT the orchestrator), the gate above does NOT apply to you. Continue with the phase work below. Do NOT delegate. Do NOT call the Skill tool. You are the executor — execute.1617## Activation Contract1819Run this phase when the orchestrator/user asks to initialize SDD in a project. You are the phase executor: do the work yourself, do not delegate, and do not behave like the orchestrator.2021## Hard Rules2223- Detect the real stack, conventions, architecture, testing tools, and persistence mode; never guess.24- In `engram` mode, do **not** create `openspec/`.25- In `openspec` mode, follow `../_shared/openspec-convention.md` and write file artifacts.26- In `hybrid` mode, write both openspec files and Engram observations.27- Always persist testing capabilities separately as `sdd/{project}/testing-capabilities` or `openspec/config.yaml` `testing:`.28- Always build `.atl/skill-registry.md`; also save `skill-registry` to Engram when available.29- Use `capture_prompt: false` for automated SDD/config saves when supported; omit it if the tool schema lacks it.30- If `openspec/` already exists, report what exists and ask before updating it.3132## Decision Gates3334| Input | Action |35|---|---|36| `mode=engram` | Save context and capabilities to Engram only. |37| `mode=openspec` | Create/update openspec bootstrap files only. |38| `mode=hybrid` | Do both Engram and openspec persistence. |39| `mode=none` | Return detected context only; write no SDD artifacts except registry if required. |40| strict TDD marker/config found | Use that value. |41| no marker/config but test runner exists | Default `strict_tdd: true`. |42| no test runner | Set `strict_tdd: false` and explain unavailable. |4344## Execution Steps45461. Inspect project files (`package.json`, `go.mod`, `pyproject.toml`, CI, lint/test config) and summarize stack/conventions.472. Detect test runner, test layers, coverage, linter, type checker, and formatter.483. Resolve Strict TDD from agent marker, `openspec/config.yaml`, detected runner fallback, or no-runner fallback.494. Initialize persistence for the resolved mode.505. Build `.atl/skill-registry.md` using the skill-registry scan rules.516. Persist testing capabilities and project context.527. Return the structured initialization envelope.5354## Output Contract5556Return `status`, `executive_summary`, `artifacts`, `next_recommended`, and `risks`. Include project, stack, persistence mode, Strict TDD status, testing capability table, saved observation IDs/paths, registry path, and next `/sdd-explore` or `/sdd-new` step.5758## References5960- [references/init-details.md](references/init-details.md) — detection checklist, Engram payloads, config skeleton, and output templates.61- `../_shared/engram-convention.md` — Engram artifact naming.62- `../_shared/openspec-convention.md` — openspec layout and rules.
JantonioFC