hyowons
fed3526b20
설정·스크립트·스킬·문서·큐레이션 메모리 추적. 시크릿(credentials/identity)·런타임 상태(state/logs/sessions/sqlite)· 백업(clobbered/bak)·dream 캐시는 .gitignore로 제외. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
46 lines
1.4 KiB
Markdown
46 lines
1.4 KiB
Markdown
# 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
|
|
- 요구사항 충족
|
|
- 테스트 통과
|
|
- 문서 업데이트 완료
|
|
- 검수 결과 반영 완료
|