# AGENTS.md — {{PROJECT_NAME}}의 정본 {{PROJECT_DESCRIPTION}} 방향은 `docs/vision.md`, 풀 문제와 하지 않을 것은 `docs/problem-statement.md`다. ## 꼭 지킬 것 — 하나라도 어기면 동작해도 완료가 아니다 1. 관련 검증(아래 「검증」) 없이, 또는 돌리지 못한 이유를 밝히지 않고 완료를 말한다. 2. 요청 범위 밖의 큰 리팩터링, 사용자 변경 되돌리기, 요청 없는 파괴적 명령을 한다. 3. 비밀 값(`.env`, 키, 토큰)을 읽거나 커밋한다. 4. (채울 것: 이 프로젝트의 아키텍처 불변식. 예: 도메인 계층이 프레임워크·DB를 import한다) ## 지도 - (채울 것: 최상위 폴더 → 하는 일. 개수·버전 숫자는 적지 않는다. 정본이 따로 있으면 그 파일을 가리킨다) - 폴더마다의 규칙은 그 폴더의 `AGENTS.md`다. 작업 파일과 가장 가까운 것을 따른다. - 결정 기록은 `docs/adr/`(양식 `0000-template.md`), 예측·실측 장부는 `docs/ledger/`다. ## 맡은 일 - (채울 것: 일의 종류 → 먼저 읽을 문서. 예: 새 기능 → `docs/…`) - brief가 있으면 brief의 범위·크기·완료 기준이 먼저다. ## 검증 - 진입점은 하나다: `scripts/verify.sh <단계>`(docs · unit · pr · app). 사람·CI·에이전트가 같은 명령을 쓴다. - 무거운 실행을 다른 기계에서 돌릴 때는 `scripts/verify.sh <단계> --on <호스트>`(지금 작업 트리를 패치로 옮긴다). ## 헷갈리는 곳 - (채울 것: 코드만 보고는 알 수 없는 것. 없으면 이 절을 지운다) ## 일하는 방식 - 착수할 때 예측을, 끝날 때 실측을 장부에 남긴다(Claude Code는 `estimate` 스킬). - 파일을 바꾸는 위임은 사람이 열어 보고 멈출 수 있는 하위 세션에, 결과만 받는 일(검색·구조 리뷰·실행 검증)은 서브에이전트에 맡긴다. - 여러 분야에 걸친 일은 리드(메인 세션)가 분야 지식을 골라 새 눈 리뷰어에게 맡기고 합친다. 명단·경로표·넘김·충돌 규칙은 `docs/work/experts.md`다(Claude Code는 `lead` 스킬). - 커밋 메시지·PR 규칙: (채울 것: 규칙 문서 경로)