하는 일
아키텍처의 마찰을 찾아 테스트 용이성과 AI의 코드 탐색 편의성을 목표로 '깊게 만들' 기회를 제안합니다. 먼저 git 기록의 핫스팟으로 범위를 좁히고 GLOSSARY.md와 관련 ADR을 읽은 뒤, 서브 에이전트가 코드를 훑으며 얕은 모듈, 새는 이음매, 테스트하기 어려운 부분을 찾고 '삭제 테스트'로 판단합니다. 독립적인 HTML 보고서(Tailwind와 Mermaid는 CDN에서)를 OS 임시 폴더에 쓰고 엽니다. 각 후보에는 파일, 문제, 해결, 이점, 맞춤 전후 도식, 강도 배지가 있고 마지막은 최우선 추천으로 끝납니다. 고정된 어휘(module, interface, depth, seam, adapter, leverage, locality)를 씁니다. 하나를 고르면 결정 트리를 따라 질문을 이어 가며 GLOSSARY.md와 ADR을 갱신합니다.
결과물
HTML 아키텍처 검토와, 선택한 안에 대한 대화형 설계 논의.
이런 때 좋습니다
코드의 어디가 '얕은지' 구조적이고 시각적으로 검토하고 싶고 공통 설계 어휘를 받아들일 수 있는 팀.
중간 위험:지침만 있는 파일로 스크립트는 없지만, git log를 실행하고 코드를 읽는 서브 에이전트를 띄우며, HTML 파일을 임시 폴더에 쓰고 명령으로 연 뒤, 이후 저장소의 GLOSSARY.md를 수정하거나 ADR을 추가할 수 있습니다. 보고서는 공개 CDN에서 Tailwind와 Mermaid를 불러옵니다. 같은 작성자의 다른 Skill(codebase-design, grilling, domain-modeling)에 의존합니다. 시험하지 않음: 실제 저장소와 서브 에이전트가 필요해 데모가 없고 프런트엔드에는 '미검증'으로 표시됩니다. 작성자 Matt Pocock, MIT.