# Claude Md

Tạo hoặc cập nhật các file CLAUDE.md theo các thực hành tốt nhất để onboarding tác nhân...

- Repository: https://github.com/luongnv89/claude-howto (46363 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add luongnv89/claude-howto --skill claude-md -g -a claude-code -y`
Codex: `npx skills add luongnv89/claude-howto --skill claude-md -g -a codex -y`
Cursor: `npx skills add luongnv89/claude-howto --skill claude-md -g -a cursor -y`
Gemini CLI: `npx skills add luongnv89/claude-howto --skill claude-md -g -a gemini-cli -y`

## Description

Tạo hoặc cập nhật các file CLAUDE.md theo các thực hành tốt nhất để onboarding tác nhân AI tối ưu

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Đầu Vào Người Dùng

```text
$ARGUMENTS
```

Bạn **BẮT BUỘC** phải xem xét đầu vào của người dùng trước khi tiếp tục (nếu không trống). Người dùng có thể chỉ định:
- `create` - Tạo CLAUDE.md mới từ đầu
- `update` - Cải thiện CLAUDE.md hiện có
- `audit` - Phân tích và báo cáo về chất lượng CLAUDE.md hiện tại
- Một đường dẫn cụ thể để tạo/cập nhật (ví dụ: `src/api/CLAUDE.md` cho hướng dẫn cụ thể thư mục)

## Nguyên Tắc Cốt Lõi

**LLMs là không trạng thái**: CLAUDE.md là file dự án chính được tải vào mọi cuộc hội thoại (cùng với auto memory và các rules không giới hạn phạm vi). Nó phục vụ như tài liệu onboarding chính cho các tác nhân AI vào codebase của bạn.

### Các Quy Tắc Vàng

1. **Less is More**: Các LLM biên giới có thể theo ~150-200 hướng dẫn. System prompt của Claude Code đã sử dụng ~50. Giữ CLAUDE.md của bạn tập trung và ngắn gọn.

2. **Ứng Dụng Phổ Biến**: Chỉ bao gồm thông tin liên quan đến MỌI phiên. Hướng dẫn cụ thể theo tác vụ thuộc về các file riêng.

3. **Đừng Sử Dụng Claude như Linter**: Hướng dẫn phong cách làm phình bối cảnh và làm giảm khả năng tuân theo hướng dẫn. Sử dụng các công cụ xác định (prettier, eslint, v.v.) thay thế.

4. **Không Bao Giờ Tự Động Tạo**: CLAUDE.md là điểm đòn bẩy cao nhất của hệ thống AI. Tạo nó thủ công với sự xem xét cẩn thận.

## Quy Trình Thực Thi

### 1. Phân Tích Dự Án

Đầu tiên, phân tích trạng thái dự án hiện tại:

1. Kiểm tra các file CLAUDE.md hiện có:
   - Cấp root: `./CLAUDE.md` hoặc `.claude/CLAUDE.md`
   - Cụ thể thư mục: `**/CLAUDE.md`
   - Cấu hình người dùng toàn cầu: `~/.claude/CLAUDE.md`

2. Xác định cấu trúc dự án:
   - Technology stack (ngôn ngữ, frameworks)
   - Loại dự án (monorepo, ứng dụng đơn, library)
   - Công cụ phát triển (quản lý package, hệ thống build, trình chạy test)

3. Xem lại tài liệu hiện có:
   - README.md
   - CONTRIBUTING.md
   - package.json, pyproject.toml, Cargo.toml, v.v.

### 2. Chiến Lược Nội Dung (WHAT, WHY, HOW)

Cấu trúc CLAUDE.md xung quanh ba chiều:

The rest: https://github.com/luongnv89/claude-howto/blob/HEAD/vi/03-skills/claude-md/SKILL.md