hackathon-risk-analyzer

hackathon-risk-analyzer

目標

開発中またはライブ審査中にプロジェクトの失敗につながる可能性がある技術、統合、デモのリスクを特定して優先順位を付け、実装開始前に各リスクに対する実行可能な緩和策を作成します。

---

トリガー条件

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

• MVP のスコープが確定し、技術スタックが決まっている
• チームが実装を開始しようとしており、リスクの範囲が不明である
• 外部 API、データセット、GPU リソース、ネットワーク依存関係が関係している
• チームが初めて使用するデプロイ環境を利用する
• Phase 4（プロジェクト計画）で、hackathon-scope-cutter の後、最初の hackathon-code-implementer 呼び出しの前に実行します。スコープまたは技術スタックが変更された場合は再実行します

---

入力

入力	型	必須	説明
project_title	string	はい	プロジェクト名
tech_stack	string[]	はい	使用する技術
mvp_features	object[]	はい	hackathon-scope-cutter による MVP 機能
external_dependencies	string[]	はい	必要な外部 API、サービス、データセット、ハードウェア
hackathon_duration_hours	integer	はい	残り時間の合計
team_skills	string[]	いいえ	チームの得意分野（スキルギャップの特定に使用）
demo_environment	string	いいえ	デモの実行環境（例：ローカル、Vercel、Render、ブラウザー）

---

出力

出力	説明
risks	重要度、カテゴリ、緩和策を含む特定済みリスクの一覧
critical_risks	コーディング前に解決する必要がある、重要度が critical のリスク
risk_summary	リスクスコアの集計とプロジェクト全体のリスクレベル
pre_build_actions	実装開始直前に行うアクション
recommended_skills	次に実行することを推奨するスキル

---

ルール

1. すべてのリスクを次のいずれかに分類します：api、data、infra、skill-gap、demo、time。
2. 次の基準で重要度を割り当てます：critical（デモを妨げる）、high（遅延を引き起こす可能性が高い）、medium（対処可能）、low（許容範囲）。
3. critical または high のリスクには、具体的な緩和策と代替策を必ず設定します。
4. 無料プランもオフラインでの代替手段もない外部依存関係は、critical として特定します。
5. GPU、特殊なハードウェア、または独自データセットを必要とする機能は、high または critical として特定します。
6. pre_build_actions では、コーディング開始前にすべての critical リスクに対処する必要があります。
7. リスクを作り上げず、tech_stack、external_dependencies、mvp_features に基づいてすべてのリスクを特定します。

---

出力形式

risks:
  - id: "R-<number>"
    title: "<short risk title>"
    category: "<api|data|infra|skill-gap|demo|time>"
    severity: "<critical|high|medium|low>"
    description: "<what can go wrong>"
    probability: "<high|medium|low>"
    impact: "<what breaks if this occurs>"
    mitigation: "<how to prevent or reduce>"
    fallback: "<what to do if it happens anyway>"

critical_risks:
  - id: "R-<number>"
    title: "<title>"
    blocking_feature: "<which MVP feature this blocks>"

risk_summary:
  total_risks: <number>
  critical: <number>
  high: <number>
  medium: <number>
  low: <number>
  overall_level: "<red|amber|green>"
  assessment: "<one-sentence summary>"

pre_build_actions:
  - priority: <number>
    action: "<what to do>"
    risk_addressed: "R-<number>"
    estimated_minutes: <number>

recommended_skills:
  - "<skill-name>"

---

例

入力：

project_title: "AnchorAI"
tech_stack: ["Python", "FastAPI", "React", "Groq API", "Supabase"]
mvp_features:
  - feature: "GPT-4 emotional check-in conversation"
    fake_ok: false
  - feature: "Session memory"
    fake_ok: false
  - feature: "Crisis escalation (mocked)"
    fake_ok: true
external_dependencies:
  - "Groq API (LLM inference)"
  - "Supabase (database)"
hackathon_duration_hours: 24
team_skills: ["Python", "FastAPI", "React"]
demo_environment: "local + Vercel frontend"

出力：

risks:
  - id: "R-01"
    title: "Groq API rate limit hit during live demo"
    category: "api"
    severity: "critical"
    description: "Free tier Groq API has rate limits that can be exhausted under rapid demo usage"
    probability: "medium"
    impact: "Core chat feature fails live during judging"
    mitigation: "Use a dedicated API key with higher rate limits; implement exponential backoff"
    fallback: "Pre-record the memory recall exchange; play as screen capture if API fails"

  - id: "R-02"
    title: "Supabase cold start delays first DB query"
    category: "infra"
    severity: "high"
    description: "Supabase free tier instances sleep after inactivity; first query can take 3–10 seconds"
    probability: "high"
    impact: "Demo appears broken for first 10 seconds; undermines confidence"
    mitigation: "Warm up Supabase with a ping request at demo start; add a visible loading indicator"
    fallback: "Fall back to in-memory dict for demo session if Supabase is unresponsive"

  - id: "R-03"
    title: "Team unfamiliar with Supabase client library"
    category: "skill-gap"
    severity: "medium"
    description: "Team lists Python/FastAPI skills but not Supabase; integration may take longer than estimated"
    probability: "medium"
    impact: "Session memory feature delayed by 2–4 hours"
    mitigation: "Assign Supabase integration to most experienced backend developer; use official Supabase Python SDK examples"
    fallback: "Replace Supabase with Redis for demo; migrate after hackathon"

  - id: "R-04"
    title: "Context window overflow with long session summaries"
    category: "api"
    severity: "medium"
    description: "Injecting long memory summaries into the system prompt may exceed model context limits"
    probability: "medium"
    impact: "API returns error; chat feature breaks mid-demo"
    mitigation: "Hard-cap session summary at 150 tokens before injection"
    fallback: "Truncate summary silently; log warning"

critical_risks:
  - id: "R-01"
    title: "Groq API rate limit hit during live demo"
    blocking_feature: "GPT-4 emotional check-in conversation"

risk_summary:
  total_risks: 4
  critical: 1
  high: 1
  medium: 2
  low: 0
  overall_level: "amber"
  assessment: "Project is buildable but requires API key upgrade and Supabase warm-up strategy before demo."

pre_build_actions:
  - priority: 1
    action: "Upgrade Groq API key to a plan with higher rate limits and test with 10 rapid requests"
    risk_addressed: "R-01"
    estimated_minutes: 15
  - priority: 2
    action: "Add a /health endpoint that warms Supabase on backend startup; test cold-start behavior"
    risk_addressed: "R-02"
    estimated_minutes: 20
  - priority: 3
    action: "Run Supabase Python SDK quickstart tutorial to confirm team can read/write successfully"
    risk_addressed: "R-03"
    estimated_minutes: 30

recommended_skills:
  - "hackathon-repo-bootstrap"
  - "hackathon-code-implementer"

---

コンテキストファイル

ナレッジベース

• ../hackathon-shared-resources/knowledge/hackathon-common-failures.md
• ../hackathon-shared-resources/knowledge/hackathon-reference-architecture.md
• ../hackathon-shared-resources/knowledge/hackathon-tools.md
• ../hackathon-shared-resources/knowledge/hackathon-mvp-strategy.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