Harness Engineering

┌─────────────────────────────────────────────────┐
│                  Harness Loop                    │
│                                                  │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐   │
│  │ Planner  │ →  │Generator │ →  │Evaluator │   │
│  │ Agent    │    │ Agent    │    │ Agent    │   │
│  └──────────┘    └──────────┘    └──────────┘   │
│       ↑                               │          │
│       └───────── 피드백 ──────────────┘          │
│                                                  │
│  ┌──────────────────────────────────────────┐   │
│  │ claude-progress.txt (장기 메모리)         │   │
│  │ + Git History (코드 변경 이력)             │   │
│  └──────────────────────────────────────────┘   │
└─────────────────────────────────────────────────┘

[1. 요구사항 분석]
    ↓
[2. 구현 스펙 문서 작성 (사람 + AI)]
    ↓
[3. 스펙 리뷰 및 승인 (사람)]
    ↓
[4. AI 에이전트가 스펙에 따라 구현]
    ↓
[5. 자동 테스트 검증 (Evaluator)]
    ↓
[6. 사람이 최종 리뷰]

# 프로젝트 CLAUDE.md

## 아키텍처
- 이 프로젝트는 FastAPI + React + PostgreSQL 스택
- API는 /api/v1/ 경로 아래에 구성

## 코딩 규칙
- 타입 힌트 필수 (Python)
- SQL 인젝션 방지: 파라미터화 쿼리만 사용
- 에러 응답은 RFC 7807 형식

## 금지 사항
- .env 파일 수정 금지
- 프로덕션 DB 직접 접근 금지

# Claude Code hooks 예시
# 코드 변경 후 자동으로 테스트 실행
"hooks": {
  "afterEdit": "npm test"
}