improve-codebase-architecture
Agent workflows
설치
$ npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architecture요약
큰 변경 전에 구조적 위험을 파악하거나 모듈 경계를 다시 잡아야 할 때 적합합니다.
- 코드베이스 구조를 읽고 책임 경계, 의존성, 리팩터링 후보를 찾는 아키텍처 개선 스킬입니다.
- 한국어 큐레이션 기준으로 이 스킬의 핵심을 먼저 정리했습니다.
- 설치는 개별 스킬 페이지의 명령을 그대로 사용합니다.
- 아래 해설 섹션에서 사용 맥락과 주의점을 한국어로 길게 풀어 읽을 수 있습니다.
해설
어떤 스킬인가
improve-codebase-architecture는 코드베이스를 구조 관점에서 읽는 스킬입니다. 파일 몇 개를 고치는 데서 멈추지 않고, 모듈 경계, 의존성 방향, 중복된 책임, 지나치게 커진 컴포넌트나 서비스 계층을 찾아냅니다.
에이전트가 리팩터링을 할 때 위험한 점은 눈에 보이는 중복만 제거하고 실제 소유권 경계는 흐려지게 만드는 것입니다. 이 스킬은 코드가 어떤 책임 단위로 나뉘어야 하는지 먼저 판단하게 합니다.
언제 쓰면 좋은가
큰 기능 추가 전에 구조를 점검할 때 좋습니다. 특히 "어디에 코드를 넣어야 할지 모르겠다", "비슷한 유틸이 여러 곳에 있다", "도메인 로직이 UI와 섞여 있다"는 신호가 보이면 이 스킬이 도움이 됩니다.
반대로 작은 버그 수정에는 과할 수 있습니다. 아키텍처 개선은 범위가 커지기 쉬우므로, 변경 가능한 파일과 금지할 리팩터링 범위를 명확히 정해야 합니다.
설치
npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architecture
요청할 때는 "분석만 할지", "패치까지 할지", "어떤 디렉터리만 볼지"를 구분하는 편이 안전합니다.