# build-system kit — manifest (mục lục raw)

Bộ khởi động để một session Claude Code tự dựng một đội AI (architect · backend · frontend ·
tester) và build app end-to-end trong vòng lặp sprint tự trị. Đây là kênh RAW: mỗi file dưới
đây là nguyên văn, fetch trực tiếp được.

## Cách dùng (agent đọc trước khi kéo file)

1. Fetch `manifest.md` này TRƯỚC — nó là bản đồ; kéo file theo thứ tự dưới.
2. Thứ tự dựng: `00-kickoff.md` → `CLAUDE.template.md` → `agents/*` → `settings.template.json` → `templates/*`.
3. Đặt file vào đúng đường dẫn đích trong project: `CLAUDE.template.md` → `CLAUDE.md`; `agents/*` → `.claude/agents/*`; `settings.template.json` → `.claude/settings.json`. Điền các slot `{{...}}` theo `00-kickoff.md`. Path tuyệt đối trong template là con-trỏ generic — resolve về repo thật khi setup (Luật path, `00-kickoff.md §1.2`).
4. **`templates/*` và `phuong-phap/*` là TÀI LIỆU THAM CHIẾU — KHÔNG copy vào project.** Templates: agent setup/architect ĐỌC để viết SPEC/DISPATCH/plan_sprint theo khung. Phương pháp: đọc khi cần theo con trỏ trong CLAUDE.md (ngoại lệ duy nhất: `phuong-phap/TOOL-DESIGN.md` copy vào project KHI slot 5 = agent-first).
5. Không có bộ docs local trên máy → resolve mọi con trỏ `docs/...` trong template về URL kit này (verify từng URL 200 trước khi ghi vào CLAUDE.md §1).
6. **Fetch RAW bằng HTTP client (`curl`), ĐỪNG dùng tool tóm-tắt-trang** — setup cần nguyên văn từng path/lệnh, bản tóm tắt là vô dụng. Con trỏ nào kéo không được → probe 2-3 URL candidate rồi mới kết luận thiếu (kết luận bằng mã 404 thật, không bằng cảm giác).

## Files

- `00-kickoff.md` — quy trình bootstrap 2 bước (scaffold → discuss-chốt), bảng BẢN CHẤT, 7 slot, bảng phân công — /kit/00-kickoff.md
- `CLAUDE.template.md` — template luật xuyên suốt của vòng lặp (điền `{{SLOT}}`) → đặt thành `CLAUDE.md` của project — /kit/CLAUDE.template.md
- `agents/architect.md` — playbook + định nghĩa agent: sprint engine, kickoff, dispatch, review, gates, người commit duy nhất — /kit/agents/architect.md
- `agents/backend.md` — playbook backend: implement server/API/data-layer theo dispatch, verify trước khi claim — /kit/agents/backend.md
- `agents/frontend.md` — playbook frontend: port mock đã duyệt, tự-verify bằng browser — /kit/agents/frontend.md
- `agents/tester.md` — playbook tester: verify độc lập (author ≠ checker), suite 100% → API → UI — /kit/agents/tester.md
- `settings.template.json` — deny cơ khí (git phá huỷ, rm, AskUserQuestion) → đặt thành `.claude/settings.json` — /kit/settings.template.json
- `templates/SPEC.template.md` — template đặc tả sản phẩm (CÁI GÌ + TẠI SAO), contract viết ở thì hoàn thành — /kit/templates/SPEC.template.md
- `templates/ARCHITECTURE.template.md` — template kiến trúc kỹ thuật (BẰNG GÌ), điểm mở rộng registry/module — /kit/templates/ARCHITECTURE.template.md
- `templates/DISPATCH.template.md` — template backlog giao việc cho team-lead, mỗi task Intent + Defensive + Gate máy-kiểm-được — /kit/templates/DISPATCH.template.md
- `templates/sprints/plan_sprint.template.md` — template plan một sprint (edit-in-place ở kickoff) — /kit/templates/sprints/plan_sprint.template.md
- `templates/sprints/end_sprint.template.md` — template receipt đóng sprint (bằng chứng verify chạy độc lập) — /kit/templates/sprints/end_sprint.template.md

## Phương pháp luận (tham chiếu — đọc khi cần, không copy vào project)

- `phuong-phap/PRINCIPLES.md` — 4 bộ luật nền universal: tự-quyết-default, never-free, Rule#0 — /kit/phuong-phap/PRINCIPLES.md
- `phuong-phap/DIAGNOSIS.md` — kẹt / fail lạ / verdict mâu thuẫn → sửa tầng nào (env/gate ≥ tool > code) — /kit/phuong-phap/DIAGNOSIS.md
- `phuong-phap/WRITING-RULES.md` — 7 luật viết CLAUDE.md/dispatch/playbook cho model đọc được — /kit/phuong-phap/WRITING-RULES.md
- `phuong-phap/TOOL-DESIGN.md` — thiết kế MCP tool cho agent: 10 trụ + ship-checklist (copy vào project khi agent-first) — /kit/phuong-phap/TOOL-DESIGN.md
- `phuong-phap/THEORY.md` — vì sao hệ work: pattern, lỗi tương quan, ước lượng thời gian — /kit/phuong-phap/THEORY.md
- `phuong-phap/GENEALOGY.md` — pain gốc của từng luật; muốn bỏ/sửa luật nào đọc đây trước — /kit/phuong-phap/GENEALOGY.md

## System — SDK patterns build nhanh (catalog từ 3 codebase production)

- `system/README.md` — bản đồ mảng system + cách dùng lúc thi — /kit/system/README.md
- `system/01-sdk-vong-doi.md` — vòng đời agent SDK: options cheat-sheet, stream dispatch, timeout, kill, gotcha disallowed_tools — /kit/system/01-sdk-vong-doi.md
- `system/02-session-resume.md` — cụm kill-resume 4 mảnh, ResultMessage.session_id, chẩn resume-bloat, context-injection — /kit/system/02-session-resume.md
- `system/03-provider-mock.md` — multi-provider env-mux, credential, mock-LLM fixture + fault-injection (dev không đốt tiền) — /kit/system/03-provider-mock.md
- `system/04-mcp-tools-multi-agent.md` — @tool in-process, structured-output-qua-tool-call, registry, handoff, DB job-queue + crash recovery — /kit/system/04-mcp-tools-multi-agent.md
- `system/05-hooks-guards.md` — 4 mode return hook, 3 hook mẫu, chống FP-loop, guards anti-hallucination + hướng-fail — /kit/system/05-hooks-guards.md
- `system/06-streaming-obs-bai-hoc.md` — SSE Redis, tracing, verified-generation, experience-wiki, 12 BÀI HỌC ĐẮT — /kit/system/06-streaming-obs-bai-hoc.md