windmill/INDEX.md

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既定）

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）

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