모듈형 아키텍처 설계 (Balanced Coupling)

기능 요구서를 입력하면 결합도 균형 원칙에 따라 모듈 아키텍처를 설계하고 모듈별 설계서·테스트 명세·아키텍처 문서를 만들어 준다.

개발·코딩고급★ 515⑂ 32AI 점수 8/10마지막 업데이트: 2026. 4. 4.

무엇을 해주나

기능 요구서 파일(functional-requirements.md)을 읽어 요구사항을 재정리하고, 빠진 정보(도메인 분류, 팀 구조, 통합 방식)를 하나씩 질문해 채웁니다.
DDD 서브도메인(핵심/지원/일반)으로 변동성을 분류하고, 결합 강도 × 거리 × 변동성 3차원으로 모듈 간 통합을 평가합니다. BALANCE = (STRENGTH XOR DISTANCE) OR NOT VOLATILITY 규칙으로 분산 모놀리스·거대 진흙덩어리 위험을 표로 짚어줍니다.
docs/design/<날짜>/ 아래에 모듈별 design.md(책임, 캡슐화된 지식, 통합 계약, 변경 축)와 tests.md(단위·계약·경계·행위 테스트), 그리고 전체 architecture.md를 작성합니다.
마지막에 자기 설계를 다시 리뷰해 Critical/Significant 결합 문제가 없어질 때까지 반복 수정합니다.

design docs/requirements/booking-system.md — 예약 시스템 요구서로 모듈 지도와 결합도 평가표를 받고, 승인 단계를 거쳐 설계 문서 세트를 생성.
기존 모놀리스를 분리하기 전에 요구서를 정리해 넣고, "강한 결합 + 원거리" 통합이 어디인지 표로 확인 후 계약 기반 API로 재설계.
팀 소유권이 갈린 모듈을 입력해, 조직적 거리 때문에 발생하는 결합 불균형과 개선안을 리뷰 단계에서 도출.

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/vladikk/modularity/HEAD/skills/design/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)

Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 vladikk/modularity 의 skills/design 폴더를 내 ~/.claude/skills/design/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/vladikk/modularity.git && mkdir -p ~/.claude/skills && cp -r modularity/skills/* ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

터미널을 열고 원하는 작업 폴더로 이동합니다.
저장소를 복제합니다: git clone https://github.com/vladikk/modularity.git
스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
스킬을 복사합니다: cp -r modularity/skills/* ~/.claude/skills/ (이 스킬은 balanced-coupling 스킬을 함께 사용하므로 전체 복사를 권장합니다.)
설계할 프로젝트 폴더에서 claude를 실행하고 /skills 또는 스킬 목록으로 design이 보이는지 확인합니다.
기능 요구서 마크다운 파일을 미리 준비한 뒤 design path/to/functional-requirements.md 형태로 호출합니다.
각 단계에서 나오는 선택형 질문에 답하며 승인해 나가면 docs/design/<날짜>/ 폴더에 문서가 생성됩니다.