cc-cmds

Engineering workflow commands for Claude Code.

Commands

Command	Description	When to use
/cc-cmds:autopilot	목표 하나를 받아 이 세션이 라우터가 되어 스킬 호출을 스스로 정하며 완주시키는 파이프라인의 킥오프와 아침 보고	사용자가 설계 문서·레포·PR·브랜치, 또는 아직 산출물이 없는 목표를 던져 두고 설계·감사·구현·리뷰·머지·적용까지 알아서 이어지게 하고 싶을 때 — 진행은 이 터미널로 중계되고 중요한 결정만 물어 온다. 또는 그렇게 돌린 런의 아침 보고를 받을 때
/cc-cmds:autopilot-router-shift	게이트가 띄운 헤드리스 라우터 샤드가 받는 라우팅 루프 — 스냅숏을 읽어 한 행위를 정하고 게이트에 넘기며, 상한·승인·종단에서 인수인계 행을 남기고 끝난다	이 커맨드는 사람이 치는 것이 아니다 — 라우터 샤드가 받는 스킬이다. 리드 세션이 gate.sh act --kind router-shift 로 교대를 시작할 때 그 샤드가 이 문서를 프롬프트로 받는다
/cc-cmds:design	에이전트 팀을 활용한 기능 설계 토론 진행	사용자가 새 기능 설계/아키텍처 결정/다관점 검토가 필요한 설계 논의를 요청할 때
/cc-cmds:design-analyze	에이전트 팀을 활용한 제3자 설계 문서 다관점 분석 (읽기 전용)	타인이 작성한 설계/리팩토링 문서를 원본 수정 없이 다관점으로 분석하고 분석 산출물(보고서/주석본/피드백)을 생성하고자 할 때
/cc-cmds:design-apply	Claude Design (claude.ai/design) 산출물을 타깃 코드베이스에 통합하는 구현 상세 설계를 agent team으로 작성	design-ingest가 ACCEPT한 핸드오프 추출본을 기반으로 실제 코드베이스에 적용할 구현 상세 설계(impl-design.md)가 필요할 때
/cc-cmds:design-audit	동결된 설계 문서를 독립 리더 팬아웃으로 1회 감사하고 정합 조정 1회 후 정지 (반복 루프 없음)	설계 문서 작성이 끝나 더 이상 수정하지 않을 시점에, 문서를 동결한 뒤 레포 실측 기반 독립 감사로 잔여 결함을 드러내고 이름 붙은 하류 소유자에게 인계하고자 할 때 (design 종단 이후 · design-apply의 impl-design.md · implement 직전)
/cc-cmds:design-audit-unattended	동결된 설계 문서를 독립 리더 팬아웃으로 1회 감사하고 정합 조정 1회 후 정지 (무인 — 사람 확인 없이 park)	자율 파이프라인 드라이버가 감사 스테이지를 헤드리스로 디스패치할 때. 사람이 직접 부르는 경우에는 /cc-cmds:design-audit를 쓸 것
/cc-cmds:design-ingest	Claude Design (claude.ai/design) 핸드오프 번들을 파싱·리뷰하고 ACCEPT/REFINE 판정으로 개선 루프 진행	claude.ai/design 에서 받은 HTML 핸드오프 번들을 검토·수용·재프롬프트할 때 (단일 호출 또는 외부 재실행 사이 반복)
/cc-cmds:design-lite	2인 팀을 활용한 경량 설계 토론	깊은 다관점 분석보다 빠른 방향 설정이 우선될 때 (sonnet 단독 합성으로 미묘한 invariant 누락 가능)
/cc-cmds:design-prompt	Claude Design (claude.ai/design) 실행용 프롬프트+컨텍스트를 base 설계 문서에 authoring하고 붙여넣기 블록 emit (standalone + idempotent, HANDOFF CONTRACT 포함)	base 설계 작성 후, claude.ai/design 에 보낼 의도 중심 프롬프트와 DS 참조를 base 설계 문서에 추가하거나 리뷰 반영본으로 붙여넣기 블록을 재조립할 때
/cc-cmds:design-reconverge	반증된 검증 항목이나 설계 결함 발견 하나에 스코프된 재수렴 — 설계를 고치고 두 값 판정 후 정지 (무인)	자율 파이프라인 드라이버가 사다리 R2(재설계) 레인에 진입할 때. 사람이 참여하는 재설계는 /cc-cmds:design으로 처음부터 다시 수렴할 것
/cc-cmds:design-system	Claude Design (claude.ai/design) DS 생성 프롬프트 emit + DS 번들 ingest로 docs/design-system/ 워크스페이스 구축 (2-phase)	FE 파이프라인 시작 전 프로젝트 전역 design system을 claude.ai/design으로 생성·도입할 때 (1회성 또는 재ingest)
/cc-cmds:design-upgrade	팀 구성 강화 분석 (모델·역할 축)	직전 /design 팀 구성 제안에서 opus 승격이 유의미한 역할이 있는지, 또는 누락 도메인을 메울 신규 역할·과부하 역할 분할이 필요한지 second-opinion으로 검토할 때
/cc-cmds:implement	설계 문서 기반 구현	사용자가 작성된 설계 문서를 바탕으로 단계적 계획을 세우고 실제 구현을 수행하기를 원할 때
/cc-cmds:implement-unattended	설계 문서 기반 구현 (무인 — 사람 확인 없이 오케스트레이터가 라우팅)	자율 파이프라인 드라이버가 세그먼트 구현 스테이지를 헤드리스로 디스패치할 때. 사람이 직접 부르는 경우에는 /cc-cmds:implement를 쓸 것
/cc-cmds:review	에이전트 팀을 활용한 다관점 코드 리뷰	사용자가 PR/로컬 diff/파일 경로에 대한 다관점 코드 리뷰(보안/성능/품질 등)를 요청할 때
/cc-cmds:review-lite	2인 팀을 활용한 경량 코드 리뷰	빠른 코드 리뷰가 목적이고 다관점 심층 분석이 불필요할 때 (큰 PR coverage gap, 미묘한 race condition·authn bypass 검출률 약화 가능)
/cc-cmds:review-unattended	에이전트 팀을 활용한 다관점 코드 리뷰 (무인 — 사람 확인 없이 리포트까지 완주)	자율 파이프라인 드라이버가 리뷰 스테이지를 헤드리스로 디스패치할 때. 사람이 직접 부르는 경우에는 /cc-cmds:review를 쓸 것
/cc-cmds:review-upgrade	리뷰어 구성 강화 분석 (모델·역할 축)	직전 /review Step 3 리뷰어 구성 제안에서 opus 승격이 유의미한 역할이 있는지, 누락된 리뷰 관점을 메울 신규 리뷰어 추가가 필요한지, 또는 과부하 리뷰어 분할이 필요한지 second-opinion으로 검토할 때

Prerequisites

/cc-cmds:design, /cc-cmds:design-audit 등 에이전트 팀 기반 커맨드는 Claude Code 2.1.178 이상이 필요합니다. 팀원은 nameless background task(Agent 도구)로 구동되므로 별도 환경변수 설정은 필요 없습니다(이전에 안내하던 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS는 더 이상 요구되지 않습니다).

완료 알림 (선택)

1단계 — 설치 (필수 선결 조건):

brew install terminal-notifier
brew install jq   # PreToolUse hook 의존성

2단계 — 자연어 요청:

• 단발 알림 — 사용자가 지정한 시점(작업 완료 등)에 모델이 알림을 1회 발송합니다. 여러 시점을 함께 지정하면 각 시점마다 발송합니다.
• 반복 알림 — 모델이 작업이 진행된 매 turn 종료 직전 자체적으로 알림을 발송합니다 (취소할 때까지). hook이 아닌 모델 판단 기반이라, 모델이 turn 끝의 호출을 놓치면 해당 turn 알림이 누락될 수 있습니다.

사용 예시 (대화 중 이렇게 말하면 됩니다):

이렇게 말하세요	동작
"npm run build 끝나면 알림 줘"	단발 — 완료 시 1회
"배포 완료되면 알려줘"	단발 — 완료 시 1회
"PR 리뷰 시작할 때랑 끝날 때 알림 줘"	단발 (2회) — 각 시점 발송
"lint 끝날 때, 빌드 끝날 때, 배포 완료 시 알림 줘"	단발 (3회) — 각 시점 발송
"작업이 70% 정도 끝나면 알림 줘"	단발 — 모델 추정 시점 1회 (근사값)
"매 단계마다 알림 줘"	반복 — 매 turn 발송; "알림 취소"로 중단
"알림 취소"	반복·단발 모두 취소

※ 진행률·중간 지점 표현 주의 — "70% 정도 끝나면", "중간쯤 되면"처럼 백분율이나 중간 지점을 지정하면, 모델이 작업을 진행하며 스스로 추정한 시점에 알림을 1회 보냅니다. 진행률 측정기나 타이머가 따로 동작하는 것이 아니므로 실제 발송 시점은 모델의 주관적 판단에 따른 근사값입니다.

3단계 — 최초 macOS 권한 승인 (1단계 완료 후): 첫 알림 시 macOS 권한 다이얼로그가 표시됩니다. 미리 트리거하려면 "알림 테스트 한 번 해줘"로 발화하여 테스트 알림을 받고 허용을 클릭하세요. (Claude Code의 Bash 권한 다이얼로그는 플러그인의 PreToolUse hook이 자동 승인하므로 표시되지 않습니다 — macOS 알림 권한 다이얼로그만 1회 응답하면 됩니다.) 다이얼로그를 놓쳤다면 시스템 설정 → 알림 → terminal-notifier에서 수동 활성화. 권한 거부 후 복구는 셸에서 terminal-notifier -message 'cc-cmds permission test' -title '[cc-cmds] test' -group cc-cmds-active-notify -execute ':' 직접 실행으로 재트리거 (스킬 bypass와 동일 형식이라 banner 외관이 일치).

terminal-notifier가 없거나 macOS가 아니면 알림은 오류 없이 비활성화됩니다.

Claude Design 핸드오프 품질 리뷰 (선택)

/cc-cmds:design-ingest의 단일 에이전트 리뷰 단계는 환경에 web-design-guidelines 스킬이 설치되어 있으면 UI/접근성/반응형 평가를 그 스킬로 보강합니다. 이 스킬은 vercel-labs agent-skills 리포의 skills-CLI 개별 스킬이며 Claude Code 마켓플레이스 플러그인이 아닙니다 — 따라서 cc-cmds plugin.json의 dependencies로는 표현이 불가능하고, 다음 명령으로 ~/.claude/skills/에 직접 설치합니다.

npx skills add https://github.com/vercel-labs/agent-skills --skill web-design-guidelines

부재 시 design-ingest는 자체 5축 기준(토큰-vs-DS 일치도, a11y 대비비 산술, 반응형/터치 영역 44px+, base 의도 충실도, 시각 품질)으로 fallback하며 리뷰는 중단되지 않습니다. terminal-notifier와 동일 doctrine — plugin.json dependencies로 표현 불가한 선택적 외부 의존성(skills-CLI 개별 스킬·brew 도구 등)은 graceful degradation + README 권장-설치-명령 패턴을 따릅니다.

Install

# 1. 마켓플레이스 등록
/plugin marketplace add Nharu/cc-cmds

# 2. 플러그인 설치
/plugin install cc-cmds@cc-cmds

Usage

/cc-cmds:design <task>
/cc-cmds:design-lite <task>
/cc-cmds:design-audit <design-doc-path> [<note>] [--base]
/cc-cmds:design-upgrade
/cc-cmds:implement <design-doc-path>
/cc-cmds:review [<target>] [<directive>]
/cc-cmds:review-lite [<target>]

각 커맨드의 옵션·입력 형태 세부는 아래 Options 섹션 참조.

Update

/plugin update cc-cmds

Uninstall

/plugin uninstall cc-cmds

Options

• /cc-cmds:autopilot
• /cc-cmds:autopilot-router-shift
• /cc-cmds:design
• /cc-cmds:design-analyze
• /cc-cmds:design-apply
• /cc-cmds:design-audit
• /cc-cmds:design-audit-unattended
• /cc-cmds:design-ingest
• /cc-cmds:design-lite
• /cc-cmds:design-prompt
• /cc-cmds:design-reconverge
• /cc-cmds:design-system
• /cc-cmds:design-upgrade
• /cc-cmds:implement
• /cc-cmds:implement-unattended
• /cc-cmds:review
• /cc-cmds:review-lite
• /cc-cmds:review-unattended
• /cc-cmds:review-upgrade

/cc-cmds:autopilot

Usage: /cc-cmds:autopilot <의도 또는 대상> [--report]

Option	Default	Summary
<의도 또는 대상>	(required)	이 런이 무엇에 관한 것인지 — 설계 문서 경로(.md), 레포 슬러그, PR·브랜치 참조, 또는 아직 산출물이 없는 자유 텍스트 의도. 앵커 종류는 1막의 진입 판정이 정한다.
--report	off (킥오프 모드 — 1막 인터뷰 후 드라이버 기동)	아침 보고 모드. 그 런의 매니페스트·원장·보고서를 읽어 한국어로 렌더링만 하고, 새 런을 시작하지 않는다.

Parsing (<의도 또는 대상>): $ARGUMENTS 전체를 의도로 읽는다. .md 토큰이 있으면 문서 앵커 후보로 우선 해석하되, 최종 앵커 종류는 진입 판정과 사용자 확인이 정한다.

/cc-cmds:autopilot-router-shift

Usage: (사람이 치는 커맨드가 아니다 — gate.sh act --kind router-shift 가 claude -p 로 넘긴다)

autopilot 의 Act 2b 를 대신 도는 헤드리스 좌석이다. 사람에게 묻는 자리도, 배너를 띄우는 자리도, 진행 채널을 여는 자리도 아니다 — 그 셋은 전부 리드에 남는다. 이 샤드가 하는 것은 스냅숏을 읽고 한 행위를 정해 게이트에 넘기는 것뿐이며, 끝날 때 후임이 읽을 인수인계 행 하나를 남긴다.

/cc-cmds:design

Usage: /cc-cmds:design <task>

Option	Default	Summary
<task>	(required)	설계 토론을 진행할 작업 주제 (자유형 한국어/영문 텍스트).

/cc-cmds:design-analyze

Usage: /cc-cmds:design-analyze <design-doc-path> [--no-codebase] [--report-only]

Option	Default	Summary
<design-doc-path>	(required)	분석 대상 제3자 설계 문서 경로 (.md). 원본은 절대 수정하지 않음.
--no-codebase	off (코드베이스 grounding 활성)	코드베이스 교차검증 비활성화 — 문서 자체만으로 분석 (doc-only 모드).
--report-only	off (산출물 대화형 선택)	Step 7 산출물 선택 대화만 건너뛰고 보고서만 생성. Step 6 워크스루(발견별 검토)는 그대로 유지 — 완전 비대화 아님(산출물 범위 한정 플래그).

/cc-cmds:design-apply

Usage: /cc-cmds:design-apply <handoff-extract-path>

Option	Default	Summary
<handoff-extract-path>	(required)	design-ingest가 확정한 안정 사본 (docs/{slug}-fe/handoff-extract.md); 본 스킬이 slug 파싱·출력 경로·원장 키의 단일 앵커

/cc-cmds:design-audit

Usage: /cc-cmds:design-audit <design-doc-path> [<note>] [--base]

Option	Default	Summary
<design-doc-path>	(required)	감사 대상 설계 문서 경로 (.md). 첫 리더 spawn 직전의 sha256으로 동결되며, 감사가 끝날 때까지 어떤 바이트도 수정되지 않는다.
<note>	(optional)	문서 경로 뒤 자유 텍스트. 전 리더에게 축어로 동일하게 주입되는 초점 메모 (리더별로 다르게 주면 보강 통계가 무의미해지므로 금지).
--base	off	base 설계 문서 모드 — 기존 내용의 정합·완결만 감사하고 신규 구현 세부 제안을 금지한다. FE 파이프라인이 확장한 base 문서의 호출 형태.

/cc-cmds:design-audit-unattended

Usage: /cc-cmds:design-audit-unattended <design-doc-path> [<note>] [--base]

Option	Default	Summary
<design-doc-path>	(required)	감사 대상 설계 문서 경로 (.md). 드라이버가 메인 워크트리 절대 경로로 넘긴다. 첫 리더 spawn 직전의 sha256으로 동결된다.
<note>	(optional)	문서 경로 뒤 자유 텍스트. 전 리더에게 축어로 동일하게 주입되는 초점 메모.
--base	off	base 설계 문서 모드 — 기존 내용의 정합·완결만 감사하고 신규 구현 세부 제안을 금지한다.

/cc-cmds:design-ingest

Usage: /cc-cmds:design-ingest <handoff-dir-path>

Option	Default	Summary
<handoff-dir-path>	(required)	기능 핸드오프 디렉토리 (docs/{slug}-fe/handoff); incoming/ 하위 번들을 소비

/cc-cmds:design-lite

Usage: /cc-cmds:design-lite <task>

Option	Default	Summary
<task>	(required)	설계 토론을 진행할 작업 주제 (자유형 한국어/영문 텍스트).

/cc-cmds:design-prompt

Usage: /cc-cmds:design-prompt <base-doc-path>

Option	Default	Summary
<base-doc-path>	(required)	base 설계 문서 경로 (docs/{slug}.md); 본 스킬이 그 안에 CD 프롬프트 섹션을 in-place authoring

/cc-cmds:design-reconverge

Usage: /cc-cmds:design-reconverge <design-doc-path> <scope>

Option	Default	Summary
<design-doc-path>	(required)	재수렴 대상 설계 문서 경로 (.md). 드라이버가 메인 워크트리 절대 경로로 넘긴다.
<scope>	(required)	재수렴 스코프. R<n> 형태의 잔여 검증 항목 식별자이거나, (정규화 파일 경로, 카테고리 태그) 형태의 문제 동일성.

Parsing (<design-doc-path>): $ARGUMENTS의 첫 .md 토큰을 경로로 해석.

Parsing (<scope>): 첫 .md 토큰 이후의 모든 내용. 비어 있으면 중단 기록을 남기고 정지 — 스코프 없는 재설계는 이 스킬이 하는 일이 아니다.

/cc-cmds:design-system

Usage: /cc-cmds:design-system [<intent>]

Option	Default	Summary
[<intent>]	(optional)	DS 생성 의도/스코프 서술용 자유형 토큰 (생략 시 base 설계·코드베이스에서 추론)

/cc-cmds:design-upgrade

Usage: /cc-cmds:design-upgrade

이 커맨드는 별도 인자를 받지 않으며, 직전 /design 팀 구성 제안이 현재 대화 컨텍스트에 있어야 동작한다. 모델 승격과 역할 추가·분할은 강화가 유의미할 때만 제안하며, 그 외에는 유지 사유를 제시한다. 독립 실행 시 결과가 불정확할 수 있다.

/cc-cmds:implement

Usage: /cc-cmds:implement <design-doc-path> [scope-directive]

Option	Default	Summary
<design-doc-path>	(required)	구현 대상 설계 문서 경로 (.md).
[scope-directive]	(optional)	구현 범위를 좁히는 자유형 자연어 지시문 (예: "Phase 2", "PR #0").

Parsing (<design-doc-path>): $ARGUMENTS의 첫 .md 토큰을 경로로 해석. 이후 토큰은 scope directive로 전달.

Parsing ([scope-directive]): 첫 .md 토큰 이후의 모든 내용. 단일 바깥쪽 쌍따옴표로 감싸져 있으면 그 쌍만 제거하고 안쪽 따옴표·구두점은 보존.

/cc-cmds:implement-unattended

Usage: /cc-cmds:implement-unattended <design-doc-path> [scope-directive]

Option	Default	Summary
<design-doc-path>	(required)	구현 대상 설계 문서 경로 (.md). 드라이버가 메인 워크트리 절대 경로로 넘긴다.
[scope-directive]	(optional)	구현 범위를 좁히는 자유형 자연어 지시문. 드라이버가 세그먼트 범위나 사다리 R1의 수정 지시를 이 자리에 싣는다.

Parsing (<design-doc-path>): $ARGUMENTS의 첫 .md 토큰을 경로로 해석. 이후 토큰은 scope directive로 전달.

Parsing ([scope-directive]): 첫 .md 토큰 이후의 모든 내용. 단일 바깥쪽 쌍따옴표로 감싸져 있으면 그 쌍만 제거하고 안쪽 따옴표·구두점은 보존.

/cc-cmds:review

Usage: /cc-cmds:review [<target>] [--base-sha <sha>] [--declared-files <csv>] [<directive>]

Option	Default	Summary
<target>	(optional)	리뷰 대상. 입력 형태에 따라 PR/브랜치/파일 모드로 자동 분기.
<directive>	(optional)	리뷰 관점 지시문. <target> 뒤에 자연어로 부가 (예: "보안 중심으로").
--base-sha <sha>	off (gh pr view … baseRefName 또는 기본 브랜치에서 base 를 스스로 유도)	diff 의 base 를 호출자가 지정. 이미 base 를 아는 호출자(파이프라인 드라이버 등)가 리뷰의 재유도를 없애기 위해 넘긴다. 넘겨받은 값은 신뢰하지 않고 git merge-base --is-ancestor 로 검증하며, 검증에 실패하면 기존 유도로 폴백하고 그 사실을 리포트 개요에 남긴다.
--declared-files <csv>	off (변경 파일 집합을 diff 에서만 유도)	이 변경이 건드리기로 선언된 파일 집합(쉼표 구분). diff 는 무엇이 바뀌었는지만 말하고 무엇이 바뀌기로 되어 있었는지는 말하지 않으므로, 선언 밖 파일이 리뷰 범위 안에 있을 때 그것을 지목할 수 있게 한다.

<target> 입력 형태별 처리:

• PR URL — https://github.com/owner/repo/pull/42 → PR 번호 추출 후 gh pr view로 메타데이터 수집
• PR 번호 — 42 → 숫자만일 때 PR 번호로 해석
• 브랜치 이름 — feat/auth-flow → 하이픈·영문 포함 시 브랜치로 해석, gh pr list --head로 연관 PR 조회
• 파일/디렉토리 경로 — src/auth/ → 파일 리뷰 모드; gh 명령 사용 안 함
• 혼합 (타겟 + 지시문) — PR #42 보안 중심으로 → 타겟 추출 후 지시문을 팀 구성·컨텍스트 패키지·보고서에 전파. 지시문은 깊이/커버리지에만 영향; severity는 기술 기준으로 독립 평가.
• (생략) — 빈 입력 시 현재 브랜치/PR 자동 감지 체인 실행

Parsing (<target>): 숫자만 포함된 토큰(42)은 PR 번호, 하이픈·영문 포함 토큰(42-fix-bug)은 브랜치로 해석. 순수 숫자 + 브랜치 동시 존재 시 PR 번호 우선. 어느 형태에도 해당되지 않으면 AskUserQuestion으로 명확화.

Parsing (<directive>): 지시문은 severity 기준을 변경하지 않음 — 리뷰 팀 구성과 컨텍스트 가중치에만 영향. 인식된 플래그와 그 값을 뺀 나머지가 지시문이며, 인식되지 않는 -- 토큰은 지시문으로 흡수하지 않고 경고 후 폐기한다.

Parsing (--base-sha <sha>): --base-sha 다음 토큰을 값으로 취한다. 값이 없으면 플래그를 무시하고 기존 유도를 쓴다. 이 토큰과 값은 <directive> 추출 전에 인자열에서 제거된다.

Parsing (--declared-files <csv>): --declared-files 다음 토큰을 값으로 취한다. 쉼표·공백을 포함할 수 있으므로 인용 부호로 감싸 넘긴다. 이 토큰과 값은 <directive> 추출 전에 인자열에서 제거된다.

/cc-cmds:review-lite

Usage: /cc-cmds:review-lite [<target>] [--base-sha <sha>] [--declared-files <csv>]

Option	Default	Summary
<target>	(optional)	리뷰 대상 (PR 번호/URL, 브랜치, 파일/디렉토리, 또는 생략 시 현재 브랜치 자동 감지). PR 크기 무관 — 큰 PR 은 report 의 리뷰 범위 섹션에 미커버 영역 명시.
--base-sha <sha>	off (gh pr view … baseRefName 또는 기본 브랜치에서 base 를 스스로 유도)	diff 의 base 를 호출자가 지정. 넘겨받은 값은 git merge-base --is-ancestor 로 검증하며, 실패하면 기존 유도로 폴백하고 그 사실을 리포트 개요에 남긴다. lite 에서도 동일하다.
--declared-files <csv>	off (변경 파일 집합을 diff 에서만 유도)	이 변경이 건드리기로 선언된 파일 집합(쉼표 구분). diff 는 무엇이 바뀌었는지만 말하므로, 선언 밖 파일을 지목할 수 있게 한다.

Parsing (--base-sha <sha>): --base-sha 다음 토큰을 값으로 취한다. 값이 없으면 플래그를 무시하고 기존 유도를 쓴다.

Parsing (--declared-files <csv>): --declared-files 다음 토큰을 값으로 취한다. 쉼표·공백을 포함할 수 있으므로 인용 부호로 감싸 넘긴다.

/cc-cmds:review-unattended

Usage: /cc-cmds:review-unattended <target> [--report-path <abs-path>] [--base-sha <sha>] [--declared-files <csv>] [--basis-cycle <n>] [--basis-review-head <sha>] [--basis-report-path <abs-path>] [--recover --scratch-dir <abs-path>] [<directive>]

Option	Default	Summary
<target>	(required)	리뷰 대상. 드라이버가 방금 만든 PR 번호나 브랜치를 넘긴다.
<directive>	(optional)	리뷰 관점 지시문. severity 기준은 바꾸지 않고 팀 구성과 컨텍스트 가중치에만 영향.
--report-path <abs-path>	off (리포트를 cwd 상대 docs/reviews/{slug}.md에 기록)	뒤에 오는 메인 워크트리 절대 경로에 리포트를 기록한다. 세그먼트 워크트리에서 실행될 때 리포트가 그 트리에 떨어져 철거와 함께 파괴되는 것을 막는 유일한 수단.
--base-sha <sha>	off (gh pr view … baseRefName 또는 기본 브랜치에서 base 를 스스로 유도)	diff 의 base 를 드라이버가 지정. 드라이버는 세그먼트가 갈라져 나온 base 를 이미 알고 있으므로, 이 값이 있으면 리뷰가 그것을 다시 유도하지 않는다. 넘겨받은 값은 신뢰하지 않고 git merge-base --is-ancestor 로 검증하며, 실패하면 기존 유도로 폴백하고 그 사실을 리포트 개요에 남긴다.
--declared-files <csv>	off (변경 파일 집합을 diff 에서만 유도)	이 세그먼트가 건드리기로 선언된 파일 집합(쉼표 구분). diff 는 무엇이 바뀌었는지만 말하고 무엇이 바뀌기로 되어 있었는지는 말하지 않으므로, 선언 밖 파일이 리뷰 범위 안에 있을 때 그것을 지목할 수 있게 한다.
--basis-cycle <n>	off (delta mode is not attempted; review runs full)	The 사이클 number of this segment's most recent FULL review cycle. Required together with --basis-review-head and --basis-report-path to attempt delta mode — all three or none. Any one missing or malformed drops the whole attempt to a full review, never a halt.
--basis-review-head <sha>	off (delta mode is not attempted; review runs full)	The 리뷰 HEAD of the cycle named by --basis-cycle. Verified with git merge-base --is-ancestor against the target head named explicitly, never the caller's ambient HEAD. On failure, or when the three-flag set is incomplete or malformed, the arm falls back to a full review and records why in the report overview.
--basis-report-path <abs-path>	off (delta mode is not attempted; review runs full)	Main-worktree absolute path to the --basis-cycle report — the source of the prior findings this cycle re-adjudicates. Read-only; never written by this arm. Must be absolute or it is treated as malformed.
--recover	off (팀을 띄워 Steps 2~4 를 정상 수행)	Steps 2~4 를 통째로 대체해 팀을 하나도 띄우지 않고, 드라이버가 지명한 위트니스 scratch 디렉터리의 디스크 내용만으로 리포트를 합성한다. 크래시로 죽은 리뷰 스테이지의 부분 산출물을 되살리는 경로.
--scratch-dir <abs-path>	off (지명 없음 — 후보를 열거하고 하나가 지명될 때까지 아무것도 복구하지 않는다)	드라이버가 지명한 위트니스 scratch 디렉터리. 한 논리 세그먼트가 여러 번 재시도되면 디렉터리도 여럿이고 각 시도가 자기 원장에서 epoch 1 을 얻으므로, 어느 시도를 관측했는지 아는 드라이버만 지명할 수 있다.

Parsing (<target>): 숫자만 포함된 토큰은 PR 번호, 하이픈·영문 포함 토큰은 브랜치로 해석. 어느 형태에도 해당되지 않으면 중단 기록을 남기고 정지.

Parsing (<directive>): 타겟과 인식된 플래그(--report-path·--base-sha·--declared-files·--basis-cycle·--basis-review-head·--basis-report-path·--recover·--scratch-dir)의 값을 뺀 나머지. 인식되지 않는 -- 토큰은 지시문으로 흡수하지 않고 폐기하며, 폐기 사실을 리포트에 한 줄 남긴다.

Parsing (--report-path <abs-path>): --report-path 다음 토큰을 값으로 취한다. 값이 없거나 절대 경로가 아니면 중단 기록을 남기고 정지.

Parsing (--base-sha <sha>): --base-sha 다음 토큰을 값으로 취한다. 값이 없으면 플래그를 무시하고 기존 유도를 쓴다 — 정지하지 않는다.

Parsing (--declared-files <csv>): --declared-files 다음 토큰을 값으로 취한다. 쉼표·공백을 포함할 수 있어 드라이버가 인용 부호로 감싸 넘긴다. 값이 없으면 플래그를 무시한다 — 정지하지 않는다.

Parsing (--basis-cycle <n>): --basis-cycle takes the next token as its value. Missing, or not a positive integer, or either companion flag itself missing or malformed → all three are treated as absent for this call; full review, no halt. One overview line records the attempt only when at least one of the three was actually supplied on argv.

Parsing (--basis-review-head <sha>): --basis-review-head takes the next token as its value. Value missing → treated as absent; see --basis-cycle's parse_note for the joint-absence rule.

Parsing (--basis-report-path <abs-path>): --basis-report-path takes the next token as its value. Value missing or not an absolute path → treated as absent; see --basis-cycle's parse_note for the joint-absence rule.

Parsing (--recover): 값을 취하지 않는다. 이 플래그가 없으면 복구 절 전체가 발동하지 않는다.

Parsing (--scratch-dir <abs-path>): --scratch-dir 다음 토큰을 값으로 취한다. 값이 없거나 절대 경로가 아니면 지명이 없는 것으로 다뤄 열거 후 거부 경로로 간다.

/cc-cmds:review-upgrade

Usage: /cc-cmds:review-upgrade

이 커맨드는 별도 인자를 받지 않으며, 직전 /review Step 3 리뷰어 구성 제안이 현재 대화 컨텍스트에 있어야 동작한다. opus 승격, 누락 리뷰 관점 추가, 과부하 리뷰어 분할은 강화가 유의미할 때만 제안하며, 그 외에는 유지 사유를 제시한다. 독립 실행 시 결과가 불정확할 수 있다.

License

MIT