setup

새 프로젝트에 Nova Quality Gate를 초기 설정하거나, 기존 프로젝트의 갭을 자동 보완한다.

적용 규칙 (on-demand 로드)

• docs/nova-rules.md §11 도구 제약 계약 (--permissions 옵션 관련)

--permissions 옵션 (Sprint 2a, v5.14.0+)

Nova deny-by-default 템플릿(scripts/permissions-template.json)을 사용자 프로젝트 .claude/settings.json에 병합한다. 기존 설정 보존(덮어쓰기 금지).

bash scripts/setup-permissions.sh                        # 기본 대상: .claude/settings.json
bash scripts/setup-permissions.sh --target <custom.json> # 대체 대상

병합 규칙:

• defaultMode (스칼라): 사용자값 보존
• allow/deny (배열): 합집합 + 중복 제거
• 충돌(user.allow ∩ nova.deny): deny 우선 + stderr CONFLICT: ... → deny wins

최초 실행 시 bootstrap=true session_start 이벤트 기록(scripts/nova-metrics.sh 분모 보정).

Role

너는 Nova Quality Gate 프로젝트 초기화 및 업그레이드 도우미다. 새 프로젝트에는 Nova 구조를 셋업하고, 기존 프로젝트에는 갭을 진단하여 보완한다.

Mode 판별

조건	모드	동작
--check 플래그	Check	Nova 도입 수준 측정 (32항목 (5 Pillar: Structured 5 + Idempotent 4 + NOVA-STATE 7 + X-Verification 9 + Adaptive 7) 점검, 보고만)
--upgrade 플래그	Upgrade	32항목 (5 Pillar: Structured 5 + Idempotent 4 + NOVA-STATE 7 + X-Verification 9 + Adaptive 7) 점검 → 미충족 항목만 보완
CLAUDE.md + NOVA-STATE.md 이미 존재	Upgrade (자동 전환)	초기화 건너뛰고 갭 보완
위 해당 없음	Init (기본)	처음부터 셋업

--check는 "현재 Nova 도입 수준만 확인하고 싶을 때" 사용한다. 변경 없이 점수만 보고. --upgrade는 "이미 Nova를 쓰고 있지만 빠진 부분을 채우고 싶을 때" 사용한다. 기존 프로젝트에서 /setup을 실행하면 자동으로 Upgrade 모드로 전환된다.

Check 모드 실행 흐름 (--check)

1. 아래 Upgrade 모드와 동일한 32항목 (5 Pillar: Structured 5 + Idempotent 4 + NOVA-STATE 7 + X-Verification 9 + Adaptive 7)을 점검한다
2. 결과를 보고만 하고, 파일 수정/생성은 하지 않는다
3. 개선 추천과 실행 가능한 커맨드를 안내한다

Check 모드는 (현재 제거된) 기존 metrics 점검 기능을 대체한다. 동일한 32항목 (5 Pillar: Structured 5 + Idempotent 4 + NOVA-STATE 7 + X-Verification 9 + Adaptive 7), 동일한 5단계 Pillar, 동일한 등급 체계.

Upgrade 모드 실행 흐름

1. 32항목 (5 Pillar: Structured 5 + Idempotent 4 + NOVA-STATE 7 + X-Verification 9 + Adaptive 7)을 점검한다
2. 미충족 항목만 목록으로 표시한다:

   ━━━ Nova Upgrade — 갭 진단 ━━━━━━━━━━━━━━━━
     현재: 12/20 (Level 3)
   
     보완 가능 항목:
     [ ] S3 — Design 문서 없음 → /design 실행 필요
     [ ] I3 — 컨텍스트 체인 없음 → 자동 생성 가능
     [ ] I4 — 의사결정 기록 없음 → docs/decisions/ 생성 가능
     [ ] X2 — 다관점 수집 결과 없음 → /ask 실행 필요
   
     자동 보완 가능: 2건 (I3, I4)
     수동 작업 필요: 2건 (S3, X2)
   
     자동 보완을 진행할까요? (all / 선택: I3,I4 / skip)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   

3. 사용자 승인 시 자동 보완 가능한 항목만 즉시 실행한다:
   • 디렉토리/파일 생성 (docs/decisions/, docs/templates/ 등)
   • CLAUDE.md 누락 섹션 추가
   • 컨텍스트 체인 파일 생성
4. 수동 작업 항목은 실행 가능한 커맨드를 안내한다
5. 보완 후 점수를 재계산하여 개선 결과를 표시한다:

   ━━━ Upgrade 완료 ━━━━━━━━━━━━━━━━━━━━━━━━━━
     12/20 (Level 3) → 14/20 (Level 3)
     +2점: I3 컨텍스트 체인, I4 의사결정 디렉토리
     남은 갭: S3 Design, X2 다관점 수집 결과
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━