Sdd Context

---
name: sdd-context
description: Pha 0 SDD — khám phá ngữ cảnh và tạo .sdd/features/{feature-slug}/CONTEXT.md
user-invocable: true
---

# SDD Phase 0 — Context Discovery (`/sdd-context`)

**Output language:** All output mirrors the language of the invoking prompt. Vietnamese prompt → Vietnamese output; English prompt → English output. Canonical tokens (`PENDING HUMAN REVIEW`, `PENDING`, `APPROVED`), file paths, and CLI commands are language-invariant.

Dùng khi bắt đầu feature để làm rõ bài toán nghiệp vụ và tạo `CONTEXT.md`.

## Tham số

- `--feature=<feature-slug>`: Feature identifier kebab-case, ví dụ `feat-001-order-checkout`.

> **Cập nhật CONTEXT.md đã approved?** Dùng `/sdd-update --artifact=context --reason="..."` thay vì chạy lại skill này. `/sdd-context` dùng để tạo Context lần đầu hoặc làm lại khi yêu cầu thay đổi hoàn toàn.

## Shared methodology contract

Đọc [AI Review Protocol](../_shared/ai-review-protocol.md) trước khi tạo artifact. `CONTEXT.md` mới phải dùng `Intent Packet` và `Methodology Profile` trong protocol. Intent giữ technology-neutral; solution kỹ thuật chỉ được ghi như question, constraint hoặc decision đã approved, không phải requirement mặc định.

## Architecture Profile preflight

Tuân thủ [Architecture Profile Protocol](../_shared/architecture-profile-protocol.md).

- Đọc profile và governance bắt buộc.
- `CONTEXT.md` được tạo với core-only baseline; không chọn HTTP framework, DB, ORM, validation library hoặc test command.
- Ghi profile version, baseline, evidence và chỉ unknown liên quan feature.
- Evidence mâu thuẫn profile thì dừng và tạo `PENDING HUMAN REVIEW` recommendation.

## Các bước

1. Tạo `.sdd/features/{feature-slug}/CONTEXT.md`.
2. Ghi `## Intent Packet`: `WHAT`, `WHY`, `Definition of Done`, boundaries, exclusions và decision owner.
3. Thu thập problem, user pain và desired behavior; chưa thiết kế giải pháp kỹ thuật.
4. Lập domain glossary, entity/state và business rule.
5. Xác định stakeholder, decision maker, business constraint và open question.
6. Ghi `## Methodology Profile` với depth, rationale, risk posture, high-risk review route và unresolved-decision owner.
7. Gán disposition cho từng open question material: resolved, approved assumption, deferred hoặc blocking decision. Nếu intent bị trộn với solution, hoặc question material chưa có disposition, dừng trước `/sdd-spec`.
8. Kiểm tra DoD, ghi artifact và cập nhật `.sdd/README.md`.

## DoD

- [ ] `Intent Packet` nêu observable WHAT, WHY, Definition of Done, boundary/exclusion và decision owner.
- [ ] Team/Developer hiểu problem, không nhầm với solution.
- [ ] Domain glossary rõ nghĩa.
- [ ] Tech, business và time constraint đã ghi.
- [ ] Có decision maker rõ ràng.
- [ ] Methodology Profile có depth, rationale, risk posture và review route khi high-risk.
- [ ] Open question quan trọng đã trả lời, có approved assumption, deferred rõ ràng hoặc được đánh dấu blocking.
- [ ] Không chuyển sang Spec khi intent lẫn solution hoặc có material question chưa disposition.

## AI Recommendation và Human Final Review

Sau khi tạo/sửa `CONTEXT.md`, lưu canonical recommendation trong artifact, gồm Intent Packet, business question, assumption, stakeholder, constraint, exclusion, Methodology Profile và alternative. Giữ `Human Final Review.Status: PENDING`. Chỉ chuyển sang `/sdd-spec` sau `APPROVED` có decision, reviewer và timestamp. Agent phải dừng, không self-approve.