AgentPM

apm_task ツールが呼び出されると：

1. パラメータの検証：

   • action パラメータを検証します（必須。有効なアクションのいずれかである必要があります）
   • projectRoot パラメータを検証します（必須。絶対パスである必要があります）
   • アクション固有のパラメータを検証します：
     • get_single の場合：id パラメータを検証します（必須。空でない文字列）
     • filter_by_status の場合：status パラメータを検証します（必須。有効なステータスである必要があります）
     • filter_by_priority の場合：priority パラメータを検証します（必須。有効な優先度である必要があります）
   • オプションのパラメータを検証します：file、withSubtasks、containsText

2. タスクの取得：

   • 指定された場所からタスクファイルを読み取ります（指定されていない場合はデフォルトで apm-artifacts/artifacts.json になります）
   • ファイルからタスクリストを抽出します

3. アクションの実行：

   • action パラメータに基づいて適切なアクションを実行します：
     • get_all：すべてのタスクを返します。オプションでステータスによる絞り込みが可能です
     • get_single：ID を指定して特定のタスクを返します
     • get_next：依存関係とステータスに基づいて次に取り組むタスクを返します
     • filter_by_status：ステータスで絞り込んだタスクを返します
     • filter_by_priority：優先度で絞り込んだタスクを返します

4. アクション固有の処理：

   • get_all および filter_by_status の場合：
     • 指定されている場合はステータスでタスクを絞り込みます
     • withSubtasks パラメータに基づいてサブタスクを処理します
     • サマリーメトリクスを計算します
   • get_single の場合：
     • タスク ID を解析してサブタスクかどうかを判定します
     • 特定のタスクまたはサブタスクを検索します
   • get_next の場合：
     • 完了したタスクを除外します
     • 指定されている場合は優先度とテキストのフィルターを適用します
     • 依存関係が満たされているかを確認します
     • 優先順位を付けて次のタスクを選択します
   • filter_by_priority の場合：
     • 優先度でタスクを絞り込みます
     • withSubtasks パラメータに基づいてサブタスクを処理します
     • サマリーメトリクスを計算します

5. レスポンスの整形：

   • 以下を含む構造化された JSON レスポンスを返します：
     • 要求されたタスクデータ
     • 成功ステータスとメッセージ
     • クエリに関するコンテキスト情報
     • タイムスタンプとセッション情報

6. エラー処理：

   • 検証エラー（必須フィールドの欠落、無効な値）を処理します
   • ファイルが見つからないエラーを処理します
   • タスクが見つからないエラーを処理します
   • コンテキスト情報を含む標準化されたエラーレスポンスを返します

JSON-RPC リクエスト

{
  "method": "apm_task",
  "params": {
    "action": "get_all|get_single|get_next|filter_by_status|filter_by_priority",
    "projectRoot": "/absolute/path/to/project",
    "file": "optional/path/to/artifacts.json",
    "id": "5",  // Required for get_single action
    "status": "pending|in-progress|done|deferred|cancelled",  // For get_all and filter_by_status actions
    "priority": "high|medium|low",  // For get_next and filter_by_priority actions
    "withSubtasks": true|false,
    "containsText": "optional search text"  // For get_next action
  }
}

JSON-RPC レスポンス

get_all および filter_by_status アクションの場合：

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          "tasks": [
            {
              "id": "1",
              "title": "Task 1",
              "description": "Description",
              "status": "pending",
              "priority": "high",
              "dependencies": []
            }
          ],
          "stats": {
            "totalTasks": 10,
            "completedTasks": 3,
            "pendingTasks": 5,
            "inProgressTasks": 2,
            "taskCompletionPercentage": 30
          },
          "filter": "pending"
        },
        "message": "Found 5 tasks with status 'pending'",
        "memory": {
          "sessionId": "session-123456",
          "context": {
            "lastQuery": {
              "action": "get_all",
              "status": "pending",
              "withSubtasks": false
            },
            "projectRoot": "/path/to/project",
            "timestamp": "2023-06-15T10:30:00Z"
          }
        }
      }
    }
  ]
}

get_single アクションの場合：

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          "task": {
            "id": "5",
            "title": "Implement Feature",
            "description": "Create the feature",
            "status": "pending",
            "priority": "high",
            "dependencies": ["3", "4"],
            "details": "Implementation details..."
          }
        },
        "message": "Found task: Implement Feature",
        "memory": {
          "sessionId": "session-123456",
          "context": {
            "lastQuery": {
              "action": "get_single",
              "id": "5"
            },
            "projectRoot": "/path/to/project",
            "timestamp": "2023-06-15T10:30:00Z"
          }
        }
      }
    }
  ]
}

get_next アクションの場合：

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          "nextTask": {
            "id": "2",
            "title": "Next Task",
            "description": "Description",
            "status": "pending",
            "priority": "high",
            "dependencies": []
          },
          "allTasks": [
            /* Array of all tasks */
          ]
        },
        "message": "Found next task: Next Task",
        "memory": {
          "sessionId": "session-123456",
          "context": {
            "lastQuery": {
              "action": "get_next",
              "priority": "high",
              "containsText": null
            },
            "taskCount": 10,
            "readyTaskCount": 3,
            "timestamp": "2023-06-15T10:30:00Z"
          }
        }
      }
    }
  ]
}

filter_by_priority アクションの場合：

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          "tasks": [
            {
              "id": "1",
              "title": "Task 1",
              "description": "Description",
              "status": "pending",
              "priority": "high",
              "dependencies": []
            }
          ],
          "stats": {
            "totalTasks": 10,
            "completedTasks": 3,
            "pendingTasks": 5,
            "inProgressTasks": 2,
            "taskCompletionPercentage": 30
          },
          "filter": "high"
        },
        "message": "Found 5 tasks with priority 'high'",
        "memory": {
          "sessionId": "session-123456",
          "context": {
            "lastQuery": {
              "action": "filter_by_priority",
              "priority": "high",
              "withSubtasks": false
            },
            "projectRoot": "/path/to/project",
            "timestamp": "2023-06-15T10:30:00Z"
          }
        }
      }
    }
  ]
}

apm_task_modify ツールが呼び出されると、次の処理が行われます:

1. パラメータの検証:

   • action パラメータを検証します (必須、有効なアクションのいずれかである必要があります)
   • projectRoot パラメータを検証します (必須、絶対パスである必要があります)
   • 実行するアクションに基づいてアクション固有のパラメータを検証します
   • file などのオプションパラメータを検証します

2. アクションの実行:

   • action パラメータに基づいて適切なアクションを実行します:
     • create: 指定されたプロパティを持つ新しいタスクを作成します
     • update: 既存のタスクを新しい情報で更新します
     • update_status: 1 つ以上のタスクのステータスを変更します
     • delete: プロジェクトからタスクを削除します
     • add_subtask: 既存のタスクにサブタスクを追加します
     • remove_subtask: タスクからサブタスクを削除します
     • clear_subtasks: 1 つ以上のタスクからすべてのサブタスクを削除します
     • expand: AI を使用してタスクをサブタスクに分解します
     • expand_all: AI を使用して保留中のすべてのタスクをサブタスクに展開します

3. ファイル操作:

   • 指定された場所からタスクファイルを読み取ります (指定されていない場合はデフォルトで apm-artifacts/artifacts.json になります)
   • 実行されたアクションに基づいてタスクデータを更新します
   • 更新されたタスクデータをファイルに書き戻します
   • 必要に応じて個別のタスクファイルを生成します (skipGenerate が true でない場合)

4. AI 統合 (特定のアクションの場合):

   • タスクの展開と更新に Claude AI を使用します
   • リサーチに基づく操作のためにオプションで Perplexity AI を使用します
   • タスクのコンテキストに基づいてインテリジェントなサブタスクを生成します

5. レスポンスのフォーマット:

   • 以下を含む構造化された JSON レスポンスを返します:
     • アクション固有のデータ (タスク、サブタスクなど)
     • 成功メッセージ
     • ユーザーへのコミュニケーションガイダンス
     • 次のステップに向けたエージェントへの指示

6. エラー処理:

   • 検証エラー (必須フィールドの欠落、無効な値) を処理します
   • ファイルが見つからないエラーを処理します
   • タスクが見つからないエラーを処理します
   • AI サービスエラーを処理します
   • コンテキスト情報を含む標準化されたエラーレスポンスを返します

JSON-RPC リクエスト

{
  "method": "apm_task_modify",
  "params": {
    "action": "create|update|update_status|delete|add_subtask|remove_subtask|clear_subtasks|expand|expand_all",
    "projectRoot": "/absolute/path/to/project",
    // Action-specific parameters
    // For create action
    "title": "Task Title",
    "description": "Task Description",
    "priority": "high|medium|low",
    "dependencies": "1,2,3",
    "details": "Implementation details",
    "testStrategy": "Test strategy",
    // For update action
    "id": "1",
    "prompt": "Update information",
    "research": true|false,
    "researchOnly": true|false,
    // For update_status action
    "id": "1",
    "status": "pending|in-progress|done|deferred|cancelled",
    // For delete action
    "id": "1",
    "confirm": true|false,
    // For add_subtask action
    "id": "1",
    "title": "Subtask Title",
    "description": "Subtask Description",
    "details": "Subtask details",
    "dependencies": "1.1,1.2",
    "status": "pending|in-progress|done|deferred|cancelled",
    "taskId": "2", // Existing task ID to convert to subtask
    "skipGenerate": true|false,
    // For remove_subtask action
    "id": "1.1",
    "convert": true|false,
    "skipGenerate": true|false,
    // For clear_subtasks action
    "id": "1", // Can be comma-separated for multiple tasks
    "all": true|false, // Clear subtasks from all tasks
    // For expand action
    "id": "1",
    "num": 3, // Number of subtasks to generate
    "prompt": "Additional context",
    "research": true|false,
    "force": true|false,
    // For expand_all action
    "num": 3,
    "prompt": "Additional context",
    "research": true|false,
    "force": true|false,
    // Common optional parameters
    "file": "optional/path/to/artifacts.json"
  }
}

JSON-RPC レスポンス

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          // Action-specific response data
          // For create action
          "task": {
            "id": "1",
            "title": "Task Title",
            "description": "Task Description",
            "status": "pending",
            "priority": "high",
            "dependencies": ["1", "2", "3"],
            "details": "Implementation details",
            "testStrategy": "Test strategy"
          },
          // For update action
          "task": {
            "id": "1",
            "title": "Updated Task Title",
            "description": "Updated Task Description",
            "status": "pending",
            "priority": "high",
            "dependencies": ["1", "2", "3"],
            "details": "Updated implementation details",
            "testStrategy": "Updated test strategy"
          },
          // For update_status action
          "updatedTasks": [
            {
              "id": "1",
              "title": "Task Title",
              "status": "done"
            }
          ],
          // For delete action
          "removedTask": {
            "id": "1",
            "title": "Task Title",
            "description": "Task Description",
            "status": "pending",
            "priority": "high",
            "dependencies": [],
            "details": "Implementation details",
            "testStrategy": "Test strategy"
          },
          // For add_subtask action
          "task": {
            "id": "1",
            "title": "Task Title",
            "description": "Task Description",
            "status": "pending",
            "priority": "high",
            "dependencies": [],
            "details": "Implementation details",
            "testStrategy": "Test strategy",
            "subtasks": [
              {
                "id": "1.1",
                "title": "Subtask Title",
                "description": "Subtask Description",
                "status": "pending",
                "details": "Subtask details",
                "dependencies": []
              }
            ]
          },
          // For remove_subtask action
          "task": {
            "id": "1",
            "title": "Task Title",
            "description": "Task Description",
            "status": "pending",
            "priority": "high",
            "dependencies": [],
            "details": "Implementation details",
            "testStrategy": "Test strategy",
            "subtasks": []
          },
          // For clear_subtasks action
          "updatedTasks": [
            {
              "id": "1",
              "title": "Task Title",
              "description": "Task Description",
              "status": "pending",
              "priority": "high",
              "dependencies": [],
              "details": "Implementation details",
              "testStrategy": "Test strategy"
            }
          ],
          // For expand action
          "task": {
            "id": "1",
            "title": "Task Title",
            "description": "Task Description",
            "status": "pending",
            "priority": "high",
            "dependencies": [],
            "details": "Implementation details",
            "testStrategy": "Test strategy",
            "subtasks": [
              {
                "id": "1.1",
                "title": "Generated Subtask 1",
                "description": "Description for Generated Subtask 1",
                "status": "pending",
                "details": "Details for Generated Subtask 1",
                "dependencies": []
              },
              {
                "id": "1.2",
                "title": "Generated Subtask 2",
                "description": "Description for Generated Subtask 2",
                "status": "pending",
                "details": "Details for Generated Subtask 2",
                "dependencies": ["1.1"]
              },
              {
                "id": "1.3",
                "title": "Generated Subtask 3",
                "description": "Description for Generated Subtask 3",
                "status": "pending",
                "details": "Details for Generated Subtask 3",
                "dependencies": ["1.2"]
              }
            ]
          },
          // For expand_all action
          "expandedTasks": [
            {
              "id": "1",
              "title": "Task Title",
              "description": "Task Description",
              "status": "pending",
              "priority": "high",
              "dependencies": [],
              "details": "Implementation details",
              "testStrategy": "Test strategy",
              "subtasks": [
                {
                  "id": "1.1",
                  "title": "Generated Subtask 1",
                  "description": "Description for Generated Subtask 1",
                  "status": "pending",
                  "details": "Details for Generated Subtask 1",
                  "dependencies": []
                },
                {
                  "id": "1.2",
                  "title": "Generated Subtask 2",
                  "description": "Description for Generated Subtask 2",
                  "status": "pending",
                  "details": "Details for Generated Subtask 2",
                  "dependencies": ["1.1"]
                },
                {
                  "id": "1.3",
                  "title": "Generated Subtask 3",
                  "description": "Description for Generated Subtask 3",
                  "status": "pending",
                  "details": "Details for Generated Subtask 3",
                  "dependencies": ["1.2"]
                }
              ]
            }
          ]
        },
        "message": "Action-specific success message",
        "userCommunication": {
          "message": "User-friendly message about the action result"
        },
        "agentInstructions": "Instructions for the AI agent on how to proceed"
      }
    }
  ]
}

apm_task_generate ツールが呼び出されると、次の処理を行います。

1. パラメータの検証:

   • projectRoot パラメータを検証します (必須、絶対パスである必要があります)
   • オプションのパラメータ file と output を検証します

2. タスクの取得:

   • 指定された場所からタスクファイルを読み取ります (指定がない場合は artifacts.json が既定値です)
   • タスクファイルが見つからない、または空の場合はエラーを返します

3. ディレクトリの準備:

   • 出力ディレクトリが存在することを確認します (必要に応じて作成します)
   • 出力ディレクトリが指定されていない場合は、既定の artifacts ディレクトリを使用します

4. ファイル生成プロセス:

   • タスクデータ内の各タスクについて:
     • タスクの詳細を含む Markdown ファイルを生成します
     • すべてのタスクプロパティ (タイトル、説明、ステータス、依存関係など) を含めます
     • サブタスクが存在する場合は、ネストされたセクションとして整形します
     • タスク ID に基づく一貫した命名規則を使用します
   • 各タスクファイルごとに、構造化された読みやすい形式を作成します

5. レスポンスの整形:

   • 以下を含む構造化された JSON レスポンスを返します:
     • 成功ステータス
     • 生成されたタスクファイルの数
     • artifacts ディレクトリのパス
     • タスクファイルのパス
     • 成功メッセージ
     • コンテキスト情報 (タイムスタンプ、タスク数)

6. エラー処理:

   • ファイルが見つからないエラーを処理します
   • ディレクトリ作成エラーを処理します
   • ファイル書き込みエラーを処理します
   • コンテキスト情報を含む標準化されたエラーレスポンスを返します

JSON-RPC リクエスト

{
  "method": "apm_task_generate",
  "params": {
    "projectRoot": "/absolute/path/to/project",
    "file": "optional/path/to/artifacts.json",
    "output": "optional/path/to/output/directory"
  }
}

JSON-RPC レスポンス

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          "success": true,
          "taskCount": 10,
          "artifactsDir": "/path/to/project/apm-artifacts",
          "tasksPath": "/path/to/project/apm-artifacts/artifacts.json"
        },
        "message": "Generated 10 task files in /path/to/project/apm-artifacts",
        "context": {
          "timestamp": "2023-06-15T10:30:00Z",
          "taskCount": 10
        }
      }
    }
  ]
}

apm_project_brief_create ツールが呼び出されると、次の処理を行います:

1. パラメータの検証:

   • projectRoot パラメータを検証します (必須、絶対パスである必要があります)
   • オプションのパラメータ sessionId、input、stage、response、exportFormat、maxTasks を検証します

2. セッションの処理:

   • sessionId が指定されていない場合は、新しいインタビューセッションを開始します
   • sessionId が指定されている場合は、既存のインタビューセッションを続行します
   • 複数のやり取りにわたって状態を維持します

3. インタビュープロセス:

   • 複数のステージからなる構造化されたインタビューへとユーザーを導きます:
     • プロジェクトの概要: プロジェクトの目的と範囲に関する基本情報
     • 目標とステークホルダー: プロジェクトの目的と関係者
     • 制約事項: 制限、要件、境界
     • テクノロジー: 技術スタックとツール
     • タイムラインとフェーズ: プロジェクトのスケジュールと主要なマイルストーン
     • 機能: 詳細な機能要件
     • レビュー: 最終確認と調整
   • 以前の回答に基づいて、文脈に即した質問を行います
   • ユーザーの回答を処理して、包括的なプロジェクトブリーフを構築します

4. タスクの生成:

   • インタビューの完了後、プロジェクトブリーフに基づいてタスクを生成します
   • 適切な依存関係を備えた構造化されたタスク階層を作成します
   • フェーズと機能ごとにタスクを整理します
   • maxTasks パラメータに基づいてタスクの数を制限します
   • タスクを artifacts.json ファイルに保存します

5. レスポンスのフォーマット:

   • 新しいセッションの場合: インタビュープロセスを追跡するための操作 ID を返します
   • 継続セッションの場合: 次の質問、またはタスク生成の確認を返します
   • 推奨される応答を含む、ユーザーとのコミュニケーションのガイダンスを含めます
   • 明確な次のステップとコマンドを提示します

6. エラー処理:

   • 検証エラーを処理します
   • ファイルが見つからないエラーを処理します
   • インタビュー処理のエラーを処理します
   • コンテキスト情報を含む標準化されたエラーレスポンスを返します

JSON-RPC リクエスト

{
  "method": "apm_project_brief_create",
  "params": {
    "projectRoot": "/absolute/path/to/project",
    "sessionId": "optional-session-id-for-continuing-interviews",
    "input": "optional/path/to/existing/brief.json",
    "stage": "project_overview|goals_and_stakeholders|constraints|technologies|timeline_and_phases|features|review",
    "response": "Your answer to the current interview question",
    "exportFormat": "json|markdown|text",
    "maxTasks": 10
  }
}

JSON-RPC レスポンス

{
  "content": [
    {
      "type": "text",
      "text": {
        "operationId": "project-brief-123456",
        "message": "Project brief interview started",
        "nextAction": "check_operation_status",
        "checkStatusCommand": "apm_project_brief_status --operationId=project-brief-123456",
        "metadata": {
          "userCommunication": {
            "message": "I'm starting the project brief interview process.",
            "expectationType": "immediate",
            "suggestedResponse": "I'll start the project brief interview process. I'll ask you a series of questions to gather information about your project. Let's begin with understanding your project overview."
          }
        }
      }
    }
  ]
}

apm_project_brief_status ツールが呼び出されると、次の処理を行います:

1. パラメータの検証:

   • projectRoot パラメータを検証します (必須、絶対パスである必要があります)
   • operationId パラメータを検証します (必須、空でない文字列)

2. ステータスの取得:

   • AsyncOperationManager から操作ステータスを取得します
   • 操作が見つからない場合はエラーを返します
   • 操作の現在の状態に関する詳細情報を提供します

3. 進行状況のレポート:

   • 現在の進行状況のパーセンテージ (0〜100) を返します
   • 現在のステージについての説明的なメッセージを提供します
   • 作成、更新、完了 (該当する場合) のタイムスタンプを含めます

4. ユーザーとのコミュニケーションのガイダンス:

   • 実行中の操作については、ユーザーに状況を伝えるための推奨される応答を提供します
   • 完了した操作については、次のステップを提案します
   • 失敗した操作については、何が問題だったのか、どのように進めるかを説明します

5. レスポンスのフォーマット:

   • 次の内容を含む構造化された JSON レスポンスを返します:
     • 操作 ID
     • 現在のステータス (pending、running、completed、failed)
     • 進行状況のパーセンテージ
     • ステータスメッセージ
     • タイムスタンプ (created、updated、completed)
     • ユーザーとのコミュニケーションのガイダンス

6. エラー処理:

   • 操作が見つからない場合を処理します
   • ステータス取得中の内部エラーを処理します
   • コンテキスト情報を含む標準化されたエラーレスポンスを返します

JSON-RPC リクエスト

{
  "method": "apm_project_brief_status",
  "params": {
    "projectRoot": "/absolute/path/to/project",
    "operationId": "project-brief-123456"
  }
}

JSON-RPC レスポンス

{
  "content": [
    {
      "type": "text",
      "text": {
        "operationId": "project-brief-123456",
        "status": "running",
        "progress": 65,
        "message": "Generating tasks",
        "createdAt": "2023-06-15T10:30:00Z",
        "updatedAt": "2023-06-15T10:30:05Z",
        "completedAt": null,
        "metadata": {
          "operationType": "task-generation",
          "userCommunication": {
            "message": "Task generation is in progress.",
            "expectationType": "long_wait",
            "estimatedTimeSeconds": 180,
            "suggestedResponse": "The task generation is in progress (65% complete).\n\nWhile we wait, here's what's happening behind the scenes:\n- The AI is analyzing your project requirements\n- It's identifying key components, features, and dependencies\n- It will create a structured task breakdown with proper sequencing\n- Tasks will be saved to the apm-artifacts directory, along with an overall project brief.\n\nYou can ask me to \"check status\" anytime if you'd like an update, or we can discuss other aspects of your project while we wait."
          }
        }
      }
    }
  ]
}

apm_project_brief_result ツールが呼び出されると、次の処理を行います。

1. パラメータの検証:

   • projectRoot パラメータを検証します（必須、絶対パスである必要があります）
   • operationId パラメータを検証します（必須、空でない文字列）

2. 結果の取得:

   • AsyncOperationManager から操作の結果を取得します
   • 結果が利用できない場合（操作が完了していない、または見つからない場合）はエラーを返します
   • 操作が失敗した場合はエラーを返します

3. 結果の処理:

   • 操作の結果から生成されたタスクを抽出します
   • 保存された成果物へのファイルパスを含めます
   • 今後のアクションに備えたセッション情報を提供します
   • ユーザーに次のステップを提案します

4. レスポンスの整形:

   • 次の内容を含む構造化された JSON レスポンスを返します:
     • 操作 ID とステータス
     • タイトル、説明、優先度、詳細を含む生成されたタスク
     • 保存された成果物へのファイルパス（artifacts.json、プロジェクトブリーフの Markdown）
     • セッション情報（sessionId、projectBriefUri、interviewStateUri）
     • 次のアクションの提案とコマンド
     • ユーザーへのコミュニケーションガイダンス

5. エラー処理:

   • 操作が見つからない場合を処理します
   • 操作がまだ実行中の場合を処理します
   • 操作が失敗した場合を処理します
   • コンテキスト情報を含む標準化されたエラーレスポンスを返します

6. ユーザーガイダンス:

   • ユーザーに明確な次のステップを提供します
   • 生成されたタスクを表示および管理するためのコマンドを提案します
   • 結果を説明するユーザーフレンドリーなメッセージを含めます

JSON-RPC リクエスト

{
  "method": "apm_project_brief_result",
  "params": {
    "projectRoot": "/absolute/path/to/project",
    "operationId": "project-brief-123456"
  }
}

JSON-RPC レスポンス

{
  "content": [
    {
      "type": "text",
      "text": {
        "operationId": "project-brief-123456",
        "status": "completed",
        "message": "Task generation completed successfully",
        "tasks": [
          {
            "id": "1",
            "title": "Set up project infrastructure",
            "description": "Initialize the project repository and set up basic infrastructure",
            "status": "pending",
            "priority": "high",
            "dependencies": [],
            "details": "Create the repository, set up CI/CD, and configure development environment"
          }
        ],
        "tasksPath": "/path/to/project/apm-artifacts/artifacts.json",
        "markdownPath": "/path/to/project/apm-artifacts/project-brief.md",
        "sessionId": "session-123456",
        "projectBriefUri": "resource://project-brief-123456",
        "interviewStateUri": "resource://interview-state-123456",
        "nextAction": "view_tasks",
        "suggestedCommand": "apm_get_tasks",
        "userCommunication": {
          "message": "I've successfully generated tasks based on your project brief. You can now view and manage these tasks using the task management tools.",
          "expectationType": "immediate",
          "suggestedResponse": "Great! I've generated a set of tasks based on your project requirements. These tasks have been saved to your project directory and are ready for you to work on. You can view them using the 'apm_get_tasks' command. Would you like to see the tasks now?"
        }
      }
    }
  ]
}

apm_dependencies ツールが呼び出されると、次の処理を行います:

1. パラメータの検証:

   • action パラメータを検証します (必須、有効なアクションのいずれかである必要があります)
   • projectRoot パラメータを検証します (必須、絶対パスである必要があります)
   • アクション固有のパラメータを検証します:
     • add および remove の場合: id および dependsOn パラメータを検証します (必須、空でない文字列)
   • オプションのパラメータを検証します: file

2. タスクの取得:

   • 指定された場所からタスクファイルを読み取ります (指定されていない場合はデフォルトで apm-artifacts/artifacts.json になります)
   • ファイルからタスクリストを抽出します

3. アクションの実行:

   • action パラメータに基づいて適切なアクションを実行します:
     • add: 2 つのタスク間に依存関係を追加します
     • remove: 2 つのタスク間の依存関係を削除します
     • validate: 依存関係の問題 (循環参照、欠落した依存関係) をチェックします
     • fix: 依存関係の問題を自動的に修正します

4. アクション固有の処理:

   • add の場合:
     • 別のタスクに依存するタスクを検索します
     • 依存される側のタスクを検索します
     • 依存関係がすでに存在するかどうかをチェックします
     • 存在しない場合は依存関係を追加します
     • 循環参照がないことを確認するために依存関係を検証します
   • remove の場合:
     • 別のタスクに依存するタスクを検索します
     • 依存関係が存在するかどうかをチェックします
     • 存在する場合は依存関係を削除します
   • validate の場合:
     • 循環依存をチェックします
     • 欠落した依存関係をチェックします
     • 検証結果を返します
   • fix の場合:
     • 欠落した依存関係を削除して修正します
     • 循環依存を循環を断ち切ることで修正します
     • 修正結果を返します

5. ファイル操作:

   • メモリ内のタスクデータを更新します
   • 更新されたタスクをファイルに書き戻します
   • 個別のタスクファイルを生成します

6. レスポンスのフォーマット:

   • 以下を含む構造化された JSON レスポンスを返します:
     • アクション固有のデータ (タスク、依存タスク、検証結果、修正結果)
     • 成功ステータスとメッセージ
     • 操作に関するコンテキスト情報
     • タイムスタンプとセッション情報

7. エラー処理:

   • 検証エラー (必須フィールドの欠落、無効な値) を処理します
   • ファイルが見つからないエラーを処理します
   • タスクが見つからないエラーを処理します
   • 循環依存エラーを処理します
   • コンテキスト情報を含む標準化されたエラーレスポンスを返します

JSON-RPC リクエスト

{
  "method": "apm_dependencies",
  "params": {
    "action": "add|remove|validate|fix",
    "projectRoot": "/absolute/path/to/project",
    // Action-specific parameters
    // For add and remove actions
    "id": "1",
    "dependsOn": "2",
    // Common optional parameters
    "file": "optional/path/to/artifacts.json"
  }
}

JSON-RPC レスポンス

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          // Action-specific response data
          // For add action
          "task": {
            "id": "1",
            "title": "Task 1",
            "description": "Description for Task 1",
            "status": "pending",
            "priority": "high",
            "dependencies": ["2"]
          },
          "dependencyTask": {
            "id": "2",
            "title": "Task 2",
            "description": "Description for Task 2",
            "status": "pending",
            "priority": "medium",
            "dependencies": []
          },
          "tasksPath": "/path/to/project/apm-artifacts/artifacts.json"
        },
        "message": "Added dependency: Task 1 now depends on task 2",
        "memory": {
          "sessionId": "session-123456",
          "context": {
            "taskId": "1",
            "dependsOn": "2",
            "timestamp": "2023-06-15T10:30:00Z"
          }
        }
      }
    }
  ]
}

validate アクションの場合:

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          "validationResults": {
            "circularDependencies": [
              {
                "taskId": "1",
                "path": ["1", "3", "2", "1"]
              }
            ],
            "missingDependencies": [
              {
                "taskId": "4",
                "missingDependencies": ["999"]
              }
            ],
            "valid": false
          },
          "tasksPath": "/path/to/project/apm-artifacts/artifacts.json"
        },
        "message": "Dependency issues detected",
        "memory": {
          "sessionId": "session-123456",
          "context": {
            "timestamp": "2023-06-15T10:30:00Z",
            "validationResults": {
              "circularDependencies": [
                {
                  "taskId": "1",
                  "path": ["1", "3", "2", "1"]
                }
              ],
              "missingDependencies": [
                {
                  "taskId": "4",
                  "missingDependencies": ["999"]
                }
              ],
              "valid": false
            }
          }
        }
      }
    }
  ]
}

fix アクションの場合:

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          "fixResults": {
            "circularDependenciesFixed": [
              {
                "taskId": "2",
                "removedDependencies": ["1"]
              }
            ],
            "missingDependenciesFixed": [
              {
                "taskId": "4",
                "removedDependencies": ["999"]
              }
            ],
            "fixesApplied": true
          },
          "tasksPath": "/path/to/project/apm-artifacts/artifacts.json"
        },
        "message": "Dependency issues fixed",
        "memory": {
          "sessionId": "session-123456",
          "context": {
            "timestamp": "2023-06-15T10:30:00Z",
            "fixResults": {
              "circularDependenciesFixed": [
                {
                  "taskId": "2",
                  "removedDependencies": ["1"]
                }
              ],
              "missingDependenciesFixed": [
                {
                  "taskId": "4",
                  "removedDependencies": ["999"]
                }
              ],
              "fixesApplied": true
            }
          }
        }
      }
    }
  ]
}

apm_complexity_node ツールが呼び出されると、以下の処理を行います。

1. パラメータの検証:

   • projectRoot パラメータを検証します (必須、絶対パスである必要があります)
   • オプションのパラメータ (file、output、markdownOutput、threshold、model、research) を検証します
   • オプションのパラメータにデフォルト値を適用します:
     • output: "apm-artifacts/resources/reports/task-complexity-report.json"
     • markdownOutput: "apm-artifacts/resources/reports/task-complexity-report.md"
     • threshold: 5 (複雑性が 5 以上のタスクが拡張の対象として推奨されます)
     • research: false (Perplexity AI を使用した調査に基づく分析を行うかどうか)

2. タスクの取得:

   • 指定された場所からタスクファイルを読み取ります (指定されていない場合はデフォルトで artifacts.json になります)
   • ファイルからタスクリストを抽出します
   • ステータスが 'done' でも 'cancelled' でもないタスクのみを含めるようにフィルタリングします
   • すでにサブタスクを持つタスクはスキップします (すでに分割されているため)

3. タスク分析プロセス:

   • 各タスクについて:
     • 基本的な複雑性の要因を計算します:
       • 説明の長さ (0～0.2 点)
       • 詳細の長さ (0～0.2 点)
       • 依存関係の数 (0～0.2 点)
       • 優先度の要因 (高: 0.2、中: 0.1、低: 0 点)
       • 技術用語の数 (0～0.2 点)
     • research が有効な場合は、Perplexity AI で分析を強化します
     • Claude AI を使用して 1～10 のスケールで複雑性を分析します
     • 複雑性に基づいてサブタスクの数を推奨します
     • 拡張プロンプトとコマンドを生成します

4. レポートの生成:

   • 以下を含む複雑性レポートを作成します:
     • タスク固有の分析 (ID、タイトル、複雑性スコア、推奨されるサブタスク)
     • 複雑なタスクを分割するための拡張プロンプト
     • タスク拡張のために実行するコマンド
     • メタデータ (生成タイムスタンプ、閾値、タスク数、平均複雑性)
   • 出力ディレクトリが存在することを確認します
   • JSON レポートを指定された出力パスに書き込みます
   • レポートを読みやすい markdown ドキュメントに整形します
   • markdown レポートを指定された markdown 出力パスに書き込みます

5. 応答の整形:

   • 以下を含む構造化された JSON 応答を返します:
     • 完全な複雑性レポートデータ
     • 整形されたレポートの markdown 文字列
     • JSON レポートと markdown レポートの両方の出力ファイルパス
     • タスク分析の統計 (分析されたタスク、検出された複雑なタスク)
     • ユーザーへのコミュニケーションガイダンス
     • 次のステップに向けたエージェントへの指示

6. エラー処理:

   • ファイルが見つからないエラーを処理します
   • ディレクトリ作成エラーを処理します
   • ファイル書き込みエラーを処理します
   • コンテキスト情報を含む標準化されたエラー応答を返します

JSON-RPC リクエスト

{
  "method": "apm_complexity_node",
  "params": {
    "projectRoot": "/absolute/path/to/project",
    "file": "optional/path/to/artifacts.json",
    "output": "apm-artifacts/resources/reports/task-complexity-report.json",
    "markdownOutput": "apm-artifacts/resources/reports/task-complexity-report.md",
    "threshold": 5,
    "model": "optional-model-name",
    "research": false
  }
}

JSON-RPC レスポンス

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "data": {
          "report": {
            "tasks": [
              {
                "taskId": "15",
                "title": "Implement GraphQL API Integration",
                "complexity": 8,
                "recommendedSubtasks": 6,
                "expansionPrompt": "Break down the implementation...",
                "expansionCommand": "apm_task_modify_node --action=expand --id=15 --num=6"
              }
            ],
            "metadata": {
              "generated": "2025-04-24T14:40:04.508Z",
              "threshold": 5,
              "totalTasks": 4,
              "averageComplexity": 7
            }
          },
          "formattedReport": "# Task Complexity Analysis Report\n\n## Report Summary\n\n- **Generated:** 4/24/2025, 7:40:04 AM\n- **Complexity Threshold:** 5\n- **Total Tasks Analyzed:** 4\n- **Average Complexity:** 7.0\n\n## Task Analysis\n\n### 🔴 Task 15: Implement GraphQL API Integration\n\n- **Complexity Score:** **8/10 ⚠️\n- **Recommended Subtasks:** 6\n- **Action Required:** This task should be broken down into subtasks\n- **Expansion Command:** `apm_task_modify_node --action=expand --id=15 --num=6`\n\n**Expansion Guidance:**\nBreak down the implementation of the GraphQL API integration...\n\n---\n\n## Recommendations\n\nThe following tasks should be prioritized for breakdown:\n\n- Task 15: Implement GraphQL API Integration (Complexity: 8/10)\n",
          "jsonOutputPath": "/path/to/project/apm-artifacts/resources/reports/task-complexity-report.json",
          "markdownOutputPath": "/path/to/project/apm-artifacts/resources/reports/task-complexity-report.md",
          "tasksAnalyzed": 4,
          "complexTasks": 1
        },
        "message": "Analyzed 4 tasks and identified 1 complex task that should be broken down.",
        "userCommunication": {
          "message": "I've analyzed your project tasks and identified which ones might benefit from being broken down into subtasks. Here's the complexity report:\n\n# Task Complexity Analysis Report\n\n...",
          "expectationType": "immediate"
        },
        "agentInstructions": "The complexity analysis is complete. The report has been formatted for display and saved as both JSON and Markdown. You can suggest using 'apm_task_modify_node' with the 'expand' action for tasks with high complexity scores."
      }
    }
  ]
}