extend_current_task

Add subtasks to break complex work into manageable pieces, creating hierarchical structures for organized problem-solving.

Instructions

Add a subtask to organize and decompose work. Creates hierarchical structure for complex tasks. Subtasks help break down work into manageable pieces. You can work on tasks in any order using switch_focus. Example: Task A → Task B → Task C creates a nested structure, but you can jump between them freely. For unrelated work, use create_new_task.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`title`	Yes	Brief task description (max 256 chars)
`body`	Yes	Full task context, notes, and details

Implementation Reference

src/handlers.py:54-74 (handler)

Main handler function that executes the tool: calls task_manager.extend_current_task and formats response with focus path and warnings.

async def handle_extend_current_task(self, title: str, body: str) -> Dict[str, Any]:
    try:
        task = self.task_manager.extend_current_task(title, body)
        response = {
            "task_id": task.id,
            "message": f"Added subtask: {task.title}",
            "focus_path": self.task_manager.get_focus_path(),
            "is_current": True,
            "hint": "Use switch_focus to work on any task in any order",
        }

        # Add warning if getting deep
        stack_depth = self.task_manager.get_stack_depth()
        if stack_depth >= 4:
            response["info"] = (
                f"Stack is {stack_depth} levels deep. Consider using create_new_task for unrelated work."
            )

        return response
    except ValueError as e:
        return {"error": str(e)}

src/handlers.py:253-270 (schema)

Tool schema definition including input schema for title and body parameters.

Tool(
    name="extend_current_task",
    description="Add a subtask to organize and decompose work. Creates hierarchical structure for complex tasks. Subtasks help break down work into manageable pieces. You can work on tasks in any order using switch_focus. Example: Task A → Task B → Task C creates a nested structure, but you can jump between them freely. For unrelated work, use create_new_task.",
    inputSchema={
        "type": "object",
        "properties": {
            "title": {
                "type": "string",
                "description": "Brief task description (max 256 chars)",
            },
            "body": {
                "type": "string",
                "description": "Full task context, notes, and details",
            },
        },
        "required": ["title", "body"],
    },
),

src/server.py:52-54 (registration)

Registration of the tool handler in the call_tool dispatcher map.

"extend_current_task": lambda: handlers.handle_extend_current_task(
    arguments["title"], arguments["body"]
),

src/task_manager.py:99-116 (helper)

Core logic method that creates and adds a new SubTask to the current main task stack.

def extend_current_task(self, title: str, body: str) -> SubTask:
    if self.is_zen_state:
        raise ValueError(
            "Cannot extend task in zen state. Create a new task first."
        )

    if self.current_task:
        self.current_task.status = TaskStatus.PENDING

    new_sub_task = SubTask(title=title, body=body)
    new_sub_task.status = TaskStatus.CURRENT

    last_main_task = self.global_tasks[-1]
    last_main_task.add_sub_task(new_sub_task)

    self._manual_current_task = None  # Clear manual focus

    return new_sub_task

Aidderall MCP Server