docs: AGENTS.md 를 스코프별로 분리하고 0.30.0 계약으로 갱신

[ictechgy]

root AGENTS.md 를 갱신하고 경로별 규칙을 자식 AGENTS.md 로 옮긴다.
CLAUDE.md 는 계속 AGENTS.md 를 참조한다.

왜 쪼갰는가

기존 root 는 37줄 / 5,223B 로 임계값(250줄 / 12KiB) 아래였다. 크기 때문이
아니라 두 가지 실질적 이유 때문이다.

1. 내용이 낡았다. argv 예외 조항이 advisory 에도 적용되는 것처럼 읽혔는데,
0.30.0 부터 내장 advisory 라우트 중 태스크를 argv 에 싣는 것은 없다. 세션 스코프
송신 동의, task_stdin_encoding 공개, 의회 병렬 실행, 라우트 argv 변경 시
migrate-routes 필요성이 어디에도 없었다.

2. 고위험 규칙이 정작 필요한 순간에 안 보였다. .weightclass/verify-review
의 시드가 file:line 로 고정되고 ±8줄 창으로 검사된다는 사실은 그 파일을 편집할
때 알아야 하는데, root 에만 있어서 그 디렉터리 스코프에서는 보이지 않았다.
이번 0.30.0 작업에서 제가 실제로 겪은 실패 모드다.

결과

파일	줄	담은 것
AGENTS.md	101	전역 규칙, 제품 방향, 스코프 인덱스, 문서 지도
src/weightclass/AGENTS.md	89	V1 one-child, V2 경계, 실행 전 검토, argv 예외를 코어 네이티브로 한정, 집계 usage store, 분류기 튜닝 금지
src/weightclass/advisory/AGENTS.md	170	동의 3종과 세션 승인의 standing·inheritable 성격, "확인을 건너뛰어도 공개는 건너뛰지 않는다", argv 무사용 계약, 봉인 인구 마이그레이션, Skill 원장 절차
tests/AGENTS.md	84	게이트는 ./.weightclass/verify(≠ pytest -q), 새 테스트가 증명할 것, 기존 단언 수정 절차, vacuity 감사
.weightclass/AGENTS.md	64	검증기를 통과시키려 고치지 말 것, 줄 앵커 재고정 절차, exit 42 계약
packaging/AGENTS.md	68	수식은 원본, tap 안에서만 검증 유효, 해시 URL, 정확한 엔트리포인트

6개 파일 전부 임계값 이하, 링크 누락 0, marker block 없음.

누락 검증

원본의 계약 표현 25개를 새 파일 집합에 기계적으로 대조했다. 초안에서
patch-only handoff 와 cheap/advisor/retry/expensive 두 지시문이 빠진 것을
이 대조로 잡아 복원했다.

기존 테스트 1건 수정 (조용히 뒤집지 않음)

test_install_skill_is_the_documented_vendor_path_exception 이 root AGENTS.md
에 sole vendor-recognized-path exception 문구가 있기를 요구했다.

그 테스트가 지키던 계약은 "이 예외가 에이전트 가이드에 문서화되어 있을 것"
이다. 이제 가이드가 여러 파일이므로, 규칙이 사는 스코프 파일과 root 에서의 도달
가능성을 둘 다 확인하도록 강화했다. 이전보다 엄격하다.

게이트

.weightclass/verify exit 0 (1,599 tests / 35 skips) · Ruff check + format ·
strict mypy 206 files · git diff --check · 스킬 감사 통과.

🤖 Generated with Claude Code

https://claude.ai/code/session_01P3dXGuZjrBWD669SgUuk65