claude-mdlisted

# Nova CLAUDE.md Architect 프로젝트의 에이전트 지침 표면을 설계·정리한다. Nova 5기둥 중 **맥락**(세션마다 필요한 지식), **환경**(시크릿/인프라 경계), **협업**(여러 에이전트가 같은 기준으로 일함)에 걸친 스킬이다. ## 핵심 원칙 1. **CLAUDE.md = 운영 헌법 + 라우터** 전체 매뉴얼이 아니라 매 세션 반드시 알아야 하는 불변 사실, 위험 경계, 진입점만 담는다. 상세 절차는 링크하거나 별도 표면으로 이동한다. 2. **분리 기준을 파일로 남긴다** 정리 결과만 만들지 않는다. 다음 에이전트가 새 지침을 추가할 때 같은 판단을 하도록 `Instruction Placement Contract`를 CLAUDE.md/AGENTS.md 또는 `.claude/rules/instruction-placement.md`에 남긴다. 3. **신규는 뼈대를 만들고, 기존은 이력을 보존한다** 신규 프로젝트는 빈칸을 솔직히 남기고 방향을 잡는다. 기존 프로젝트는 먼저 현재 파일을 감사한 뒤 `keep / move / enforce / local-only / remove`로 분류한다. 기존 규칙은 이동하더라도 잃지 않는다. 4. **강제와 조언을 분리한다** CLAUDE.md의 "절대 금지"는 요청일 뿐임을 사용자에게 알린다. 더 강한 차단이 필요하면 `.claude/settings.json`, hooks, CI, 스크립트가 가능한 위치라는 것까지만 안내한다. 강제 도구의 설치·수정은 사용자가 명시적으로 요청했을 때만 진행하며, 본 스킬이 자동으로 권한 설정을 작성하거나 적용하지 않는다. 5. **크로스 에이전트 호환성을 설계한다** Claude Code는 `CLAUDE.md`, Codex 및 여러 에이전트는 `AGENTS.md`를 본다. 신규 프로젝트는 가능하면 `AGENTS.md`를 공통 계약으로 두고 `CLAUDE.md`가 `@AGENTS.md`를 import한다. 기존 CLAUDE 중심 프로젝트는 얇은 AGENTS 브리지로 시작하고, 필요할 때만 canonical 전환한다. ## 적용 규칙 (on-demand 로드) - `docs/nova-rules.md §1` 작업 전 복잡도 + 위험도 판단 - `docs/nova-rules.md §3` 검증 기준 — 요청 범위, 데이터 관통, 경계값 - `docs/nova-rules.md §8` NOVA-STATE.md 세션 상태 유지 - `docs/nova-rules.md §11` 도구 제약 계약 — 하드 가드는 settings/hooks로 강제 - `docs/nova-rules.md §15` Memory Routing — 프로젝트 규칙은 개인 memory 금지, canonical로 ## 모드 판별 | 조건 | 모드 | 동작 | |------|------|------| | 인자 없음 (`/nova:claude-md`) | Guided | 짧은 가이드 출력 후 현재 레포 기준으로 Audit/New