Functional Details

When the apm_project_brief_create tool is called:

Parameter Validation:
- Validates the projectRoot parameter (required, must be an absolute path)
- Validates optional parameters: sessionId, input, stage, response, exportFormat, and maxTasks
Session Handling:
- If no sessionId is provided, starts a new interview session
- If a sessionId is provided, continues an existing interview session
- Maintains state across multiple interactions
Interview Process:
- Guides the user through a structured interview with multiple stages:
  - Project Overview: Basic information about the project's purpose and scope
  - Goals and Stakeholders: Project objectives and involved parties
  - Constraints: Limitations, requirements, and boundaries
  - Technologies: Technical stack and tools
  - Timeline and Phases: Project schedule and major milestones
  - Features: Detailed functionality requirements
  - Review: Final confirmation and adjustments
- Asks contextually relevant questions based on previous answers
- Processes user responses to build a comprehensive project brief
Task Generation:
- After completing the interview, generates tasks based on the project brief
- Creates a structured task hierarchy with proper dependencies
- Organizes tasks by phases and features
- Limits the number of tasks based on the maxTasks parameter
- Saves tasks to the artifacts.json file
Response Formatting:
- For new sessions: Returns an operation ID for tracking the interview process
- For continuing sessions: Returns the next question or confirmation of task generation
- Includes user communication guidance with suggested responses
- Provides clear next steps and commands
Error Handling:
- Handles validation errors
- Handles file not found errors
- Handles interview processing errors
- Returns standardized error responses with context information

JSON-RPC Request

{
  "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 Response

{
  "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

Categories

Current Category: co-pilot

agent-pm