git:20260831.c10e62e to git:20260906.b53a8e9

9 added, 6 removed. Audit A to A.

---

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.

+ Đọ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`, `Describe-back record` 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`.

+ 6. Ghi `## Methodology Profile` với depth `SKIP | SKETCH | DETAILED | FORMAL`, rationale, risk posture, high-risk review route và unresolved-decision owner. Depth là recommendation, không bỏ gate.

+ 7. Gán disposition cho từng open question material: resolved, approved assumption, deferred hoặc blocking decision.

+ 8. Ghi `## Describe-back record`: Agent diễn giải lại WHAT, WHY, DoD, boundaries/exclusions, assumptions/unknowns và material-question disposition; đối chiếu với Intent Packet, glossary và constraints.

+ 9. Nếu intent bị trộn với solution, material question chưa disposition, describe-back mâu thuẫn evidence, hoặc Agent tự thêm technology/solution không có evidence, dừng trước `/sdd-spec`.

+ 10. 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.

+ - [ ] Describe-back record khớp Intent Packet, glossary và constraints; assumption/unknown có impact và disposition.

+ - [ ] Không chuyển sang Spec khi intent lẫn solution, có material question chưa disposition hoặc describe-back mâu thuẫn.

## 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.

+ Sau khi tạo/sửa `CONTEXT.md`, lưu canonical recommendation trong artifact, gồm Intent Packet, Describe-back record, 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.