코드베이스 아키텍처 개선

아키텍처 마찰을 드러내고 심화 기회 — 얕은 모듈을 깊은 모듈로 바꾸는 리팩터 — 를 제안한다. 목표는 테스트 용이성과 AI 탐색 용이성이다.

이 명령은 프로젝트의 도메인 모델에 기반 하며, 공유 설계 어휘 위에서 작동한다:

• 아키텍처 개념은 VOCABULARY.md를 본다 (모듈, 인터페이스, 깊이, 경계, 어댑터) — 그리고 원칙(삭제 테스트, "인터페이스가 테스트하는 면이다", "어댑터가 하나면 경계를 만들지 마라"). 사용자에게 보이는 글에는 그 말로 써라. seam, leverage, locality를 쓰지 마라. component, service, API로 빠지지 마라.
• CONTEXT.md의 도메인 언어는 좋은 경계에 이름을 붙여준다. docs/adr/의 ADR은 이 명령이 다시 논쟁해서는 안 되는 결정을 기록한다.

과정

1. 탐색

스캔하기 전에 범위를 정하라 — YAGNI. 모듈을 심화하는 보상은 해당 모듈의 향후 변경을 쉽게 만드는 데서 나오므로, 최근에 변경된 코드베이스 부분에 가중치를 둔다. 들여다보기 전에 들여다볼 곳을 정하라:

• 사용자가 방향을 지정했다면 — 모듈, 하위 시스템, 문제 지점 — 그것을 따르고, 아래 추론은 건너뛰어라.
• 그렇지 않으면 커밋 기록의 꽤 긴 구간(git log --oneline)을 되짚어 코드베이스의 핫스팟 — 반복적으로 등장하는 파일과 영역 — 을 찾고, 그 경로가 먼저 주의를 끌도록 하라. 변경이 흩어져 뚜렷한 핫스팟이 없다면 그물을 넓혀라.

먼저 프로젝트의 도메인 용어집(CONTEXT.md)과 다룰 영역의 ADR을 읽어라.