{
  "roadmaps": [
    {
      "title": "新規製品Aのリリース",
      "period": "2025-04 to 2025-09",
      "goal": "プロトタイプ→ベータ版→正式リリース",
      "priority": "High",
      "status": "In progress"
    },
    {
      "title": "既存製品Bの大規模アップデート",
      "period": "2025-06 to 2025-10",
      "goal": "セキュリティ強化とUIリニューアル",
      "priority": "Medium",
      "status": "Planning"
    }
  ]
}

{
  "tasks": [
    {
      "name": "UIデザインのモック作成",
      "priority": "High",
      "urgency": "Medium",
      "desire": 5,
      "due": "2025-03-20",
      "estimatedTime": "10h"
    },
    {
      "name": "DBパフォーマンス調査",
      "priority": "Medium",
      "urgency": "High",
      "desire": 2,
      "due": "2025-03-19",
      "estimatedTime": "5h"
    }
  ]
}

【Systemメッセージ】
あなたは私のタスクマネジメントをサポートするプロのコンサルタントです。

【ロードマップ情報】
{JSON or 箇条書き}

【タスク情報】
{JSON or 箇条書き}

【依頼内容】
- 今週取り組むべきタスクを優先度・緊急度・やりたい度などを考慮して上位5つ選んでください。
- なぜそのタスクを選ぶか理由も示してください。
- 必要に応じて所要時間の目安やロードマップ上の意義を説明してください。
- JSON形式で回答してください。

{
  "system": "あなたは私のタスクマネジメントを支援するプロのコンサルタントです。",
  "user": "以下の情報を参考に、今週やるべきタスク上位5件をJSON形式で提案してください。\n\n【ロードマップ情報】\n{\n  \"roadmaps\": [\n    {\n      \"title\": \"新規製品Aのリリース\",\n      \"period\": \"2025-04 to 2025-09\",\n      \"goal\": \"プロトタイプ→ベータ版→正式リリース\",\n      \"priority\": \"High\",\n      \"status\": \"In progress\"\n    }\n  ]\n}\n\n【タスク情報】\n{\n  \"tasks\": [\n    {\n      \"name\": \"UIデザインのモック作成\",\n      \"priority\": \"High\",\n      \"urgency\": \"Medium\",\n      \"desire\": 5,\n      \"due\": \"2025-03-20\",\n      \"estimatedTime\": \"10h\"\n    },\n    {\n      \"name\": \"DBパフォーマンス調査\",\n      \"priority\": \"Medium\",\n      \"urgency\": \"High\",\n      \"desire\": 2,\n      \"due\": \"2025-03-19\",\n      \"estimatedTime\": \"5h\"\n    }\n  ]\n}\n\n上位5件のタスクと、その理由や必要なステップを教えてください。"
}

$ npm run dev

> taskfocus@1.0.0 dev 
> ts-node src/index.ts

TaskFocus: タスク集中支援ツールを起動しました
Notionからデータを取得中...
ロードマップデータベースID: 1b9c2512-a896-800b-9b63-ed86d88202bf
5件のロードマップを取得しました
タスクデータベースID: 1b9c2512-a896-8070-bd51-cb8bbdfeb7a6
利用可能なプロパティ名: [ '重要度', '期限', 'ざっくり見積もり', 'ロードマップ', 'ステータス', 'やりたい度', '概要', '名前' ]
4件のタスクを取得しました
ChatGPTに問い合わせ中...
[
  {
    'タスク名': '大学の履修届提出',
    '重要度': 'High',
    'やりたい度': 0.9,
    '期限': '2025-03-19',
    '見積時間': '2h',
    'ステータス': '未着手',
    'ロードマップ': undefined
  },
  {
    'タスク名': '集中すべきタスクを提案してくれるAIツールのMVP作成',       
    '重要度': 'High',
    'やりたい度': 1,
    '期限': '2025-03-21',
    '見積時間': '10h',
    'ステータス': '未着手',
    'ロードマップ': 'AI Agent 関連のサービスを個人で立ち上げてマネタイズ化'
  },
  {
    'タスク名': '2025年のロードマップを策定',
    '重要度': 'Medium',
    'やりたい度': 0.98,
    '期限': '2025-03-21',
    '見積時間': '2h',
    'ステータス': '未着手',
    'ロードマップ': 'AI Agent 関連のサービスを個人で立ち上げてマネタイズ化'
  },
  {
    'タスク名': '把握すべき基礎用語・知識の範囲を決める',
    '重要度': 'Medium',
    'やりたい度': 0.95,
    '期限': '2025-03-30',
    '見積時間': '1.5h',
    'ステータス': '未着手',
    'ロードマップ': '機械学習：レコメンド・マッチングの基礎用語・知識を把握'
  }
]
あなたは私のタスクマネジメントをサポートするプロのコンサルタントです。

【ロードマップ情報】
[
  {
    "タイトル": "大学でAIの基礎とマネジメントの基礎を身につける",
    "期間": "2023-10-01~2027-09-30",
    "目標": "",
    "重要度": "High"
  },
  {
    "タイトル": "XRで自分にとって心地よい空間を作成できるようになる",
    "期間": "2025-03-17~2025-12-31",
    "目標": "2025年中には建築ビジュアライゼーション関連の一通りの基礎的なスキルを身につける",
    "重要度": "Medium"
  },
  {
    "タイトル": "AI Agent 関連のサービスを個人で立ち上げてマネタイズ化",
    "期間": "2025-03-17~2025-12-31",
    "目標": "2025年中には1万/月を目指す",
    "重要度": "High"
  },
  {
    "タイトル": "AIを使った開発手法に関するキャッチアップ習慣化",
    "期間": "2025-03-17~2025-06-30",
    "目標": "",
    "重要度": "High"
  },
  {
    "タイトル": "機械学習：レコメンド・マッチングの基礎用語・知識を把握",
    "期間": "2025-03-17~2025-04-20",
    "目標": "",
    "重要度": "Medium"
  }
]

【タスク情報】
[
  {
    "タスク名": "大学の履修届提出",
    "重要度": "High",
    "やりたい度": 0.9,
    "期限": "2025-03-19",
    "見積時間": "2h",
    "ステータス": "未着手"
  },
  {
    "タスク名": "集中すべきタスクを提案してくれるAIツールのMVP作成",
    "重要度": "High",
    "やりたい度": 1,
    "期限": "2025-03-21",
    "見積時間": "10h",
    "ステータス": "未着手",
    "ロードマップ": "AI Agent 関連のサービスを個人で立ち上げてマネタイズ化"
  },
  {
    "タスク名": "2025年のロードマップを策定",
    "重要度": "Medium",
    "やりたい度": 0.98,
    "期限": "2025-03-21",
    "見積時間": "2h",
    "ステータス": "未着手",
    "ロードマップ": "AI Agent 関連のサービスを個人で立ち上げてマネタイズ化"
  },
  {
    "タスク名": "把握すべき基礎用語・知識の範囲を決める",
    "重要度": "Medium",
    "やりたい度": 0.95,
    "期限": "2025-03-30",
    "見積時間": "1.5h",
    "ステータス": "未着手",
    "ロードマップ": "機械学習：レコメンド・マッチングの基礎用語・知識を把握"
  }
]

【依頼内容】
- 今週取り組むべきタスクを重要度・期限・やりたい度などを考慮して最大上位5つ選んでください。
- 期限が迫っているものは最優先で選んでください。
- 一週間でタスクに割ける時間は最大でも10時間程度です。
- なぜそのタスクを選ぶか理由も示してください。
- 必要に応じて所要時間の目安やロードマップ上の意義を説明してください。

=== 今週のおすすめタスク ===
以下は、今週取り組むべきタスクを重要度、期限、やりたい度を考慮して選んだ上位5つのタスクです。これらのタスクを選んだ理由も併せて説明します。

1. **大学の履修届提出**
   - **期限**: 2025-03-19
   - **重要度**: High
   - **やりたい度**: 0.9
   - **見積時間**: 2h
   - **理由**: 期限が最も近く、重要度も高いため、最優先で取り組むべきタスクです。大学での学びは長期的なキャリア形成において重要です。

2. **集中すべきタスクを提案してくれるAIツールのMVP作成**
   - **期限**: 2025-03-21
   - **重要度**: High
   - **やりたい度**: 1
   - **見積時間**: 10h
   - **理由**: 期限が迫っており、重要度が高いタスクです。また、やりたい度も高く、ロードマップ「AI Agent 関連のサービスを個人で立ち上げてマネタイズ化」に直結しています。一週間の最大時間（10時間）をこのタスクに充てることを検討してください。

3. **2025年のロードマップを策定**
   - **期限**: 2025-03-21
   - **重要度**: Medium
   - **やりたい度**: 0.98
   - **見積時間**: 2h
   - **理由**: 期限が近いため優先度が高く、やりたい度も非常に高いです。このタスクはロードマップの具体的な方向性を決定するため、重要です。ただし、時間が限られているため、MVP作成の進捗次第で取り組みを検討してください。

4. **把握すべき基礎用語・知識の範囲を決める**
   - **期限**: 2025-03-30
   - **重要度**: Medium
   - **やりたい度**: 0.95
   - **見積時間**: 1.5h
   - **理由**: やりたい度が高く、期限に少し余裕がありますが、ロードマップ「機械学習：レコメンド・マッチングの基礎用語・知識を把握」に関連しており、今後の学習の指針となります。今週中に少しでも時間を割けるように調整してください。

このように、期限が迫っているものを優先しつつ、やりたい度とロードマップの関連性を考慮して選定しました。限られた時間を有効に使い、最もインパクトのあるタスクに取り組むことが重要です。

処理が完了しました。上記のタスクに取り組みましょう！

const prompt = `あなたは私のタスクマネジメントをサポートするプロのコンサルタントです。

【ロードマップ情報】
${JSON.stringify(roadmapsForDisplay, null, 2)}

【タスク情報】
${JSON.stringify(tasksForDisplay, null, 2)}

【依頼内容】
- 今週取り組むべきタスクを重要度・期限・やりたい度などを考慮して、合計時間が${weeklyTaskHours}時間程度になるように選んでください。
- 今日の日付は${new Date().toLocaleDateString('ja-JP', { year: 'numeric', month: '2-digit', day: '2-digit' })}です。
- 期限が迫っているものは最優先で選んでください。
- なぜそのタスクを選ぶか理由も示してください。
- 関連するロードマップがあれば、ロードマップ上の意義を説明してください。
- 着手するおすすめの曜日を示してください。
- タスクを選定し終わったら、これらのタスクを選んだ理由をくわしく説明してください。また、取り組み方のアドバイスや、ポジティブな応援メッセージもお願いします。`

import { BaseChatModel } from "@langchain/core/language_models/chat_models";
import { z } from "zod";

// タスク推薦のスキーマを定義
const taskRecommendationSchema = z.object({
  recommendations: z.array(
    z.object({
      id: z.string().describe("タスクのID"),
      name: z.string().describe("推奨タスクの名前"),
      reason: z.string().describe("タスクを選んだ理由"),
      score: z.number().describe("タスクのおすすめ度（0~100）"),
      recommendedDay: z.string().describe("着手するおすすめの曜日"),
    })
  ),
  comment: z.string().optional().describe("これらのタスクを選んだ理由"),
});

const structuredLlm = this.model.withStructuredOutput(taskRecommendationSchema);
const response = await structuredLlm.invoke([
  ["system", "あなたは私のタスクマネジメントをサポートするプロのコンサルタントです。常に指定されたJSON形式で回答してください。"],
  ["human", prompt]
]);

{
  recommendations: [
    {
      id: '1b9c2512-a896-8050-a2f1-fce313d78500',
      name: '集中すべきタスクを提案してくれるAIツールのMVP作成',
      reason: '重要度が高く、期限が迫っており、進行中のため、早急に進める必要があります。',
      score: 95,
      recommendedDay: '2025-03-19'
    },
    {
      id: '1b9c2512-a896-8010-a16f-fcb686ada3b1',
      name: 'AI Agent開発 2025年のロードマップを策定',
      reason: 'AI Agent個人開発マネタイズという重要なロードマップに関連し、期限が近いため速やかに着手するべきです。',
      score: 85,
      recommendedDay: '2025-03-20'
    },
    {
      id: '1bac2512-a896-80ff-8326-f9faf70f6911',
      name: 'AWS試験申し込み',
      reason: 'やりたい度が高く、期限が近いため、早めに済ませておくと良いでしょう。',
      score: 75,
      recommendedDay: '2025-03-21'
    },
    {
      id: '1b9c2512-a896-80b6-a416-e2491b775501',
      name: '機械学習の把握すべき基礎用語・知識の範囲を決める',
      reason: '機械学習の基礎に関するタスクであり、重要度とやりたい度も高いため、早めに取り組むことが有益です。',
      score: 80,
      recommendedDay: '2025-03-22'
    },
    {
      id: '1b9c2512-a896-80c6-91f3-fb7d6d6155f8',
      name: '「スマホ片手にフリースタイルでAI Agentでコーディングする環境をつくる」をやってみる',
      reason: 'AIでの開発手法キャッチアップの一環であり、やりたい度が高いことから、モチベーションを維持しやすいでしょう。',
      score: 80,
      recommendedDay: '2025-03-23'
    }
  ],
  comment: '今回の選択では、最も期限が迫っているタスクを優先しつつ、重要度とやりたい度も考慮しました。特に「集中すべきタスクを提案してくれるAIツールのMVP作成」は進行中で最優先です。また、「AI Agent開発 2025年のロードマップを策定」や「AWS試験申し込み」な 
ど、早めに取り組むことで他のタスクの準備が整うものも選びました。各タスクはそれぞれのロードマップに関連しており、あなたの長期的な目標達成に寄与します。取り組む際は、計画的に時間を配分し、集中して一気に仕上げることで効率を上げましょう。頑張ってください！あ
なたの努力が素晴らしい結果をもたらすことを信じています！'
}

---
description: TaskFocusのコーディング規約とプロジェクト構造に関するルール
globs:
alwaysApply: true
---

## プロジェクト概要
TaskFocusは、NotionのロードマップとタスクデータをLLM（ChatGPT、Claude等）と連携し、最適なタスク選択を支援するNode.js+TypeScriptで実装されたツールです。

## コーディング規約

### 1. プロジェクト構造
- `/src`: ソースコードディレクトリ
  - `/src/index.ts`: メインアプリケーションエントリポイント
  - `/src/types/`: 型定義
  - `/src/services/`: サービス実装
    - `/src/services/notion.ts`: Notionデータ操作サービス
    - `/src/services/llm/`: LLMサービス実装
      - `/src/services/llm/base.ts`: LLM基本クラス
      - `/src/services/llm/factory.ts`: LLMファクトリークラス
      - `/src/services/llm/index.ts`: LLMサービスのエクスポート
      - `/src/services/llm/models/`: 各LLMモデル実装
      - `/src/services/llm/features/`: LLM機能実装
- `/docs`: ドキュメントディレクトリ
- `/dist`: ビルド後の出力先ディレクトリ

### 2. 命名規則
- **クラス**: PascalCase (例: `NotionService`, `LLMServiceFactory`)
- **関数/メソッド**: camelCase (例: `getTaskRecommendations`, `validateConfig`)
- **変数**: camelCase (例: `notionConfig`, `llmService`)
- **定数**: UPPER_SNAKE_CASE (例: `DEFAULT_MAX_TOKENS`)
- **インターフェース**: PascalCase (例: `TaskRecommendation`, `Roadmap`) ※接頭辞「I」は使用しない
- **型**: PascalCase (例: `NotionConfig`, `LLMConfig`)
- **ファイル名**: 基本的にkebab-case (例: `task-recommendation.ts`)、ただしクラス名に合わせる場合は例外あり

### 3. モジュール構造
- 1ファイル1クラス/1機能を基本とする
- 機能を表すクラスの場合、ファイル名はクラス名を小文字にしたものにする (例: `NotionService` → `notion.ts`)
- インデックスファイル(`index.ts`)は、モジュールの公開APIをエクスポートする用途に限定する
- サービスのインターフェースと実装は分離し、依存性注入を活用する

### 4. エラーハンドリング
- エラーは適切にcatchし、意味のあるエラーメッセージを表示する
- 致命的なエラーは`process.exit(1)`で終了する
- APIリクエストなどでは適切なリトライロジックを実装する
- カスタムエラークラスを作成して、エラータイプを明確にする
- 例外は最上位レイヤーでキャッチし、ユーザーフレンドリーなメッセージに変換する

### 5. 設定管理
- すべての設定は`.env`ファイルで管理し、`.env.example`にサンプルを提供する
- 環境変数はアプリケーション起動時に検証し、必須項目が欠けている場合は明確なエラーメッセージを表示
- 設定は専用のConfigクラスで一元管理し、型安全性を確保する
- zodなどを使用して環境変数の型を検証する

### 6. API通信
- APIキーは環境変数から読み込む
- 外部APIとの通信は適切なエラーハンドリングとリトライメカニズムを実装
- レート制限に配慮し、バックオフ戦略を実装する
- API通信のタイムアウト設定を適切に行う
- API応答のキャッシュ戦略を検討する

### 7. LLM連携
- 複数のLLMプロバイダに対応できる抽象化レイヤーを維持
- プロンプトは別ファイルで管理し、テンプレート化する
- 出力形式は明確に指定し、JSONなどの構造化データとして扱う
- LLMの応答パース処理は堅牢に実装し、予期せぬフォーマットにも対応する
- トークン使用量の最適化とコスト管理を考慮する

### 8. 型安全性
- すべてのデータ構造に適切な型定義を与える
- 特に外部APIとのインタフェースには詳細な型定義を実装
- 汎用的な型は`types/index.ts`にまとめる
- any型の使用を最小限に抑え、unknown型を適切に活用する
- 型アサーションよりも型ガードを優先して使用する

### 9. コードスタイル
- コード整形には`prettier`を使用
- リンティングには`eslint`を使用
- インデントは2スペース
- セミコロンは使用
- 文字列はシングルクォート(`'`)を基本とする
- 複雑なオブジェクトや配列は複数行で記述
- 関数の引数は3つ以下を目安にし、それ以上は設定オブジェクトを使用する

### 10. ドキュメンテーション
- 関数やクラスにはJSDoc形式のドキュメントコメントを付ける
- パブリックAPIには詳細な使用方法のコメントを記述する
- 複雑なロジックには適宜コメントを追加
- TODO/FIXMEコメントにはIssue番号や対応予定内容、担当者を明記
- `README.md`には環境構築手順、使用方法、主要機能の説明を含める

## 依存関係
- Node.js 16以上
- TypeScript 4.9以上
- Notion API Client (`@notionhq/client`)
- OpenAI API及び他LLMプロバイダのAPI
- dotenv (環境変数管理)
- zod (スキーマ検証)
- ESLint & Prettier (コード品質)