# Guardrails - Ranh giới bắt buộc của Claukit

## 1. Không bịa nguồn gốc

- Không tuyên bố GitHub có upstream skill `claukit` độc lập nếu thực tế chỉ có ecosystem `ClaudeKit Skills`.
- Khi cần nêu source, dùng repo công khai: `https://github.com/mrgoonie/claudekit-skills`.

## 2. Không context bloat

- Không đọc toàn bộ catalog skill nếu chỉ cần 1-3 skill.
- Không mở toàn bộ references của một skill nếu chưa có nhu cầu cụ thể.
- Không biến Claukit thành “super prompt” thay cho skill chuyên biệt.

## 3. Bắt buộc đọc skill được chọn

- Nếu Claukit điều phối đến skill khác, phải đọc `SKILL.md` của skill đó trước khi hành động.
- Nếu skill đó dẫn đến references/scripts, chỉ mở phần cần thiết cho task.

## 4. User instructions thắng workflow mặc định

- User yêu cầu cụ thể luôn có độ ưu tiên cao hơn style guide mặc định.
- Khi có mâu thuẫn, giải thích ngắn gọn và làm theo yêu cầu của user nếu an toàn.

## 5. Verification trước completion

- Không được báo “xong”, “đã fix”, “đã pass” nếu chưa có xác minh tương ứng.
- Với coding task: ít nhất phải nêu rõ đã chạy hay chưa chạy test/build/lint/command liên quan.

## 6. Security và safety

- Không để lộ secrets/API keys/credentials.
- Dùng `.env` hoặc secret store phù hợp.
- Không đề xuất command phá hủy hoặc thay đổi diện rộng nếu chưa xác nhận rõ target.

## 7. Quality bar theo ngữ cảnh

- UI task: đòi hỏi hierarchy rõ, responsive, không placeholder giả.
- Backend task: đòi hỏi correctness, validation, idempotency khi phù hợp.
- Debug task: bắt buộc truy nguyên nhân gốc trước khi sửa.

---
*Nếu vi phạm một guardrail, Claukit phải dừng lại và chỉnh lại workflow trước khi tiếp tục.*

# Integration Hints - Skill chaining theo ClaudeKit style

## Chain chuẩn cho feature delivery

`claukit -> brainstorming -> writing-plans -> subagent-driven-development hoặc executing-plans -> code-review -> verification-before-completion`

Dùng khi:
- bắt đầu feature mới
- có nhiều bước phân tích, code, review
- cần workflow chặt và nhất quán

## Chain cho debugging

`claukit -> systematic-debugging -> root-cause-tracing hoặc defense-in-depth -> verification-before-completion`

Dùng khi:
- có bug khó
- test flake
- hành vi lệch nhưng chưa rõ nguyên nhân

## Chain cho UI/UX

`claukit -> frontend-design -> aesthetic -> ui-styling -> chrome-devtools`

Dùng khi:
- build landing page, dashboard, component library
- cần visual polish hoặc interaction quality
- cần kiểm tra giao diện bằng browser tooling

## Chain cho backend/platform

`claukit -> backend-development -> databases -> better-auth -> devops`

Dùng khi:
- thiết kế API/backend service
- thêm auth, data model, deployment concerns
- cần giữ consistency giữa domain logic và infra

## Chain cho research/docs

`claukit -> docs-seeker -> repomix -> mermaidjs-v11`

Dùng khi:
- cần đọc docs mới nhất
- cần phân tích repo bên ngoài
- cần biến findings thành sơ đồ hoặc tài liệu

## Mapping theo nhóm skill local

| Nhóm nhu cầu | Skill local nên ưu tiên |
| :--- | :--- |
| Orchestration | `brainstorming`, `writing-plans`, `subagent-driven-development`, `executing-plans` |
| Quality gates | `code-review`, `systematic-debugging`, `verification-before-completion` |
| Frontend | `frontend-design`, `aesthetic`, `ui-styling`, `web-frameworks` |
| Backend | `backend-development`, `databases`, `better-auth`, `devops` |
| Research & tooling | `docs-seeker`, `repomix`, `chrome-devtools`, `mcp-management` |
| Advanced reasoning | `sequential-thinking`, `problem-solving/*` |

## Gợi ý chọn skill

- Chọn chain ngắn nhất giải được task.
- Nếu task chỉ là debug, đừng kéo cả planning chain vào.
- Nếu task chỉ là design review, đừng gọi backend skill.
- Nếu task đã ở giữa một workflow superpowers, Claukit nên bổ trợ chứ không reset lại toàn bộ flow.

---
*Claukit hiệu quả nhất khi nó chọn đúng chain, không phải chain dài nhất.*

# Mission Briefs - Chiến lược Vận hành Claukit

Tài liệu này cập nhật `claukit` local theo tinh thần của `mrgoonie/claudekit-skills`: dùng skill chuyên biệt, progressive disclosure và workflow kỷ luật thay vì dồn mọi thứ vào một prompt lớn.

## Mục tiêu cốt lõi

### 1. Skill-first orchestration
- Mỗi task phải đi qua skill phù hợp nhất, không giải quyết tất cả bằng meta-prompt.
- `claukit` chỉ điều phối và chọn workflow; implementation vẫn thuộc về domain skill.

### 2. Progressive disclosure
- Chỉ tải `SKILL.md`, references và scripts thực sự cần cho task.
- Tránh context bloat bằng cách không đọc cả catalog skill hoặc cả repo nếu chưa cần.

### 3. User intent first
- User instructions có độ ưu tiên cao nhất.
- Nếu workflow mặc định của Claukit mâu thuẫn với yêu cầu cụ thể của user, theo user.

### 4. Verification over claims
- Không claim đã xong, đã fix, đã pass nếu chưa có bằng chứng chạy thật.
- Khi có build/test/lint/CLI liên quan, verification là bắt buộc.

### 5. Cross-skill consistency
- Các skill được chain phải có cùng mục tiêu, cùng tiêu chuẩn naming, cùng quality bar.
- Khi handoff giữa skills hoặc subagents, cần giữ rõ assumptions, file ownership, verification criteria.

### 6. Local-first compatibility
- Ưu tiên dùng các skill đã được cài local cho Codex/Gemini thay vì sao chép nguyên văn hướng dẫn chỉ dành cho Claude Code.
- Dùng repo GitHub ClaudeKit làm nguồn tham chiếu công khai, nhưng ánh xạ vào toolchain local hiện tại.

## Hệ quả thực thi

- Task UI-heavy: ưu tiên chất lượng thị giác nhưng vẫn theo guardrails của dự án.
- Task backend/debugging: ưu tiên correctness, traceability và validation.
- Task lớn: phải tách thành workflow rõ ràng thay vì kích hoạt hàng loạt skill cùng lúc.

---
*Mission brief của Claukit là: đúng skill, đúng thứ tự, đúng bằng chứng.*

# Skills Directory - Danh mục rút gọn dùng với Claukit

Tài liệu này không cố liệt kê mọi skill trong hệ thống. Nó chỉ gom các skill local có giá trị nhất khi `claukit` cần điều phối workflow.

## Cách dùng

1. Xác định task thuộc nhóm nào.
2. Chọn 1 meta/process skill và 1-2 domain skill.
3. Đọc `SKILL.md` của các skill đó trước khi tiếp tục.
4. Chỉ mở references sâu hơn khi task cần.

## 1. Orchestration & delivery

| Skill | Khi nào dùng | Path |
| :--- | :--- | :--- |
| `claukit` | Điều phối workflow nhiều skill, bám theo ClaudeKit style | `claukit/SKILL.md` |
| `brainstorming` | Làm rõ yêu cầu, thiết kế trước khi code | `superpowers-core/brainstorming/SKILL.md` |
| `writing-plans` | Viết implementation plan chi tiết | `superpowers-core/writing-plans/SKILL.md` |
| `subagent-driven-development` | Thực thi plan bằng nhiều worker/review gate | `superpowers-core/subagent-driven-development/SKILL.md` |
| `executing-plans` | Chạy plan theo batch/checkpoint | `superpowers-core/executing-plans/SKILL.md` |
| `using-git-worktrees` | Tách môi trường làm việc an toàn | `superpowers-core/using-git-worktrees/SKILL.md` |

## 2. Quality & debugging

| Skill | Khi nào dùng | Path |
| :--- | :--- | :--- |
| `code-review` | Review kỹ thuật, nhận hoặc yêu cầu review | `code-review/SKILL.md` |
| `systematic-debugging` | Debug theo quy trình, không nhảy vào sửa ngay | `superpowers-core/systematic-debugging/SKILL.md` |
| `verification-before-completion` | Gate cuối trước khi claim hoàn tất | `superpowers-core/verification-before-completion/SKILL.md` |
| `root-cause-tracing` | Truy nguyên nhân gốc | `debugging/root-cause-tracing/SKILL.md` |
| `defense-in-depth` | Chặn bug ở nhiều lớp | `debugging/defense-in-depth/SKILL.md` |

## 3. Product & application skills

| Skill | Khi nào dùng | Path |
| :--- | :--- | :--- |
| `frontend-design` | UI/UX khác biệt, component/page production-grade | `frontend-design/SKILL.md` |
| `aesthetic` | Nâng quality thị giác và micro-interactions | `aesthetic/SKILL.md` |
| `ui-styling` | Tailwind, shadcn/ui, design system | `ui-styling/SKILL.md` |
| `web-frameworks` | Next.js, full-stack web app structure | `web-frameworks/SKILL.md` |
| `backend-development` | API, services, security, performance | `backend-development/SKILL.md` |
| `databases` | Schema/query/index/ops cho PostgreSQL và MongoDB | `databases/SKILL.md` |
| `better-auth` | Auth/authz flow | `better-auth/SKILL.md` |
| `devops` | Deploy, infra, containers, cloud | `devops/SKILL.md` |

## 4. Research, docs, and tooling

| Skill | Khi nào dùng | Path |
| :--- | :--- | :--- |
| `docs-seeker` | Tìm docs mới nhất và source chính thống | `docs-seeker/SKILL.md` |
| `repomix` | Đóng gói repo để phân tích | `repomix/SKILL.md` |
| `chrome-devtools` | Browser automation, perf, snapshots | `chrome-devtools/SKILL.md` |
| `mcp-management` | Tìm và dùng MCP tools/resources đúng cách | `mcp-management/SKILL.md` |
| `mermaidjs-v11` | Vẽ sơ đồ, flow, architecture docs | `mermaidjs-v11/SKILL.md` |

## 5. Advanced reasoning

| Skill | Khi nào dùng | Path |
| :--- | :--- | :--- |
| `sequential-thinking` | Bài toán nhiều bước, scope chưa rõ | `sequential-thinking/SKILL.md` |
| `problem-solving/*` | Cần đổi góc nhìn hoặc phá bế tắc | `problem-solving/ABOUT.md` |
| `context-engineering` | Tối ưu context và multi-agent flows | `context-engineering/SKILL.md` |

## Public source reference

- GitHub ecosystem reference: `https://github.com/mrgoonie/claudekit-skills`
- Local root: `C:\Users\Admin\.gemini\antigravity\skills\`

---
*Claukit nên chọn ít skill nhưng đúng skill. Đó là điểm khác biệt giữa orchestration và context spam.*