루트에는 리뷰 기준만 담은 CLAUDE.md(26줄)가 있었다. 꼭 지킬 경계 규칙, 지도, 검증 진입점, 맡은 일 라우터가 없었고, "서브에이전트를 병렬로"는 소유자 결정(2026-11-07)과 맞지 않았다. AGENTS.md(35줄)에 무엇인가 · 꼭 지킬 것 5 · 지도 · 맡은 일 · 검증 · 일하는 방식을 둔다. CLAUDE.md는 @AGENTS.md와 Claude 전용 줄(10줄)이다: settings·훅, 하네스 플러그인과 비대화형 설치 두 명령, 규칙·스킬· 서브에이전트 위치, 리뷰 기준이 옮겨 간 곳, 소유자 환경. 리뷰 기준과 전체 리뷰 절차는 docs/work/reference/review-criteria.md와 docs/work/improve.md 4.1절로 옮겼다. scripts/check-work-docs.py는 백엔드 검사기를 옮긴 것이다: 지도 40줄, CLAUDE.md 15줄, README 80줄, playbook 150줄, 진입 경로 350줄, 9절 뼈대, 진입 문서의 이력 ID 0, 상대 링크. 이력 패턴에 이 repo의 꼴(1105 README, P-43·O-12·D-14)을 더했다. 표준 라이브러리만 써서 노트북에서 돈다. 버린 대안: CLAUDE.md만 두기(다른 에이전트가 못 읽는다), 심볼릭 링크 (Claude 전용 줄을 둘 수 없다). 위험·한계: 지도 40줄은 자료와 백엔드에 맞춘 값이다. brief 상한 80보다 좁다. 검증: python3 scripts/check-work-docs.py rc=0, python3 -m unittest scripts/tests/test_check_work_docs.py 통과. Refs: design-docs harness/01-harness-design.md 4.3절·13절 Q1·Q2
977 B
977 B
@AGENTS.md
Claude Code에서만
- 권한·훅은
.claude/settings.json, 훅마다 하는 일과 시험은scripts/hooks/README.md다. 편집 직후 훅은 노트북 정적 검사만 하고 알리기만 한다. - 공통 훅·스킬(위험 명령 차단, 비밀 값 알림, 장부,
estimate·retro·techdebt)은 플러그인harness@claude-harness다. 비대화형(claude -p)은 자동 설치하지 않으니 이 폴더에서 한 번 돌린다:claude plugin marketplace add https://git.learn.hyeonworks.com/donghyeon.kang/claude-harness.git --scope projectclaude plugin install harness@claude-harness --scope project - 경로별 규칙은
.claude/rules/, 스킬은.claude/skills/, 서브에이전트(읽기 전용)는.claude/agents/다. - 리뷰 기준은
docs/work/reference/review-criteria.md, 절차는docs/work/improve.md4.1절이다. 세션 규칙은docs/work/delegate.md4.3절, 보고 형식은 소유자 전역 설정이다.