# Claude Code 워크북 — Starter Repo

경량 파이썬 CLI 예제(실습 목표: **500줄 이하** 유지). 워크북: 상위 디렉터리의 [workbook-learner.md](../workbook-learner.md).

## 빠른 시작

```bash
python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python -m todo_cli --help
python -m todo_cli list
```

## 디렉터리 안내

| 경로 | 용도 |
|------|------|
| `Spec.md` | Mission 2 — 인수 테스트·요구사항 |
| `CLAUDE.md` | Mission 1 — `/init` 후 여기에 헌법 보강 |
| `sample-error.log` | Mission 5 — `claude -p` 파이프용 |
| `scripts/protect-files.sh` | Mission 5 — `.env` 등 편집 차단 |
| `scripts/budget_api.py` | Mission 3 — PTC용 50명 스텁 데이터 |
| `docs/ptc-exercise.md` | PTC 설명·도구 제약 메모 |
| `.claude/settings.json` | Mission 5 — PreToolUse 훅 (환경에 맞게 수정) |

## 미션 순서

1. **M1**: `/init`, `CLAUDE.md` 편집, Plan Mode
2. **M2**: `Spec.md` → IT1만 구현, `/compact`
3. **M3**: GitHub MCP, `budget_api.py` + PTC 관찰
4. **M4**: `todo_cli.py` 리뷰 프롬프트
5. **M5**: 훅 차단 + `claude -p`

## 보안

- `.env`는 저장소에 커밋하지 않는다. 예시는 `.env.example` — 로컬 실습 시 복사해 `cp .env.example .env` 후 사용.
- `protect-files.sh`는 실습용 — 프로덕션 정책은 별도 검토.

## 저비용 실습

멀티 에이전트·긴 맥락 구간은 비용이 큼. CLI에서 지원 시 경량 모델을 제한적으로 사용.