Architecture

architecture-decision-records는 Claude Code 세션 중 발생하는 아키텍처 결정을 구조화된 ADR로 기록하도록 돕습니다. 의사결정 시점을 감지해 맥락, 대안, 근거를 남기고, 향후 유지보수를 위한 ADR 로그를 유지합니다. 오래 남는 결정 이력이 필요한 Technical Writing 및 엔지니어링 팀에 유용합니다.

improve-codebase-architecture는 코드베이스에서 아키텍처 마찰, 얕은 모듈, 더 깊게 다룰 수 있는 개선 지점을 찾는 데 도움을 줍니다. 리팩터링 검토, 테스트 용이성 개선, AI가 탐색하기 쉬운 설계 결정을 다룰 때 유용하며, 특히 `CONTEXT.md`와 `docs/adr/` 지침을 존중하는 방향으로 스킬을 적용하고 싶을 때 적합합니다.

migration-architect는 단계별 실행, 호환성 검증, 데이터 대사, 롤백 runbook을 통해 데이터베이스, 서비스, 인프라를 무중단으로 마이그레이션하도록 계획을 세우는 데 도움을 줍니다. Software Architecture 팀을 위한 migration plans, compatibility checks, rollback generation 스크립트가 포함되어 있습니다.

senior-architect는 system design, ADRs, stack decisions, scalability reviews, dependency analysis, architecture diagrams를 지원하는 Software Architecture 스킬입니다. 포함된 Python scripts와 references를 활용해 아키텍처 검토와 설계 의사결정을 돕습니다.

cto-advisor는 아키텍처 의사결정, 기술 부채, 엔지니어링 지표, 기술 평가, 팀 확장, 전략 계획을 지원하는 CTO 리더십 skill입니다. ADR, DORA, 평가 프레임워크와 함께 부채 분석 및 팀 확장을 위한 Python tools를 포함합니다.

cto-review는 /cs:cto-review <plan>으로 아키텍처, 확장 한계, 기술 부채, 팀 온보딩 리스크, build-vs-buy 결정을 압박 검증하는 Strategic Planning skill입니다. 프롬프트 중심으로 설계되어 있으며, 설치 후 선택적으로 참조되는 analyzer scripts가 실제로 포함되어 있는지 확인하는 것이 좋습니다.

documentation-and-adrs는 에이전트가 의사결정 중심의 기술 문서와 ADR을 작성하도록 돕습니다. 아키텍처, API, 인프라, 인증, 기능 변경에 대해 맥락, 제약, 트레이드오프, 거절한 विकल्प, 그 결과를 기록할 때 유용합니다. 단순히 잘 다듬은 요약이 아니라, 앞으로의 엔지니어와 에이전트를 위해 오래 가는 근거가 필요할 때 특히 적합합니다.

archimate는 `!include <archimate/Archimate>`와 타입이 지정된 element 매크로, 관계 매크로를 사용해 PlantUML에서 ArchiMate 다이어그램을 만들도록 돕습니다. 비즈니스, 애플리케이션, 기술, 동기, 마이그레이션 계획을 아우르는 계층형 엔터프라이즈 아키텍처 뷰에 잘 맞습니다. 구조화된 EA 표기가 필요하고 일반적인 클라우드나 네트워크 다이어그램이 아닌 경우에 Diagramming 용도로 archimate를 사용하세요.

kaizen 스킬은 리팩터링, 아키텍처, 워크플로 수정, 오류 처리, 검증에 필요한 작고 안전한 코드 개선을 안내합니다. 반복적인 변경, 설계 단계에서의 예방, 최소 범위를 중시합니다. 과도한 설계 없이 코드를 실용적으로 개선하고 싶을 때 유용한 kaizen 가이드입니다.

clickhouse-architecture-advisor는 수집, 파티셔닝, 조인, 딕셔너리, upsert, 사전 집계까지 워크로드를 고려한 판단으로 ClickHouse 워크로드 설계를 돕습니다. Backend Development, observability, SIEM, 제품 분석, IoT 텔레메트리, 금융 파이프라인에 특히 유용합니다. 이 skill은 안내 내용을 official, derived, field로 구분해 제공합니다.

plan-eng-review은 코딩을 시작하기 전에 아키텍처, 데이터 흐름, 엣지 케이스, 테스트 범위, 성능, 릴리스 위험을 확정해 두기 위한 대화형 엔지니어링 계획 리뷰 스킬입니다. 설계 문서나 구현 계획이 있고, 일반적인 리뷰 프롬프트보다 더 날카로운 피드백이 필요할 때 plan-eng-review 스킬을 사용하세요.

cloud-solution-architect 스킬은 에이전트가 Azure Cloud Solution Architect처럼 Cloud Architecture 결정을 내리도록 돕습니다. 아키텍처를 검토하고, 아키텍처 스타일을 선택하고, Azure 서비스를 비교하고, 설계 원칙·패턴·모범 사례를 일반적인 프롬프트보다 덜 추측에 의존해 적용할 때 사용하세요.