AGENTS.md · CLAUDE.md 실전

AGENTS.md · CLAUDE.md 실전

레포 루트 한 파일이 시스템 프롬프트가 된다.

가장 저렴한 하네스 — 프로젝트 루트에 규칙 파일을 두는 것입니다.

파일 역할

• AGENTS.md / CLAUDE.md — 아키텍처·컨벤션·금지
• docs/ — 깊은 설계 (에이전트는 필요 시 읽기)
• Skills — 재사용 워크플로 (Cursor 등)

잘 쓰는 법

• 시작 전 읽을 곳 — 3~5개 링크만
• Anti-pattern — “루트 레이아웃에서 pathname 분기 X”
• 체크리스트 — 새 카드·도구 추가 시 14파일 갱신
• 짧게 — 500줄 넘으면 분할

CAR 프레임워크 와 연결

• Control — CLAUDE.md, 린터, 테스트
• Agency — MCP, 서브에이전트
• Runtime — Hooks, 재시도, 체크포인트

규칙 파일은 living document — 코드 변경 시 함께 갱신하지 않으면 entropy가 쌓입니다.

Pre-tool / Post-tool hooks — 도구 호출 전후에 포맷·검사·알림을 실행. Cursor hooks, Claude Code hooks 등이 Runtime 하네스에 해당합니다.

"AGENTS.md는 README가 아니라, 에이전트용 운영 매뉴얼이다."

이번 호 키워드

· AGENTS.md
· CLAUDE.md
· Hooks
· CAR