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

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

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

---

[Harness engineering](/en/courses/harness-engineering) 2. Repo-readable 시스템 4 / 9

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

문서 계층과 실행 가능한 규칙의 경계 결정
Scenario 60 XP 8 min

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

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

---

Site guide for agents: https://learning.reopt.ai/llms.txt · Sitemap: https://learning.reopt.ai/sitemap.xml · Contact: https://learning.reopt.ai/contact