name: architecture
description: 프로젝트 아키텍처를 조회하고 시각화합니다. 프로젝트 온보딩 시, 코드 리뷰 전, 신규 도메인 추가 전, 기술 스택 확인 시 사용하세요. "전체 구조", "API 목록", "기술 스택", "도메인 구조" 질문에 응답합니다. /architecture 트리거.
version: 1.1.0
updated: 2026-02-11

Architecture Map (아키텍처 맵 조회)

프로젝트의 전체 아키텍처를 조회하고 시각화합니다. 도메인 구조, API 카탈로그, 레이어 구조, 기술 스택을 한눈에 파악할 수 있습니다.

스킬 발동 조건

• /architecture - 전체 아키텍처 개요
• /architecture domains - 도메인 구조
• /architecture api - API 카탈로그
• /architecture layers - 레이어별 구조
• /architecture tech - 기술 스택
• /architecture <도메인명> - 특정 도메인 상세
• "아키텍처 보여줘"
• "전체 구조 파악"
• "API 목록"

절대 금지 사항

1. 코드를 직접 수정하지 마세요 - 조회/시각화 전용입니다.
2. 추측으로 구조를 판단하지 마세요 - 실제 파일 시스템을 기반으로 분석하세요.
3. 아키텍처 문서를 직접 수정하지 마세요 - architecture-updater.js 훅의 책임입니다.

실행 단계

/architecture [서브커맨드] 수신
    |
    v
[1] 서브커맨드 파싱
    |
    v
[2] 기존 아키텍처 문서 확인 (.claude/architecture/)
    |
    v
[3] 프로젝트 구조 탐색
    |
    v
[4] 서브커맨드별 분석
    |
    +--> overview: 전체 아키텍처 개요
    +--> domains: 도메인 구조
    +--> api: API 엔드포인트
    +--> layers: 레이어 구조
    +--> tech: 기술 스택
    +--> <도메인명>: 도메인 상세
    |
    v
[5] 시각화 출력

서브커맨드

도메인 탐색 패턴

레이어 vs 도메인 구분:

• 레이어 (도메인 아님): api/, services/, models/, utils/
• 도메인 (분석 대상): order/, member/, product/

레이어 식별 패턴

기술 스택 감지

# 설정 파일 확인
cat package.json pyproject.toml requirements.txt 2>/dev/null | head -30

# 인프라 설정
ls Dockerfile docker-compose*.yml .github/workflows/ 2>/dev/null

데이터 소스 우선순위

Hook 연동

관련 스킬 연동

참조 문서

• references/output-formats.md - 출력 형식 상세
• references/examples.md - 사용 예시