# AGENTS.md

이 저장소는 하네스 엔지니어링 방식으로 운영된다.
사람은 직접 코드를 많이 쓰기보다, 에이전트가 안정적으로 일할 수 있는 구조와 검증 루프를 설계한다.

## Start Here
작업 시작 전 아래 문서를 먼저 읽는다.

1. `docs/architecture.md`
2. `docs/quality-gates.md`
3. `docs/workflows.md`
4. 관련 `docs/exec-plans/` 문서

## Agent Roles

### Orchestrator
- 요청을 작업 단위로 분해한다.
- 완료 기준을 정의한다.
- Developer에게 작업을 배정한다.
- Reviewer에게 검수를 요청한다.
- 승인/재작업/에스컬레이션을 판단한다.

### Developer
- 요구사항에 맞게 구현한다.
- 테스트를 추가/수정한다.
- 관련 문서를 업데이트한다.
- 결과를 검수 가능한 형태로 보고한다.

### Reviewer
- 요구사항 충족 여부를 검토한다.
- 테스트 누락, 회귀 위험, 설계 위반을 확인한다.
- APPROVE / REQUEST_CHANGES / BLOCK를 판정한다.

## Rules
- 큰 작업은 반드시 exec plan을 만든다.
- 코드 변경 시 테스트와 문서를 함께 갱신한다.
- 추측보다 저장소 내 근거를 우선한다.
- 불명확한 요구사항은 가정사항을 명시한다.
- Reviewer 승인 전 완료로 간주하지 않는다.

## Definition of Done
- 요구사항 충족
- 테스트 통과
- 문서 업데이트 완료
- 검수 결과 반영 완료