Voice — 워크플로우 하네스

Claude Code의 루트 CLAUDE.md에 정의된 트리거들이 특정 키워드를 감지해 자동 워크플로우를 발동합니다. "상황 검토해봐" 한마디로 코드베이스 진단이 실행되고, "저장해줘"로 세션 인수인계 문서가 만들어집니다.

CLAUDE.md 6 triggers natural language non-developer friendly

개요

Claude Code는 작업 시작 시 루트 CLAUDE.md를 읽고 그 내용을 시스템 프롬프트로 내재화합니다. Voice는 이 메커니즘을 활용해 자주 쓰는 워크플로우를 한국어 트리거 키워드로 자동화합니다.

동작 모델:

Claude Code 시작
  ↓
CLAUDE.md 로드 (Nexus + OMC + comad Voice)
  ↓
사용자 입력
  ↓
키워드 매칭 검사
  ↓
  매칭 → 해당 트리거 skill/agent 자동 실행
  미매칭 → 일반 대화

CLAUDE.md 트리거

Voice의 트리거 정의는 ~/.claude/CLAUDE.md의 Comad Voice 섹션에 있습니다. 현재 Nexus autonomous trigger(#14~16)와 중복되지 않는 3개만 활성.

# ~/.claude/CLAUDE.md (발췌)

## T0. 온보딩 (첫 세션 감지)
감지 조건: .comad/ 폴더 없음 + 첫 대화 시작 시
→ 프로젝트 자동 탐색 + 환영 메시지

## T4. 레포 광택 (Repo Polish)
감지: "광택", "레포 정리", "repo polish"
→ SCAN → DIAGNOSE → GENERATE → RELEASE → VERIFY 5단계

## T5. 세션 저장 & 인수인계
감지: "저장해줘", "여기까지", "다음에 이어서"
→ git diff 추적 + 세션 요약 파일 생성

트리거 목록

코드	트리거	역할
T0	(자동 감지)	온보딩 — 프로젝트 자동 탐색 + 가능한 명령 안내
T4	"광택", "레포 정리"	GitHub 레포를 인기 오픈소스 수준으로 포장 (README 뱃지, CHANGELOG, Issue/PR 템플릿, Social Preview, CI 게이트)
T5	"저장해줘", "여기까지"	세션 요약 + 인수인계 문서 생성
T15	"상황 검토", "검토해봐", "개선 가능성"	코드베이스 진단 + 3-5개 개선 카드 제시 (난이도/효과 표기)
(Nexus #14)	"풀사이클", "end-to-end"	RESEARCH → DECOMPOSE → EXPERIMENT → INTEGRATE → POLISH → DELIVER 6-stage
(Nexus #16)	(자동)	멀티-AI 병렬 가능 감지 (5-Point 체크리스트)

T5 — 세션 저장 & 인수인계

You: 저장해줘

Claude (T5):
git diff --stat 추적:
  · 수정 파일: 8개 (brain/packages/graphrag/src/*, 문서 3건)
  · 실험 결과: benchmark recall 83→93%, latency 20.7→13.8s
  · 발견 문제: Discord 봇 OAuth 이슈 (메모리 파일로 저장)

세션 요약 저장:
  .comad/sessions/2026-04-13-1537.md
  ✓ 완료 작업 6건
  ✓ 미완료 작업 2건 (meta-edge 분할, 그래프 50K)
  ✓ 핵심 결정 3건
  ✓ 주의점 1건

MEMORY.md 업데이트:
  ✓ 링크 추가: Session 2026-04-13

상태 파일 업데이트:
  ✓ .comad/state.json (lastSession, pendingTasks)

다음 세션에서 "이어서 해줘" 또는 "어디까지 했어?"로 재개 가능.

T15 — 상황 검토

You: 검토해봐

Claude (T15):
코드베이스 탐색 + 최근 커밋 분석 중...

── 현재 상태 ──────────────
  · 커밋: 최근 2주 23건, 주로 graphrag 개선
  · 테스트: 197 pass, 0 fail
  · 타입체크: 깨끗
  · 객관적 스코어: 91/100

── 개선 카드 (5개) ────────

[1] Scalability 71→80  ★★☆ (effort: medium)
    그래프 27K → 50K 노드로 성장 필요
    실행: crawl-arxiv --limit 300 × N회 (cron 누적)
    예상: 2-3주

[2] Simplicity 94→96  ★☆☆ (effort: low)
    analysis-tools.ts 444 LOC, resume-ingest.ts 451 LOC 분할
    실행: 각 파일을 3-4 모듈로 쪼갬
    예상: 1-2시간

[3] Performance 91→95  ★★☆ (effort: medium)
    GraphRAG latency 13.8s → 10s
    실행: subgraph retriever 쿼리 최적화, synth cache TTL 확대
    예상: 4-6시간

[4] ear-ingest 쿼리 품질     ★★★ (effort: high)
[5] 벤치마크 3회 평균화       ★☆☆ (effort: low)

어느 카드부터 진행할까요?

T15의 힘은 구체적 실행 방법과 예상 소요 시간을 같이 제시한다는 것. "더 좋게 만들 수 있을까?"라는 막연한 질문을 실행 가능한 선택지로 바꿉니다.

Brain/Ear/Eye 연동

Voice 트리거는 다른 comad 모듈을 호출할 수 있습니다:

T15 검토 시 comad_brain_impact로 레퍼런스 엔티티 영향도 분석
T5 세션 저장 시 주요 결정을 Brain Neo4j의 Claim 노드로 자동 저장
T0 온보딩 시 comad_brain_search로 유사 프로젝트 기존 패턴 조회

커스터마이징

새 트리거를 만들려면 ~/.claude/CLAUDE.md의 Comad Voice 섹션을 편집합니다.

## T<N>. <이름>

**감지 키워드:** "단어1", "단어2", "문장 형태 3", ...

1. <단계 1 설명>
2. <단계 2 설명>
   ...

Nexus autonomous trigger와 중복되지 않게 — Nexus 시스템(CLAUDE.md 상단)이 이미 많은 자동 행동을 정의합니다. 새 트리거는 Nexus에서 커버 안 되는 도메인 특화 작업에만 추가하세요.

관련 파일: ~/.claude/CLAUDE.md (Comad Voice 섹션), voice/, .comad/sessions/, .comad/state.json