# 코드베이스 구조 개선 (improve-codebase-architecture)

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

- 카테고리: [아키텍처 개선](https://www.myskills.tools/ko/categories/architecture-tuning/)
- 출처: 커뮤니티 · Matt Pocock
- 저장소: https://github.com/mattpocock/skills/tree/main/skills/engineering/improve-codebase-architecture (commit 7739eae)
- SKILL.md: https://github.com/mattpocock/skills/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md
- 설치 명령: `npx skills add mattpocock/skills --skill improve-codebase-architecture`
- 라이선스: MIT
- 호환 도구: Claude Code, Codex, Copilot, Gemini CLI
- 권한: read-repo ✓, write-files ✓, shell ✓, network ✗
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.

## 핵심 규칙

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

## 실행 단계

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

## 권한 설명 (SKILL.md 기준)

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

## SKILL.md 프런트매터(YAML)

```yaml
---
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
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/improve-codebase-architecture/