codebase-designcommit 7739eaeSKILL.md · 아키텍처 설계

코드베이스 설계

깊은 모듈 설계를 위한 공통 용어와 원칙을 제공합니다. 작은 인터페이스 뒤에 많은 동작을 두고 그 인터페이스로 테스트합니다.

npx skills add mattpocock/skills --skill codebase-design

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

핵심 규칙

어댑터가 하나면 가상의 이음매, 둘이면 진짜 이음매이므로, 달라지는 것이 없으면 이음매를 만들지 않습니다.

실행 단계

01단계용어 통일
모듈, 인터페이스, 구현, 깊이, 이음매, 어댑터, 레버리지, 지역성 용어를 정확히 쓰고 컴포넌트, 서비스, 경계로 바꿔 말하지 않습니다.
02단계깊이 평가
삭제 테스트로 단순 전달 계층인지 판단하고, 메서드를 줄이거나 매개변수를 단순화하거나 복잡성을 더 숨길 수 있는지 검토합니다.
03단계의존성 분류
의존성을 프로세스 내, 로컬 대체 가능, 자체 원격(포트와 어댑터), 순수 외부(목) 네 가지로 나눠 이음매 너머 테스트 방식을 정합니다.
04단계두 번 설계하기
서브에이전트 셋 이상을 병렬로 띄워 서로 다른 제약으로 확연히 다른 인터페이스를 만들게 하고, 깊이, 지역성, 이음매 위치로 비교해 추천합니다.

권한 설명 (SKILL.md 기준)

기능	필요 여부	설명
파일 쓰기	필요 없음	설계 용어와 방안 비교를 제공하며, 스킬 자체는 파일 작성을 요구하지 않습니다.
명령 실행	필요 없음	명령을 실행하지 않습니다.
네트워크 송신	필요 없음	네트워크에 접근하지 않습니다.

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

---
name: codebase-design
description: Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
---

핵심 규칙

실행 단계

01단계용어 통일

02단계깊이 평가

03단계의존성 분류

04단계두 번 설계하기

권한 설명 (SKILL.md 기준)

SKILL.md 프런트매터(YAML)

관련 스킬