sdd-init git:20260906.b53a8e9A

Immutable. This exact content is served forever at /api/v1/blob/3508bab2de5599c0.

---
name: sdd-init
description: Khởi tạo template SDD + ADD, Architecture Profile, governance và cấu trúc dự án
user-invocable: true
---

# SDD Initializer (`/sdd-init`)

Dùng cho greenfield hoặc bootstrap SDD+ADD trong repository hiện có.

## Parameters

- `--project-name=<name>`: Optional.
- `--stack=<tech-stack>`: Optional; only explicit known bindings.
- `--project-ownership=solo|team`: Optional Human governance setting; default `team`.
- `--agent-execution=direct|orchestrated`: Optional execution setting; default `orchestrated`.
- `--team-size=solo|team`: Deprecated composite alias for one transition release. `solo` maps to `solo/direct`; `team` maps to `team/orchestrated`. Emit a migration warning.

`solo` means one Human project owner; `team` means multiple Human collaborators. `direct` executes in the current Agent session; `orchestrated` allows `/sdd-dispatch` to coordinate one or more workers. The axes are independent.

Reject `--team-size` when combined with `--project-ownership` or `--agent-execution`. When canonical shared-context headers already exist, reject `--team-size`; the alias is valid only while both headers are absent. A deprecated alias may set only its documented composite pair; a canonical flag selects only its own axis.

## Baseline and Architecture Profile

1. Create `.sdd/architecture-profile.md` as canonical artifact-generation source.
2. Parse `--stack` only into explicit bindings; do not infer framework, ORM, validation or commands.
3. Without `--stack`, seed TypeScript + Node.js + Clean Architecture core-only.
4. Record evidence, unresolved binding and canonical `PENDING HUMAN REVIEW` recommendation in the profile.
5. Context/Spec may be business-neutral; Plan/Tasks/execution block until relevant binding and exact command are approved.
6. Methodology Profile sets depth/risk/review route only; it does not replace the Architecture Profile gate.

## Output

1. Create `.sdd/features/`, `.sdd/reviews/`, `.sdd/rfcs/`, `.claude/skills/`, `docs/`, `scripts/`, `src/{domain,usecase,interface,infra,shared}/` and `tests/` within template scope.
2. Generate `AGENTS.md`, `CLAUDE.md`, `.agentignore` and `.gitignore` from repository/stack evidence; do not copy manifest-specific rules or commands without evidence.
3. Initialize `.sdd/README.md`, Architecture Profile, shared context, MCP policy and constraints. Shared context contains `# Project Ownership: <solo|team>` and `# Agent Execution: <direct|orchestrated>`.
4. Install template-owned documentation and support scripts.
5. Create `.sdd/reviews/init.md` with canonical recommendation; Human reviews bootstrap scope before feature work.

## Governance

- `AGENTS.md` retains its eight canonical sections.
- `CLAUDE.md` mirrors approved architecture and durable project guidance; it does not choose stack.
- `.agentignore` and `.gitignore` use observed patterns and protect secret files.
- `CONSTITUTION.md` Layer 1/2 changes require approved RFC.
- `Project Ownership: solo` allows the sole Human owner to persist Human Final Review; `team` allows an authorized Human collaborator. Agents never self-approve.
- `Agent Execution: direct` retains Intent Packet, Methodology Profile, Feature Lock, Shadow Plan, Action Record, Architecture Profile, material checkpoint and validation. `orchestrated` adds bounded worker dispatch; it does not reduce or replace the same gates.
- Solo delivery removes PR overhead only. Agent never `git push`; Human handles remote delivery after validation and commit.

## AI Recommendation and Human Final Review

Use `.claude/skills/_shared/ai-review-protocol.md`. Recommendation includes bootstrap scope, profile evidence/unknowns, methodology defaults, selected ownership/execution settings, migration warning if applicable, missing decisions and next command. Human Final Review remains `PENDING` until a human records a durable decision.