# INDEX.md

## Start Here
1. `AGENTS.md`（存在する場合）
2. `HARNESS.md`
3. `HANDOFF.md`
4. `SERVER_SETUP.md`
5. 今回タスクの3行（Purpose/Target/Done）

## このリポジトリで優先的に見る場所
- 運用メモ:
  - `HANDOFF.md`
  - `SERVER_SETUP.md`
- 実装・設定:
  - `workflows/`
  - `mcp/`
  - `docker-compose-dev.yml`
  - `docker-compose.yml`
  - `sync_to_git.sh`
- 実行時状態:
  - `.env`（読み取りのみ・値の露出禁止）
  - `.mcp.json`（読み取りのみ・値の露出禁止）
- 記録:
  - `state/tasks/`
  - `tests/golden/`

## 作業手順（固定）
1. 依頼3行を確定する。
2. 変更対象を最小ファイルに絞る。
3. 小さい差分で実装する。
4. 検証を実行する（HARNESSのL1/L2/L3）。
5. `state/tasks/<task_id>.md` に記録する。
6. 必要なら `HANDOFF.md` / `SERVER_SETUP.md` を更新する。

## Agent入力テンプレート
- Purpose: ...
- Target: ...
- Done: ...
- Constraints: ...
- Relevant files:
  - path1
  - path2
- Verification commands:
  - cmd1
  - cmd2

## 検証コマンド（このrepo既定）
```powershell
docker compose -f docker-compose-dev.yml config
docker compose -f docker-compose-dev.yml up -d db windmill_server
docker compose -f docker-compose-dev.yml ps
docker compose -f docker-compose-dev.yml exec -T windmill_server curl -fsS http://localhost:8000/api/version
docker compose -f docker-compose-dev.yml logs --tail=200 windmill_server
```

## 完了条件（DoD）
- 要求された挙動を満たす。
- 検証結果が記録されている。
- 運用手順影響がある場合、関連ドキュメントが更新されている。
- 未解決リスクと次アクションが明示されている。