Claude Code · Harness Setup

Harness 3 Tầng

Ba cấp độ thiết lập cho một dự án Claude Code, kế thừa chồng lên nhau: mỗi tầng sau chứa trọn tầng trước rồi thêm phần mới.

■ thư mục ■ cam = mới thêm so với tầng trước đã scaffold thật ở level-1 / 2 / 3

Nền tảng cơ bản

Bộ não + bản đồ + vùng chứa. Đủ để Claude nhớ context và không tạo file rác.

level-1-foundation/
├── CLAUDE.md        # bạn là ai, quy tắc
├── MAP.md           # bản đồ dự án
├── contexte/        # AI học được gì
└── livrables/       # AI tạo ra gì

Harness hoàn chỉnh

Phân quyền, kỹ năng, agent, tự động hoá, tách secrets. Hệ thống làm việc đầy đủ.

level-2-harness/
├── CLAUDE.md
├── CLAUDE.local.md   # sở thích cá nhân
├── AGENTS.md         # quy tắc mọi agent
├── MAP.md
├── SPEC.md           # muốn đạt gì
├── PLAN.md           # các bước làm
├── .mcp.json         # công cụ kết nối
├── .worktreeinclude
├── .claude/
│   ├── settings.json
│   ├── settings.local.json
│   ├── rules/  skills/  agents/
│   ├── agent-memory/
│   └── workflows/  output-styles/
├── contexte/
├── sources/        # tài liệu thô
├── livrables/
├── scripts/  docs/
├── .github/workflows/
├── .env.example  .gitignore
└── README.md

Đồng bộ & đa nhiệm

Lên Git/GitHub + chạy nhiều phiên song song không đụng file nhau.

level-3-sync/
├── … (toàn bộ Tầng 2)
├── WORKTREE.md       # luật chạy song song
├── scripts/
│   └── init-git.sh   # init + push repo
├── docs/
│   └── sync-guide.md # đồng bộ 3 bước
├── .gitignore       # loại .env
└── .git/            # + private GitHub repo

Tầng 1 → Tầng 2 → Tầng 3 (kế thừa chồng lên)

Nhớ & không trùng

Đầu mỗi hội thoại đọc CLAUDE.md + MAP.md. Mỗi file tạo ra thêm 1 dòng vào MAP.md.

Secrets

Chỉ để trong .env (đã nằm trong .gitignore). Mẫu dùng .env.example. Không có file .env thật nào được tạo.

Chạy song song

Mỗi task 1 git worktree + branch riêng, 1 phiên Claude 1 worktree, gộp qua Pull Request.

Scaffold thật: ./level-1-foundation · ./level-2-harness · ./level-3-sync