explanatory-output-style

Bộ cấu hình Global cho Claude Code (~/.claude/)

Tổng hợp từ tài liệu chính thức Anthropic (code.claude.com, platform.claude.com), Engineering Blog, blog claude.com, MindStudio, ClaudeFast, và best practices cộng đồng GitHub. Áp dụng MỌI project. Tối ưu cho dev người Việt — tiếng Việt cho comment/log/commit, tiếng Anh chuẩn convention cho identifier.

👉 Lần đầu xem repo? Đọc INTRODUCTION.md cho overview ngắn 1 phút.

📅 Đã verify: 2026-05-16 vs Claude Code v2.1.142 + Opus 4.7. Model ID, version-gating, env var, slash command, hook event đã cross-check với docs Anthropic + raw CHANGELOG.

⚠️ Một số nội dung có thể outdated khi Anthropic ship version mới hoặc deprecate model. Phát hiện sai sót → submit issue/PR tại github.com/MinhThang1009/dotclaude/issues. Xem CONTRIBUTING.md cho quy trình. Lịch sử thay đổi: CHANGELOG.md.

1. Cấu trúc ~/.claude/ sau khi cài

Repo source có thêm docs/, .github/, scripts/, tests/, requirements-test.txt, .gitattributes, LICENSE, CHANGELOG.md cho GitHub browsing + CI — KHÔNG copy vào ~/.claude/ (xem Bước 3).

~/.claude/
├── CLAUDE.md                       # Hướng dẫn global (load mọi session, ~79 dòng)
├── settings.json                   # Quyền, hooks, env vars
├── rules/
│   ├── communication.md            # ✅ Auto-import (essential mỗi turn)
│   ├── security.md                 # ✅ Auto-import (essential mọi task)
│   ├── verification.md             # ✅ Auto-import (verify & avoid past mistakes)
│   ├── coding-standards.md         # ✅ Auto-import (coding conventions)
│   ├── git-workflow.md             # ✅ Auto-import (git workflow)
│   └── plan-workflow.md            # ✅ Auto-import (8 principles for any implementation plan)
├── plugins/                        # 36 plugins (mỗi plugin có agents/ và/hoặc skills/ bên trong)
│   ├── pr-review-toolkit/          # PR review: code-reviewer, silent-failure-hunter, type-design-analyzer...
│   │   ├── .claude-plugin/
│   │   ├── agents/                 # code-reviewer.md, code-simplifier.md, comment-analyzer.md...
│   │   └── skills/                 # code-review/, full-review/, review-pr/
│   ├── feature-dev/                # Phát triển tính năng: code-architect, code-explorer
│   │   ├── .claude-plugin/
│   │   ├── agents/
│   │   └── skills/                 # explain/, feature-dev/
│   ├── commit-commands/            # Git workflow: commit, commit-push-pr, clean-gone
│   │   ├── .claude-plugin/
│   │   └── skills/
│   ├── debug/                      # Debug: debugger agent + /debug skill
│   ├── documentation/              # Docs: documentation-engineer, nextjs-developer
│   ├── test-toolkit/               # Test: test-writer, test-analyzer
│   ├── security-guidance/          # Security: security-auditor (OWASP)
│   ├── performance/                # Perf: performance-engineer, dependency-manager
│   ├── code-modernization/         # Architecture review: architecture-critic
│   ├── code-simplifier/            # Refactor: /refactor skill
│   ├── hookify/                    # Tạo hooks: conversation-analyzer + /hookify skill
│   ├── frontend-design/            # UI: /frontend-design skill
│   ├── session/                    # Session: /context-check, /handoff
│   ├── claude-md-management/       # Audit CLAUDE.md: /claude-md-management skill
│   └── plugin-dev/                 # Phát triển plugin: 7 skills (agent/skill/hook/mcp/command/structure/settings)