AI 코딩 하네스

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "test -f .lore/DOMAIN_MAP.md && cat .lore/DOMAIN_MAP.md && echo '\\n---\\n등록된 도메인 토큰:' && grep -h '^slug:' .lore/flows/*.md 2>/dev/null | sed 's/slug: /  - /'"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "f=\"$CLAUDE_TOOL_INPUT_file_path\"; case \"$f\" in *.py|*.ts|*.tsx) lore check \"$f\" 2>&1 | head -30 ;; esac"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "changed=$(git diff --name-only --diff-filter=ACM HEAD 2>/dev/null | grep -E '\\.(py|tsx?)$' || true); [ -z \"$changed\" ] && exit 0; echo '— Lore drift check —'; lore check $changed 2>&1 | tail -15; echo; lore sync --dry-run 2>&1 | tail -5"
          }
        ]
      }
    ]
  }
}

# Lore AI 워크스페이스 규칙
 
이 저장소는 [Lore AI](https://lore-ai.vercel.app) 로 비즈니스 로직을 문서화합니다.
**모든 코드 변경은 다음 규칙을 따라야 합니다.**
 
## 편집 전
 
비즈니스 로직 파일을 수정하기 전, **`.lore/flows/<해당 카테고리>.md`** 와
**`.lore/DOMAIN_MAP.md`** 를 먼저 읽어 도메인 모델을 파악하세요.
 
## 편집 시
 
1. **새 비즈니스 함수/클래스/엔드포인트** 추가
   → `@Domain` + `@BusinessLogic` 주석을 함께 작성
   → 도메인 토큰은 `lore.config.yaml` 의 `domains:` 에 등록된 것만 사용
 
2. **데이터 의미 변경** (ENUM 추가/제거, NULL 정책, 기본값, 임계값 변경,
   백필 없는 마이그레이션 등)
   → `@History: - YYYY-MM-DD: <변경 내용> (백필 여부)` 항목 추가
   → 백필이 없으면 **반드시** 명시 ("백필 없음" 또는 "기존 row 영향 없음")
 
3. 의사결정 배경이 비자명하면 → `@Context: <왜>` 추가
 
## 편집 후
 
`PostToolUse` 훅이 `lore check` 를 자동 실행합니다. 출력에 ERROR 가 보이면
**같은 턴 안에** 어노테이션을 추가/수정하세요. 사용자에게 "끝났다" 보고하기 전에.
 
## 턴 종료 전
 
`Stop` 훅의 drift 결과를 확인. 의미가 큰 변경이면 `lore sync` 를 실행하고
변경된 `.lore/flows/` 도 함께 커밋 후보에 포함시키세요.
 
## 절대 금지
 
- 등록되지 않은 도메인 토큰 사용 (대신 `domains:` 에 먼저 추가 제안)
- `@History` 누락 (의미 변경에 한해)
- `lore check` 실패를 사용자에게 떠넘기지 않기

name: Lore Drift
on:
  pull_request:
    paths: ['**/*.py', '**/*.ts', '**/*.tsx', 'lore.config.yaml']
jobs:
  drift:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }
      - uses: actions/setup-node@v4
        with: { node-version: 20 }
      - run: npm i -g lore-ai
 
      - name: Annotation check
        run: |
          changed=$(git diff --name-only origin/${{ github.base_ref }}... \
                     | grep -E '\.(py|tsx?)$' || true)
          [ -z "$changed" ] && exit 0
          lore check $changed
 
      - name: Drift check
        run: |
          lore sync
          git diff --exit-code .lore/ || {
            echo "::error::어노테이션 변경에 대해 lore sync 결과가 커밋되지 않았습니다."
            exit 1
          }

[1] LLM 이 Subscription 모델에 새 필드 추가 (Edit)
        │
        ▼
[2] PostToolUse 훅 trigger
        │
        ▼  lore check models.py
[3] ERROR [require-domain] Missing @Domain at models.py:42
    fix: Add `@Domain: <token>` (e.g. `@Domain: subscription/master`)
        │
        ▼  stderr 가 LLM 의 다음 컨텍스트로 자동 유입
[4] LLM 의 사고: "@Domain 빠뜨렸네. 다시 Edit 해야겠다."
        │
        ▼  Edit (with annotation)
[5] PostToolUse 훅 retrigger
        │
        ▼  lore check models.py
[6] ✓ Lore check passed.
        │
        ▼
[7] LLM 이 사용자에게 "완료" 보고

# Claude Code 가 .claude/settings.json 을 읽었는지 확인
cat .claude/settings.json | jq .
 
# Claude Code 재시작 후 새 세션에서 hook log 보기
# (Claude Code 의 IDE 로그 또는 터미널 출력)

"matcher": "Edit"     // Write 는 신규 파일이 많으니 제외

[ -f lore.config.yaml ] || exit 0   # lore-ai 미설치 워크스페이스면 skip