# 실전: 커진 AGENTS.md를 재설계하라

> 문서 계층과 실행 가능한 규칙의 경계 결정

- Canonical: https://learning.reopt.ai/courses/harness-engineering/lessons/he-m2-scenario
- Language: ko-KR
- HTML: https://learning.reopt.ai/courses/harness-engineering/lessons/he-m2-scenario

---

[하네스 엔지니어링](/courses/harness-engineering) 2. Repo-readable 시스템 4 / 9

# 실전: 커진 AGENTS.md를 재설계하라

문서 계층과 실행 가능한 규칙의 경계 결정
시나리오 60 XP 8분

한 팀의 루트 AGENTS.md가 1,200줄로 늘어났고 규칙끼리 충돌하기 시작했습니다.
상황 배경 결제·프론트엔드·데이터 규칙과 이번 스프린트 메모가 한 파일에 섞였으며, 필수 검증은 사람이 기억해 실행합니다. 결정 1 / 2

첫 번째 구조 개선으로 무엇을 해야 할까요?
모든 문장을 더 짧게 줄여 한 파일에 유지한다 루트는 TOC로 줄이고 도메인 규칙과 현재 작업 맥락을 분리한다 AGENTS.md를 삭제하고 채팅 기록으로 대체한다

---

에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact