nova: Instructions file for Claude Code

Nova

AI Agent Ops 프레임워크 — Claude Code 플러그인으로 배포. 환경·맥락·품질·협업·진화 5기둥으로 에이전트가 안정적으로 일하도록 만든다. 품질 게이트는 그중 가장 강한 기둥(세션마다 자동 주입되는 유일한 전역 규칙).

Language

• Claude는 사용자에게 항상 한국어로 응답한다.

Nova Quality Gate

이 프로젝트는 Nova Quality Gate 방법론을 따른다. 자동 적용 규칙은 hooks/session-start.sh가 매 세션 주입한다 (경량 요약). 규칙 상세 소스: docs/nova-rules.md (§1~§9).

규칙 수정 시 반드시 session-start.sh와 동기화. CLAUDE.md만 수정하면 사용자에게 반영 안 됨.

Build & Test

bash tests/test-scripts.sh                              # 전체 테스트 (ALL PASS 확인)
bash hooks/session-start.sh | python3 -m json.tool      # session-start JSON 유효성
bash scripts/bump-version.sh <patch|minor|major>         # 버전 범프

릴리스 전 스크립트 단위 검증

서브에이전트 필드 테스트는 설치된 플러그인 버전을 참조하므로, 커밋 전에는 스크립트 출력을 직접 검증한다. 검증 예제는 tests/test-scripts.sh 상단 주석 참조.

검증 관점: 구조(섹션 존재/부재) · 포맷(출력 형식) · 동기화(nova-rules.md, session-start.sh, commands/.md, skills//SKILL.md 일괄 반영)

플러그인 배포 구조 (필수 이해)

Nova는 Claude Code 플러그인이다. 이 CLAUDE.md는 Nova 개발용이지, 플러그인 사용자에게 전달되지 않는다.

플러그인 사용자에게 전달되는 파일:

파일	전달 방식	수정 시 반영
commands/*.md	슬래시 커맨드	플러그인 업데이트 시 자동
agents/*.md	에이전트 타입	플러그인 업데이트 시 자동
skills/*/SKILL.md	스킬	플러그인 업데이트 시 자동
hooks/session-start.sh	SessionStart additionalContext	플러그인 업데이트 시 자동
CLAUDE.md	전달 안 됨	반영 안 됨

session-start.sh 동기화 규칙

hooks/session-start.sh는 매 세션 시작 시 자동 주입되는 유일한 전역 규칙이다. 자동 적용 규칙을 변경하면 반드시 동기화한다:

1. docs/nova-rules.md 수정 (소스)
2. hooks/session-start.sh additionalContext 동기화
3. bash hooks/session-start.sh | python3 -m json.tool  ← JSON 유효성 확인
4. bash tests/test-scripts.sh  ← 동기화 테스트 통과 확인

커맨드/스킬 추가 체크리스트

새 커맨드(.claude/commands/*.md) 또는 스킬(.claude/skills/*/SKILL.md)을 추가할 때 반드시 동기화:

1. hooks/session-start.sh 커맨드 목록에 /nova:{이름} 추가   ← 테스트가 자동 검증
2. .claude/commands/next.md 워크플로우 추천 경로에 추가 (해당 시)
3. 관련 커맨드에 크로스 레퍼런스 추가 (해당 시)
4. tests/test-scripts.sh EXPECTED_COMMANDS 배열에 추가       ← 테스트가 자동 검증
5. bash tests/test-scripts.sh 통과 확인