Architecture

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

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

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 서비스를 비교하고, 설계 원칙·패턴·모범 사례를 일반적인 프롬프트보다 덜 추측에 의존해 적용할 때 사용하세요.