docs(src): 계층 폴더마다 지역 규칙 AGENTS.md를 두고 CLAUDE.md가 가져온다
계층별 규칙이 Claude만 읽는 .claude/rules/에만 있어 다른 에이전트에는 보이지 않았다. 하네스 자료의 3단계는 레이어마다 그 폴더에 AGENTS.md다. src/의 9개 계층 폴더마다 AGENTS.md(16~20줄)를 둔다: 그 폴더가 하는 일, 그 폴더에만 걸리는 import 금지(.dependency-cruiser.json에서 from이 그 폴더에 맞는 규칙을 뽑아 이름과 함께), 검사하는 게이트, 테스트 위치. 모든 폴더에 걸리는 규칙은 루트 AGENTS.md와 layers.md를 가리킨다. 옆에 @AGENTS.md 한 줄 CLAUDE.md를 둬 Claude Code가 그 폴더 파일을 열 때 같은 책을 읽는다(백엔드와 같은 짝). - .claude/rules/adapters·features는 폴더 AGENTS.md를 가리키게 줄였다. - scripts/check-work-docs.py: src/**/AGENTS.md도 이력 ID 0·200줄·짝·링크를 본다. 훅 N5는 이 파일들을 노트북 확인 파일로 친다. - docs/reviews/adapters/INVENTORY.md: check:adapter-inventory가 src/adapters 아래 추적 파일을 모두 요구하므로 두 행(142·143)을 더했다. - 루트 AGENTS.md 지도가 가장 가까운 src/<계층>/AGENTS.md와 비전·문제 정의 양식을 가리킨다. 버린 대안: .claude/rules/만 두기(다른 에이전트가 못 읽는다), 폴더 CLAUDE.md 없이 AGENTS.md만(Claude Code는 같은 폴더에 CLAUDE.md가 없고 Read로 열 때만 읽어 백엔드와 갈린다). 위험·한계: 규칙 이름은 지금 규칙 파일에서 뽑았다. 규칙을 더하거나 바꾸면 이 문서도 손으로 고쳐야 한다(정본은 규칙 파일과 check:architecture). 검증: scripts/verify.sh docs rc=0(src/**/AGENTS.md 9개, 최대 20/200), python3 -m unittest discover -s scripts/tests 62건 통과.
This commit is contained in:
@@ -57,6 +57,28 @@ class RootInstructionsTest(unittest.TestCase):
|
||||
self.assertNotIn("서브에이전트를 병렬로", text, path)
|
||||
|
||||
|
||||
class LayerGuideTest(unittest.TestCase):
|
||||
"""Every top-level src/ folder has its rule book, readable by any agent, and Claude Code imports it."""
|
||||
|
||||
def test_every_layer_folder_has_a_rule_book_and_the_import_beside_it(self) -> None:
|
||||
folders = sorted(path for path in (REPO / "src").iterdir() if path.is_dir() and not path.name.startswith("."))
|
||||
self.assertTrue(folders)
|
||||
for folder in folders:
|
||||
guide = folder / "AGENTS.md"
|
||||
self.assertTrue(guide.is_file(), f"{folder.name}: no AGENTS.md")
|
||||
self.assertTrue(guide.read_text(encoding="utf-8").startswith(f"# AGENTS.md — `src/{folder.name}`"))
|
||||
self.assertEqual((folder / "CLAUDE.md").read_text(encoding="utf-8"), "@AGENTS.md\n", folder.name)
|
||||
|
||||
def test_path_rules_point_at_the_folder_books_instead_of_copying_them(self) -> None:
|
||||
for rule, book in (("adapters", "src/adapters/AGENTS.md"), ("features", "src/features/AGENTS.md")):
|
||||
self.assertIn(f"`{book}`", (CLAUDE / "rules" / f"{rule}.md").read_text(encoding="utf-8"))
|
||||
|
||||
def test_the_owner_forms_exist_and_the_map_points_at_them(self) -> None:
|
||||
for form in ("docs/vision.md", "docs/problem-statement.md"):
|
||||
self.assertIn("(채울 것", (REPO / form).read_text(encoding="utf-8"), form)
|
||||
self.assertIn(f"`{form}`", (REPO / "AGENTS.md").read_text(encoding="utf-8"))
|
||||
|
||||
|
||||
class SubagentTest(unittest.TestCase):
|
||||
AGENTS = CLAUDE / "agents"
|
||||
|
||||
|
||||
Reference in New Issue
Block a user