AGENTS.md 템플릿

에이전트가 매번 처음 읽는 파일입니다. 길게 쓰기보다 경계와 검증 방법을 분명히 씁니다. Claude Code 를 쓰면 같은 내용을 CLAUDE.md 에 두거나 CLAUDE.md 에서 이 파일을 가리킵니다.

# AGENTS.md

## 이 저장소
<한 문단: 무엇을 만드는 저장소인지, 누가 쓰는지>

사람은 역할로 부른다: 「개발자」(하네스 · 인프라), 「기획자」(요청 · 승인).

## 정본
- 디자인 시스템 규칙: docs/system/ — 컴포넌트 표에 없는 부품은 없는 것이다
- 결정과 위험: docs/decisions.md
- 이 파일과 문서가 어긋나면 문서를 고치는 PR 을 먼저 올린다

## 브랜치와 PR
- feature/* → PR → dev (squash) → 통합 확인 → main
- 에이전트는 main 에 push 하지 않는다. dev 머지는 <러너 | 개발자>가 한다
- 운영 배포는 사람이 GitHub 릴리스를 발행할 때만 일어난다

## 검증 명령
| 바꾼 곳 | 돌릴 것 |
|---|---|
| 화면 | pnpm --filter <화면 앱> build && pnpm --filter <화면 앱> test |
| 패키지 | pnpm --filter @yuyu/ui test && pnpm docs:drift |
| 전체 | pnpm check |

## 안전 경계
1. 막힌 명령은 꼴을 바꿔 다시 시도하지 않는다. 막히면 멈추고 보고한다.
2. 비밀값(.env*, 자격 증명, 비밀 저장소)을 읽지 않는다.
3. 인프라에 쓰지 않는다. plan 요약과 변경 기록 초안까지만 한다.
4. 커밋하지 않은 변경이 있으면 시작하지 않는다. 한 작업 트리에 세션 하나.
5. stash · reset --hard · clean · rm -r 로 남의 작업을 지우지 않는다.
6. 검사기 · 러너 · 권한 파일은 고치지 않는다(사람에게 요청).
7. 뜻이 갈리면 묻지 말고 가장 그럴듯한 해석으로 만들고, 버린 갈래를 보고 첫 줄에 남긴다.

## 끝났다고 말하기 전에
- 검증 명령의 실제 출력(통과 수 · 실패 수)을 보고에 붙인다
- 하지 않은 것, 건너뛴 것을 숨기지 않는다