hackathon-milestone-monitor

hackathon-milestone-monitor

目標

現在のプロジェクトの進捗を予定しているマイルストーンのスケジュールと照らし合わせ、遅延やリスクを特定し、審査開始前にデモを完成させるための具体的な次のアクションを提案します。

---

トリガー条件

以下の場合にこのスキルを使用します：

• マイルストーンのチェックイン時期になった場合（ハッカソン時間の25％、50％、75％、または90％）
• チームが予定どおりに進んでいるか判断できない場合
• タスクの所要時間が見積もりを大幅に超過した場合
• スコープの変更が発生し、計画を見直す必要がある場合
• フェーズ5（ビルド）で各マイルストーンの節目に達した場合。クリティカルパスが脅かされた際はいつでも再実行します

---

入力

入力	型	必須	説明
project_title	string	はい	プロジェクト名
hackathon_duration_hours	integer	はい	ハッカソンの合計時間（時間単位）
elapsed_hours	number	はい	ハッカソン開始からの経過時間
milestones	object[]	はい	hackathon-task-planner のマイルストーン計画
tasks	object[]	はい	hackathon-task-planner の全タスクリスト
completed_tasks	string[]	はい	完了とマークされたタスクのID（例：["T-01", "T-02"]）
blocked_tasks	object[]	いいえ	現在ブロックされているタスクとその理由
scope_changes	string[]	いいえ	計画後に追加または削除された機能

---

出力

出力	説明
progress_report	完了した作業、残作業、全体のステータスの概要
current_phase	プロジェクトが現在進行しているワークフローフェーズ
milestone_status	各マイルストーンの予定と実際の完了状況
critical_path_health	クリティカルパスが予定どおりか、リスクがあるか、破綻しているか
recommended_actions	直ちに実施する優先度順のアクション
scope_recommendations	スケジュールが遅れている場合に削除または延期する機能
recommended_skills	次に呼び出すことを推奨するスキル

---

ルール

1. percent_complete は completed_tasks / total_tasks × 100 で計算します。
2. percent_time_used は elapsed_hours / hackathon_duration_hours × 100 で計算します。
3. percent_complete < percent_time_used - 15 の場合、ステータスを behind とします。
4. percent_complete > percent_time_used の場合、ステータスを ahead とします。
5. それ以外の場合、ステータスを on_track とします。
6. クリティカルパス上のタスクがブロックされている場合は、critical な推奨アクションを生成します。
7. percent_time_used > 75 で、デモの一連の流れがまだエンドツーエンドで接続されていない場合は、直ちにスコープの削減を推奨します。
8. scope_recommendations で削減する機能は、[FAKE-OK] の実装不可能なものでも、注目を集める機能でもないものに限ります。

---

出力形式

progress_report:
  completed_tasks: <number>
  total_tasks: <number>
  percent_complete: <number>
  percent_time_used: <number>
  status: "<on_track|behind|ahead|critical>"
  summary: "<one-sentence assessment>"

current_phase: "<Phase name and number>"

milestone_status:
  - name: "<milestone name>"
    target_hour: <number>
    actual_hour: "<number or 'not yet reached'>"
    status: "<completed|on_track|at_risk|missed>"
    notes: "<context>"

critical_path_health:
  status: "<healthy|at_risk|broken>"
  bottleneck_task: "<T-XX or null>"
  description: "<what is slowing the critical path>"

recommended_actions:
  - priority: <number>
    urgency: "<immediate|this_hour|today>"
    action: "<what to do>"
    rationale: "<why this matters now>"

scope_recommendations:
  - feature: "<feature name>"
    recommendation: "<cut|defer|simplify>"
    time_saved_hours: <number>
    rationale: "<why this can be safely cut>"

recommended_skills:
  - "<skill-name>"

---

例

入力：

project_title: "AnchorAI"
hackathon_duration_hours: 24
elapsed_hours: 14
milestones:
  - name: "Backend skeleton live"
    target_hour: 7
  - name: "Frontend connected"
    target_hour: 11
  - name: "Memory working"
    target_hour: 16
  - name: "Demo-ready"
    target_hour: 19
tasks:
  - id: "T-01"
    title: "Set up FastAPI and Supabase"
  - id: "T-02"
    title: "Implement OpenAI chat endpoint"
  - id: "T-03"
    title: "Implement session memory"
  - id: "T-04"
    title: "Build chat UI component"
  - id: "T-05"
    title: "Wire frontend to API"
  - id: "T-06"
    title: "Add crisis card (mocked)"
completed_tasks: ["T-01", "T-02", "T-04"]
blocked_tasks:
  - id: "T-03"
    reason: "Supabase cold-start issue unresolved; falling back to Redis"

出力：

progress_report:
  completed_tasks: 3
  total_tasks: 6
  percent_complete: 50
  percent_time_used: 58
  status: "behind"
  summary: "3 of 6 tasks done at 58% time used; session memory is blocked and the demo flow is not yet connected."

current_phase: "Phase 5 — Implementation"

milestone_status:
  - name: "Backend skeleton live"
    target_hour: 7
    actual_hour: 8
    status: "completed"
    notes: "Completed 1 hour late due to Supabase setup delay"
  - name: "Frontend connected"
    target_hour: 11
    actual_hour: "not yet reached"
    status: "at_risk"
    notes: "T-05 (wire frontend) is blocked on T-03 (session memory); UI is built but not connected"
  - name: "Memory working"
    target_hour: 16
    actual_hour: "not yet reached"
    status: "at_risk"
    notes: "T-03 is blocked; 2 hours remain before this milestone"
  - name: "Demo-ready"
    target_hour: 19
    actual_hour: "not yet reached"
    status: "at_risk"
    notes: "Only 5 hours to complete T-03, T-05, T-06 and run full demo flow"

critical_path_health:
  status: "at_risk"
  bottleneck_task: "T-03"
  description: "Session memory (T-03) is blocked; it gates T-05 (frontend wiring) which gates demo-readiness"

recommended_actions:
  - priority: 1
    urgency: "immediate"
    action: "Abandon Supabase for session memory; switch to Redis in-memory fallback — saves 1–2 hours"
    rationale: "T-03 has been blocked for >1 hour; Redis fallback was planned in risk analysis"
  - priority: 2
    urgency: "this_hour"
    action: "Start T-05 (frontend wiring) using a hardcoded stub memory response while T-03 is resolved"
    rationale: "Decouples frontend progress from memory implementation; demo flow can proceed in parallel"
  - priority: 3
    urgency: "today"
    action: "Run full demo flow end-to-end by H+16 even if memory is mocked — freeze demo path first"
    rationale: "Demo-readiness milestone at H+19 requires 3 clean end-to-end runs"

scope_recommendations:
  - feature: "Mood trend dashboard"
    recommendation: "cut"
    time_saved_hours: 3
    rationale: "Not in MVP demo flow; team is behind schedule; dashboard was already deferred"

recommended_skills:
  - "hackathon-code-implementer"
  - "hackathon-deployment-prep"

---

コンテキストファイル

ナレッジベース

• ../hackathon-shared-resources/knowledge/hackathon-mvp-strategy.md
• ../hackathon-shared-resources/knowledge/hackathon-common-failures.md
• ../hackathon-shared-resources/knowledge/hackathon-winning-patterns.md

プレイブック

• ../hackathon-shared-resources/playbooks/hackathon-workflow.md
• ../hackathon-shared-resources/playbooks/24h-hackathon-playbook.md
• ../hackathon-shared-resources/playbooks/36h-hackathon-playbook.md
• ../hackathon-shared-resources/playbooks/48h-hackathon-playbook.md