improve-codebase-architecturecommit 7739eaeSKILL.md · 아키텍처 개선

코드베이스 구조 개선

얕은 모듈을 깊게 만드는 리팩터링 후보를 찾아 시각적인 HTML 보고서로 보여 주고, 고른 후보를 문답으로 다듬습니다.

npx skills add mattpocock/skills --skill improve-codebase-architecture

권한: read-repo
write-files
shell
network
호환 도구: Claude Code, Codex, Copilot, Gemini CLI
GitHub: 308.7k
출처: 커뮤니티 · Matt Pocock
상태: 스캔 통과
라이선스: MIT
카테고리: 아키텍처 개선
저장소: github.com/mattpocock/skills/skills/engineering/improve-codebase-architecture

핵심 규칙

스캔하기 전에 범위를 정하고, 최근 자주 바뀐 부분에 우선 집중합니다.

실행 단계

01단계범위 정하기
사용자가 방향을 정했으면 따르고, 아니면 git log로 자주 바뀌는 곳을 찾습니다. GLOSSARY.md와 관련 ADR을 먼저 읽습니다.
02단계마찰 지점 탐색
서브 에이전트로 코드를 살펴 얕은 모듈, 지역성 부족, seam 누수를 찾고 삭제 테스트로 확인합니다.
03단계HTML 보고서 작성
OS 임시 디렉터리에 독립형 HTML을 만들고, 후보마다 전후 비교 도식과 추천 강도를 붙여 최우선 후보를 제시합니다.
04단계선택 후보 문답
선택된 후보의 제약, 의존성, 깊어진 모듈의 형태를 문답으로 정하고 GLOSSARY.md를 갱신하며 필요하면 ADR 기록을 제안합니다.

권한 설명 (SKILL.md 기준)

기능	필요 여부	설명
파일 쓰기	일부 필요	임시 디렉터리의 HTML 보고서와 GLOSSARY.md, docs/adr/의 ADR만 작성하며 코드 자체는 바꾸지 않습니다.
명령 실행	일부 필요	커밋 기록을 보는 git log와 보고서를 여는 open, xdg-open, start를 실행합니다.
네트워크 송신	필요 없음	스킬 자체는 네트워크를 쓰지 않으며, 생성된 보고서는 브라우저에서 열 때 CDN에서 Tailwind와 Mermaid를 불러옵니다.

SKILL.md 프런트매터(YAML)commit 7739eae

---
name: improve-codebase-architecture
description: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
disable-model-invocation: true
---

핵심 규칙

실행 단계

01단계범위 정하기

02단계마찰 지점 탐색

03단계HTML 보고서 작성

04단계선택 후보 문답

권한 설명 (SKILL.md 기준)

SKILL.md 프런트매터(YAML)

관련 스킬