# 🎯 Taskrの仕組み

## 3.5 動的ガイダンス - AIを軌道に乗せ続ける

### 解決する問題

長い会話の中で、AIが時々「漂流」し始めるのに気づいたことはありませんか？最初は整理されていても、徐々にルールやベストプラクティスを忘れてしまうことがあります。動的ガイダンス（Dynamic Guidance）がこれを解決します！

### 仕組み

AIが Taskr ツールを使用するたびに、レスポンスには3つの部分が含まれます：

```json
{
  "data": {
    // The actual result (task created, note saved, etc.)
  },
  "rules": [
    // Markdown rules relevant RIGHT NOW
    "- Work on one task at a time",
    "- Mark tasks complete before moving on",
    "- Create notes for important discoveries"
  ],
  "actions": [
    // Suggested next steps
    "Call get_task to continue working",
    "Create a PROGRESS note if you completed something major"
  ]
}
```

### コンテキストに応じた適応

ガイダンスは、AIが何をしているかに基づいて変化します：

- **作業開始？** → タスク選択に関するルール
- **ノート作成？** → ノートのタイプと品質に関するルール
- **タスク生成？** → 整理と構造に関するルール
- **ステータス更新？** → 完了基準に関するルール

### 具体的な例

**`get_task` 呼び出し時：**
- ガイダンスに「process-task-list」ルールが含まれる
- 順序立てて作業するようにAIに促す
- 発見したことをノートに記録するよう提案する

**`create_note` 呼び出し時：**
- ノートタイプの定義がガイダンスに含まれる
- タスクへの紐付けをリマインドする
- 特定のコンテンツには特定のタイプを使用するよう提案する

### スマートアクション

ルールに加えて、Taskr はレスポンスで**アクション**も送信します。これらは、AIが今行ったことに合わせて調整された実用的な次のステップです：

- **ワークフローアクション** — 「ステップ1完了、次に関連するタスクリストを掘り下げる」といったステップバイステップのガイダンス
- **ヒントアクション** — 「`get_task_hierarchy` を使用して変更を確認する」や「このマイルストーンのために PROGRESS ノートを作成する」といった提案されるツール呼び出し

これらのアクションはコンテキストに基づいて動的に変化します。タスク完了後は次のタスクの取得を、タスク作成後は階層の確認を提案します。これは、曲がるたびに再計算するGPSのようなものです。

### なぜこれが重要なのか

**動的ガイダンスがない場合：**
- 50件以上のメッセージの後、AIはプロジェクトの慣習を忘れてしまいます。
- 誤ったノートタイプを作成し始めます。
- 複数のタスクを同時に進めてしまうかもしれません。
- ワークフローの要件を見失います。

**動的ガイダンスがある場合：**
- すべてのレスポンスがベストプラクティスを強化します。
- 何百ものタスクにわたってAIの一貫性が保たれます。
- プロジェクトの標準が自動的に維持されます。
- 長いセッションでも「漂流」が起きません。

---

## まとめ - すべてを統合する

これらすべての要素がシステムとしてどのように機能するかをまとめます：

1. **プロジェクト**が異なるビルドを分離します（レシピアプリ vs ワークアウトトラッカー）
2. **タスクリスト**が機能を集中したワークストリームに整理します
3. **タスク**が作業を階層的で追跡可能な断片に細分化します
4. **ノート**が作業の進行に合わせて知識や決定事項を記録します
5. **動的ガイダンス**がAIにベストプラクティスを守らせ続けます

素晴らしいのは、AIが MCP プロトコルを通じてこれらすべてを自動的に処理することです。あなたはただ「レシピアプリを作って」と言うだけで、魔法が起こるのを見守るだけです！

各コンポーネントは、強固な PostgreSQL データベース設計、TypeScript サービス、そして React UI コンポーネントによって支えられていますが、心配する必要はありません。ただ動くのです！ 🚀

---

## 次のステップ

Taskrの仕組みを理解したところで：
1. **[ビルドを開始する](/docs/ja/getting-started/1-1.md)** - この知識を活用しましょう！