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:
@@ -0,0 +1,19 @@
|
||||
# AGENTS.md — `src/features` (지울 수 있는 기능)
|
||||
|
||||
기능 하나는 `src/features/<id>/{domain,application,contracts,adapters,presentation}`이고 기능 폴더째 지울 수 있다. 이 폴더 바로 아래의 `*.ts`는 설치된 기능 목록(카탈로그)이다.
|
||||
새 기능은 `corepack pnpm create:feature <id>`로 만들고 `docs/manual/` 순서로 채운다(스킬 `new-feature`).
|
||||
|
||||
## 지킬 것
|
||||
|
||||
- 기능끼리 import하지 않는다(`features-do-not-import-other-features`). 공용이 필요하면 `src/contracts/`나 kernel로 옮기는 일을 따로 묻는다.
|
||||
- 기능 안 방향: domain은 framework·runtime을 모르고, application은 adapter·presentation을 모르고, presentation은 바깥 adapter를 모르고, adapters는 presentation을 모른다(`feature-*` 규칙 넷).
|
||||
- 기능 밖 adapter는 기능의 `adapters/`나 `feature-adapter-contribution.ts`로만 닿는다(`feature-and-app-roots-do-not-reach-adapters`). presentation은 직접 fetch하지 않는다(`presentation-does-not-fetch-directly`).
|
||||
- 기능 테스트는 `tests/features/<id>/`에 둔다. 플랫폼 테스트를 기능에 묶지 않는다.
|
||||
- 모든 `src/` 폴더에 걸리는 규칙(adapter는 배럴로만, zod는 `src/contracts/zod.ts`로만, 아이콘 vendor·디자인 시스템·외부 계약 패키지·관측 vendor는 정해진 입구로만)은 루트 `AGENTS.md` 꼭 지킬 것과 `docs/architecture/layers.md`다.
|
||||
|
||||
## 검사
|
||||
|
||||
- 판정은 `check:architecture`(FE-GATE-010)다. 편집 직후 훅(N3)이 이 폴더 파일의 import를 같은 규칙에 대 본다.
|
||||
- FE-GATE-020: 생성한 기능을 더하고 지운 사본, 기능 제거는 `test:sample-removal -- --feature=<id>`
|
||||
- 초기 JS 기록(`config/scale/feature-shape-ceilings.json`)은 생성 출력 `Next:`의 명령으로 다시 쓴다
|
||||
- 돌리는 곳은 desktop이다(`scripts/verify.sh`). 테스트는 `tests/features/<id>/`에 둔다(`.claude/rules/tests.md`).
|
||||
@@ -0,0 +1 @@
|
||||
@AGENTS.md
|
||||
Reference in New Issue
Block a user