아키텍처

.ai-core/ 폴더의 구조와 각 구성요소의 역할을 설명합니다.

디렉토리 구조

.ai-core/                          ← Core Layer (Git 추적)
├── config/                        ← 설정
│   ├── global.json                ← 기능 토글 + 핵심 파라미터
│   ├── detail.json                ← 세부 설정 (자동 생성)
│   ├── detail/                    ← 세부 설정 원본 (기능별 분리)
│   │   ├── session.json, multi-llm.json, security.json
│   │   ├── hooks.json, infra.json
│   │   └── merge.sh              ← detail/ → detail.json 병합
│   └── project-aliases.json       ← 서브 프로젝트 매핑
│
├── scripts/                       ← 공통 스크립트
├── validation/                    ← 체크리스트, 가이드라인, 트러블슈팅
├── multi-llm/                     ← Multi-LLM 브로커 (chorus-cli)
├── tmux/                          ← tmux 운영 레이어
├── data/                          ← Data Layer (Git 제외)
├── docs/                          ← 설계 문서
└── version.json                   ← 버전 관리

Adapter Layer (.claude/)

.claude/
├── settings.json        ← Hook 등록 (절대 경로로 bootstrap.sh 호출)
├── hooks/               ← 라이프사이클 훅
│   ├── bootstrap.sh     ← 모든 hook의 진입점
│   ├── stop.sh, user-prompt-submit.sh, post-tool-use.sh, pre-tool-use.sh
│   └── lib/             ← 기능 모듈 (config-loader, security, test 등)
├── commands/            ← 슬래시 커맨드 (/-xxx)
├── skills/              ← 스킬 (SKILL.md)
└── agents/              ← 서브에이전트

의존 관계

.claude/settings.json
  → bootstrap.sh (절대 경로)
    → hooks/*.sh
      ├── source .ai-core/scripts/*.sh
      ├── read   .ai-core/config/global.json + detail.json
      └── write  .ai-core/data/context/

심볼릭 링크

링크	대상	용도
.claude/config	.ai-core/config/	hooks 설정 접근
~/.config/tmux-notes	.ai-core/tmux/tmux-notes/	tmux 상태바
workspace/{project}/.claude/*	루트 .claude/*	서브 프로젝트 기능 공유

경로 해석

settings.json이 절대 경로로 bootstrap.sh를 호출하므로, 서브 프로젝트에서도 항상 루트 hooks가 실행됩니다.

PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
AI_CORE_DIR="$PROJECT_ROOT/.ai-core"
DATA_AI_DIR="$PROJECT_ROOT/.ai-core/data"