DongHyeonkaandClaude Fable 5.1
9d2a3725c5
리뷰 두 건을 반영했다. 계약 - tech-log-tree.json 하나가 분해 계약이자 색인이다. 사람이 읽는 트리·Node Specification· 후보 대장은 없어졌고, 문서에 남아 있던 그 개념을 걷어냈다 - candidateScope — 후보를 찾는 SSOT 범위. 접어 넣은 제2부·제3부는 근거이지 후보가 아니다 - sourceRepository — 분석한 저장소의 경로·리비전·판단 근거. 리비전을 모르면 null 로 두고 지어내지 않는다. 갈래가 여럿이면 revisions - 검사기: 계약 미채택·PENDING·PROMOTE↔글감 양방향·candidateScope·sourceRepository 를 error/warn 으로 센다. 옛 스키마도 검사를 피하지 못한다. 테스트 22 → 31 기록 쓰기 - 템플릿 5종에 source·sourceRevision·topicName, Question 에 닫는 조건, 본문 없는 종류에서 assets 제거. 고정 절 개수 삭제 - check_evidence.mjs — 인용한 코드가 SSOT 에 있는지, 앵커가 SSOT 를 가리키는지, 제목이 계약과 같은지, 리비전이 저장소에 있는지. 게시된 기록에서 SSOT 와 다른 URL 을 잡았다 문체 - 문체 규칙의 정본을 ai-tells.md 로. explaining.md 의 질문체 제목·절 끝 대조 반복·그림 예고 규칙을 삭제해 충돌을 없앴다. 첫 절 「설명 뒤에 평가를 붙이지 않는다」에 지우는 사례 네 유형 - voice 스킬의 「독자 쪽을 본다」를 자료에 오독 기록이 있을 때로 좁히고, 평가만 더한 예시를 교체 - check_prose: 안내 문장을 요구하던 경고 제거, 문장이 끝나지 않은 채 문단이 끝나는 조각 검사 추가 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
<module/subsystem> 완전 해부
상태: IN_PROGRESS | COMPLETE
기준 revision:
분석 범위: <path/module>
0. 커버리지와 숫자 지도
- production files:
- production LOC:
- packages/directories:
- tests by lane:
- migrations/config/build files:
- runtime membership:
Coverage ledger
| scope/file group | count | disposition | reason |
|---|---|---|---|
| FULL_READ / STRUCTURAL_ONLY / EXCLUDED |
1. 모듈의 정체와 경계
2. 의존성과 런타임 배선
3. 패키지/컴포넌트 지도
4. 계약·불변식·상태 모델
5. 주요 실행 경로
6. 실패 경로와 복구/번역
7. 트랜잭션·동시성·수명주기
8. 설정·기능 플래그·환경 차이
9. 퍼시스턴스/외부 시스템 세부
10. 테스트 레인과 실제 증명 범위
11. 빌드/ArchUnit/CI 강제 지점
12. 실제 사용 여부와 dead/unwired/duplicate 경로
13. Git/설계 문서에서 확인한 변화와 실패 기록
14. 런타임·터미널·브라우저 Evidence
15. 명시적 설계 이유와 추론을 구분한 정리
16. 확인한 것 / 확인하지 못한 것
17. 손볼 것
각 항목: 우선순위 → 사실 → 근거 → 왜 문제인가 → 확인 방법 → 후보/다음 단계.
Source anchors
모든 핵심 주장에 source-index의 파일/심볼/테스트/evidence anchor를 연결한다.