Execution Role
Confirm your role before acting. You are the dedicated sdd-init sub-agent unless you loaded this skill directly through the skill() tool.
- If you are the
sdd-init sub-agent, continue with the phase work below. Do not delegate. Do not call the Skill tool.
- If you loaded this skill through the
skill() tool, you are the orchestrator. Stop here and delegate to the dedicated sdd-init sub-agent using your platform's delegation primitive (for example, task(...) or a sub-agent invocation).
Language Domain Contract
Generated technical artifacts default to English. Do not inherit the user's conversational language or the active persona's regional voice for SDD artifacts unless the user explicitly requests that artifact language or the project convention requires it.
If technical artifacts are explicitly requested in another language, use a neutral/professional register unless the user explicitly requests a different tone or regional variant.
Public/contextual comments follow the target context language by default. Explicit user language or tone overrides win; otherwise use a neutral/professional register unless the target context clearly calls for another tone or regional variant.
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. |
explicit strict_tdd: false marker/config |
Preserve strict_tdd: false. |
explicit strict_tdd: true marker/config and an explicit workspace-level test command covers every in-scope project |
Use strict_tdd: true. |
explicit strict_tdd: true marker/config without that workspace-level command |
Fail closed to strict_tdd: false and explain that downstream execution requires a workspace-wide command. |
| no marker/config, non-empty discovered project set, and an explicit workspace-level test command covers every in-scope project |
Default strict_tdd: true. |
| zero projects are discovered or no explicit workspace-level test command covers every in-scope project |
Set strict_tdd: false; preserve and report every project-local command, including missing or independent commands; those local facts do not override a workspace-level command that covers every in-scope project. Explain the no-runner or workspace-wide-command fallback. |
Execution Steps
- Identify the authoritative workspace root. Before classifying a stack or applying any no-runner fallback, discover every in-scope project root from that root using the bounded rules in
references/init-details.md.
- Inspect each discovered project for
package.json, go.mod, pyproject.toml, Cargo.toml, CI, and lint/test config; preserve its relative path and summarize its stack/conventions.
- Detect each project's test runner and command, test layers, coverage, linter, type checker, and formatter. Aggregate those project-to-tool associations in the one workspace-level result; never select one project runner for the workspace.
- Resolve Strict TDD from an agent marker or
openspec/config.yaml only after every discovered project has been evaluated. Set it to true only for a non-empty discovered project set when one explicit workspace-level test command covers every in-scope project. Preserve and report every project-local command, including missing or independent commands; those local facts do not override a workspace-level command that covers every in-scope project. Use the false fallback only when zero projects are discovered or no explicit workspace-level test command covers every in-scope project.
- 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---6
7## Execution Role
8
9Confirm your role before acting. You are the dedicated `sdd-init` sub-agent unless you loaded this skill directly through the `skill()` tool.
10
11- If you are the `sdd-init` sub-agent, continue with the phase work below. Do not delegate. Do not call the Skill tool.
12- If you loaded this skill through the `skill()` tool, you are the orchestrator. Stop here and delegate to the dedicated `sdd-init` sub-agent using your platform's delegation primitive (for example, `task(...)` or a sub-agent invocation).
13
14## Language Domain Contract
15
16Generated technical artifacts default to English. Do not inherit the user's conversational language or the active persona's regional voice for SDD artifacts unless the user explicitly requests that artifact language or the project convention requires it.
17
18If technical artifacts are explicitly requested in another language, use a neutral/professional register unless the user explicitly requests a different tone or regional variant.
19
20Public/contextual comments follow the target context language by default. Explicit user language or tone overrides win; otherwise use a neutral/professional register unless the target context clearly calls for another tone or regional variant.
21
22## Activation Contract
23
24Run 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.
25
26## Hard Rules
27
28- Detect the real stack, conventions, architecture, testing tools, and persistence mode; never guess.
29- In `engram` mode, do **not** create `openspec/`.
30- In `openspec` mode, follow `../_shared/openspec-convention.md` and write file artifacts.
31- In `hybrid` mode, write both openspec files and Engram observations.
32- Always persist testing capabilities separately as `sdd/{project}/testing-capabilities` or `openspec/config.yaml` `testing:`.
33- Always build `.atl/skill-registry.md`; also save `skill-registry` to Engram when available.
34- Use `capture_prompt: false` for automated SDD/config saves when supported; omit it if the tool schema lacks it.
35- If `openspec/` already exists, report what exists and ask before updating it.
36
37## Decision Gates
38
39| Input | Action |
40|---|---|
41| `mode=engram` | Save context and capabilities to Engram only. |
42| `mode=openspec` | Create/update openspec bootstrap files only. |
43| `mode=hybrid` | Do both Engram and openspec persistence. |
44| `mode=none` | Return detected context only; write no SDD artifacts except registry if required. |
45| explicit `strict_tdd: false` marker/config | Preserve `strict_tdd: false`. |
46| explicit `strict_tdd: true` marker/config and an explicit workspace-level test command covers every in-scope project | Use `strict_tdd: true`. |
47| explicit `strict_tdd: true` marker/config without that workspace-level command | Fail closed to `strict_tdd: false` and explain that downstream execution requires a workspace-wide command. |
48| no marker/config, non-empty discovered project set, and an explicit workspace-level test command covers every in-scope project | Default `strict_tdd: true`. |
49| zero projects are discovered or no explicit workspace-level test command covers every in-scope project | Set `strict_tdd: false`; preserve and report every project-local command, including missing or independent commands; those local facts do not override a workspace-level command that covers every in-scope project. Explain the no-runner or workspace-wide-command fallback. |
50
51## Execution Steps
52
531. Identify the authoritative workspace root. Before classifying a stack or applying any no-runner fallback, discover every in-scope project root from that root using the bounded rules in `references/init-details.md`.
542. Inspect each discovered project for `package.json`, `go.mod`, `pyproject.toml`, `Cargo.toml`, CI, and lint/test config; preserve its relative path and summarize its stack/conventions.
553. Detect each project's test runner and command, test layers, coverage, linter, type checker, and formatter. Aggregate those project-to-tool associations in the one workspace-level result; never select one project runner for the workspace.
564. Resolve Strict TDD from an agent marker or `openspec/config.yaml` only after every discovered project has been evaluated. Set it to true only for a non-empty discovered project set when one explicit workspace-level test command covers every in-scope project. Preserve and report every project-local command, including missing or independent commands; those local facts do not override a workspace-level command that covers every in-scope project. Use the false fallback only when zero projects are discovered or no explicit workspace-level test command covers every in-scope project.
575. Initialize persistence for the resolved mode.
586. Build `.atl/skill-registry.md` using the skill-registry scan rules.
597. Persist testing capabilities and project context.
608. Return the structured initialization envelope.
61
62## Output Contract
63
64Return `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.
65
66## References
67
68- [references/init-details.md](references/init-details.md) — detection checklist, Engram payloads, config skeleton, and output templates.
69- `../_shared/engram-convention.md` — Engram artifact naming.
70- `../_shared/openspec-convention.md` — openspec layout and rules.
gabrielmoreira