메뉴
복잡도에 따라 ASCII art 또는 Mermaid 다이어그램을 선택하여 생성. Use when visualizing architecture, drawing diagrams, explaining structure visually, or 도식화/다이어그램 요청 시. 중간 복잡도는 ASCII art 우선.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Creates ast-grep patterns for structural code search. Use when finding functions/classes by structure, refactoring code, or when grep returns too many false positives.
Builds Claude Agent SDK agents in Python. Use when creating custom tools, hooks, sub-agents, or MCP integrations with the Agent SDK. Python 에이전트 구축 시 사용.
Graph-based code review with Tree-sitter knowledge graph. Use when reviewing code changes, PRs, or exploring blast radius of modifications in projects with code-review-graph installed (.code-review-graph/ exists). Also use for initial setup of code-review-graph in a new project. Do NOT use for checklist-based reviews without graph (use code-review instead), or for security-focused reviews (use security instead).
Code review hub. 타입 안전성 (TypeScript, Python), lint 감사, 죽은 코드, 테스트 품질 리뷰 (smell, overfitting, 커버리지, 통합/E2E), Terraform/IaC 안전성 (lifecycle, state, credentials). 병렬 에이전트 모드로 다각적 분석 지원. 코드 리뷰, 타입 체크, lint, 테스트 리뷰, terraform, IaC.
데이터 조사/분석 파이프라인 생성. 데이터 수집 -> Python 분석/차트(matplotlib) -> HTML 리포트. Use when 데이터 분석, 조사, investigation, 이상 탐지, 패턴 분석, 리포트 생성, 차트 시각화, 데이터 수집 파이프라인 구축. Also use when 데이터를 모아서 분석하고 보고서를 만드는 작업. Do NOT use for 단순 DB 조회 (use gandy), 단순 차트 하나 (use diagram).
코드 작업 완료 후 변경 내러티브 문서 생성. 변경 요약, 설계 판단 근거, 학습 포인트를 vault에 기록. Vault 위치/매핑은 `documentation` skill, 형식은 `obsidian-write` 참조. Use when completing code work, after PR creation, reviewing what was done, or wanting to document changes for learning. /debrief, 작업 정리, 변경 기록, 회고.
| name | diagram |
| description | 복잡도에 따라 ASCII art 또는 Mermaid 다이어그램을 선택하여 생성. Use when visualizing architecture, drawing diagrams, explaining structure visually, or 도식화/다이어그램 요청 시. 중간 복잡도는 ASCII art 우선. |
다이어그램 생성 시 복잡도를 판단하여 적절한 형식을 선택합니다.
핵심 원칙: 중간 복잡도 이하는 ASCII art 우선. Mermaid는 고복잡도 전용.
기본값은 ASCII. Mermaid는 ASCII로 표현이 어려울 때만 사용.
ASCII (기본) Mermaid (전환)
선형, 트리, 단순 분기 교차선 3개 이상
80자 이내로 표현 가능 80자 초과 불가피
노드 간 연결이 이웃끼리 순환 참조 + 복잡한 교차
ER, Gantt, 클래스 다이어그램
다음 중 2개 이상 해당하면 Mermaid로 전환:
| 구조 | 노드 수 제한 | 이유 |
|---|---|---|
| 선형 파이프라인 | 제한 없음 | 가로/세로 일직선 |
| 트리/계층 | 제한 없음 | 들여쓰기로 자연 표현 |
| 시퀀스 (액터 3-4) | 스텝 제한 없음 | 세로로 확장 |
| 분기 흐름 | ~15 노드 | 2-3 레벨 분기까지 깔끔 |
| 격자/매트릭스 | 80자 이내 | 행 추가는 자유 |
가장 범용. 컴포넌트 간 관계 표현에 적합.
+----------+ +----------+
| Client |---->| Server |
+----------+ +----------+
|
+----v-----+
| Database |
+----------+
레이블 포함:
+--------+ HTTP +--------+ SQL +------+
| Client |-------->| API |------->| DB |
+--------+ +--------+ +------+
|
Redis |
v
+-------+
| Cache |
+-------+
tree 명령어 출력과 동일한 형태. 계층 표현에 최적.
src/
├── components/
│ ├── Header.tsx
│ └── Footer.tsx
├── hooks/
│ └── useAuth.ts
└── index.ts
메시지 흐름, API 호출 순서 표현.
Client Server DB
| | |
|-- request --->| |
| |-- query ---->|
| |<-- result ---|
|<-- response --| |
| | |
조건 분기와 상태 전이 표현.
+-------+
| Start |
+---+---+
|
+---v---+
| Check |
+---+---+
/ \
yes / \ no
/ \
+----v-+ +-v------+
| Pass | | Retry |
+------+ +---+----+
|
+---v---+
| Fail |
+-------+
2차원 비교에 적합. 마크다운 테이블과 병행 가능.
Read Write Admin
User x - -
Editor x x -
Admin x x x
| 환경 | 문자 세트 | 예시 |
|---|---|---|
| 코드 주석, 터미널 | 순수 ASCII | `+ - |
| 마크다운 문서 | 유니코드 허용 | ─ │ ┌ ┐ └ ┘ ├ ┤ ▼ ▶ |
한 다이어그램에서 두 세트를 혼용하지 않는다.
``` 또는 ```text로 감싸기-- label --> 형태로 의미 전달+-|> 를 유니코드보다 안정적으로 생성User: "CI/CD 파이프라인 그려줘"
→ 선형 흐름, 교차선 없음
→ ASCII (스타일 1: Box-and-Arrow)
commit -> lint -> test -> build -> staging -> deploy
User: "프로젝트 구조 보여줘"
→ 계층 구조, 교차선 없음
→ ASCII (스타일 2: Tree)
User: "마이크로서비스 의존관계 그려줘"
→ 서비스 간 양방향 호출, 교차선 5개 이상
→ Mermaid (자동 레이아웃 필요)
User: "시스템 개요 + 상세 흐름 그려줘"
→ 전체 의존관계: Mermaid (교차 다수)
→ 개별 요청 흐름: ASCII (선형)
Mermaid 전환 시 resources/mermaid-cheatsheet.md 참조. Flowchart, Sequence, C4, ER, State, Gantt 문법 포함.