운영 매뉴얼

지정하신 소스 문서(raw/CLAUDE.md vs DESIGN.md. What to Put in Each for Claude Code.md)를 분석하여 ‘운영 매뉴얼’ (유형: concept) 지식 개념 노트를 성공적으로 작성 및 저장하였습니다.

• 저장 위치: 운영 매뉴얼.md

---

작성된 노의 요약

1. Frontmatter 규격 준수:
   • type: concept, status: draft, core: false, tags: ['llm', 'agent', 'claude-code', 'ai-coding'], sources, created, updated 등 지정 스키마 충실 반영.
2. 핵심 정의 및 요지:
   • 운영 매뉴얼을 AI 코딩 에이전트(Claude Code)가 실행해야 할 프로젝트 동작 규칙, 빌드/검증 워크플로우, 아키텍처 경로 및 코딩 제약 조건을 명시하는 “HOW” 중심의 지침서로 정의.
   • 시각적 디자인 사양을 담당하는 단일 진실 공급원(DESIGN.md)과의 분명한 역할 분담 명시.
3. 상세 지침 & 6대 핵심 요소:
   • 프로젝트 개요, 명령어, 아키텍처/경로, 구현 규칙, 검증 워크플로우 루프, 디자인 연동 지침 제시.
   • 상시 파일 임포트(@DESIGN.md)로 인한 Context Window 토큰 낭비를 방지하는 조건부 지침(Conditional instructions) 패턴 설명.
4. 구체적 코드 및 시나리오:
   • Next.js / TypeScript / Tailwind CSS / shadcn/ui 스택 기반의 실제 CLAUDE.md 운영 매뉴얼 코드 예시 기재.
   • 대시보드 헤더 드롭다운 메뉴 추가 요청 시 Claude Code가 운영 매뉴얼에 따라 작동하는 4단계 실무 동작 시나리오 포함.
5. 충돌 및 연관 노드 연동:
   • @path 직접 임포트 vs 조건부 지침(Conditional Loading) 방식 간의 맥락 낭비 관련 충돌 분석.
   • Obsidian 위키링크([[CLAUDE.md]], [[DESIGN.md]], [[Claude Code]], [[단일 진실 공급원]], [[Context Window]], [[검증 루프]], [[에이전틱 워크플로우]]) 연동.