From 21b7e984dd22cbc986ffe3593f16d5ccb58d6354 Mon Sep 17 00:00:00 2001 From: "developerz-ai[bot]" <286432749+developerz-ai[bot]@users.noreply.github.com> Date: Tue, 10 Nov 2026 02:54:29 +0000 Subject: [PATCH] docs: describe plan_repo planning tools as config.tools.planning The repo-plan endpoint docs named two conflicting hard-coded lists (Read, Glob, Grep vs Read, Glob, Grep, Bash). The real list comes from config.tools.planning via get_tools_for_phase('planning'). All five sites now say so instead of hard-coding a list. Dz-Task-Id: tsk_1a500a911a427cb0273167dfc07eb704 --- docs/mcp-tools.md | 2 +- docs/repo-setup.md | 7 ++++--- src/claude_task_master/api/models_repo.py | 7 ++++--- src/claude_task_master/api/routes_repo.py | 7 ++++--- src/claude_task_master/mcp/server.py | 6 +++--- src/claude_task_master/mcp/tool_handlers_repo.py | 6 +++--- 6 files changed, 19 insertions(+), 16 deletions(-) diff --git a/docs/mcp-tools.md b/docs/mcp-tools.md index 5007a28..d9c97f5 100644 --- a/docs/mcp-tools.md +++ b/docs/mcp-tools.md @@ -655,7 +655,7 @@ This will: Create a plan for a repository without executing any work. -This plan-only mode reads the codebase using read-only tools (Read, Glob, Grep, Bash) and outputs a structured plan with tasks and success criteria. No changes are made to the repository. +This plan-only mode reads the codebase using the planning tools configured in `config.tools.planning` (default: Read, Glob, Grep, WebFetch, WebSearch) and outputs a structured plan with tasks and success criteria. No changes are made to the repository. **Parameters:** | Parameter | Type | Required | Default | Description | diff --git a/docs/repo-setup.md b/docs/repo-setup.md index 78ca3a5..0c4d003 100644 --- a/docs/repo-setup.md +++ b/docs/repo-setup.md @@ -262,18 +262,19 @@ plan_repo( **What Happens:** -1. **Codebase Exploration** - Uses read-only tools (Read, Glob, Grep, Bash) to explore the repository +1. **Codebase Exploration** - Uses the planning tools configured in `config.tools.planning` to explore the repository 2. **Pattern Analysis** - Identifies existing patterns, architecture, and dependencies 3. **Plan Generation** - Creates a structured task list with markdown checkboxes 4. **Success Criteria Definition** - Defines measurable success criteria 5. **State Persistence** - Saves plan to `.claude-task-master/plan.md` and criteria to `.claude-task-master/criteria.txt` -**Read-Only Tools Used:** +**Default Planning Tools (`config.tools.planning`):** - **Read** - Read specific files - **Glob** - Find files by pattern - **Grep** - Search file contents -- **Bash** - Run read-only commands (ls, grep, find, etc.) +- **WebFetch** - Fetch a web page +- **WebSearch** - Search the web **No Changes Made:** diff --git a/src/claude_task_master/api/models_repo.py b/src/claude_task_master/api/models_repo.py index 58608ae..b900f3f 100644 --- a/src/claude_task_master/api/models_repo.py +++ b/src/claude_task_master/api/models_repo.py @@ -119,9 +119,10 @@ def _confine_work_dir(cls, v: str) -> str: class PlanRepoRequest(BaseModel): """Request model for creating a plan for a repository. - Creates a plan without executing any work. Uses read-only tools - (Read, Glob, Grep) to analyze the codebase and outputs a structured - plan with tasks and success criteria. + Creates a plan without executing any work. Uses the planning tools + configured in config.tools.planning (read-only by default) to analyze + the codebase and outputs a structured plan with tasks and success + criteria. Use this after cloning and setting up a repo to plan work before execution, or to get a plan for a new goal in an existing repository. diff --git a/src/claude_task_master/api/routes_repo.py b/src/claude_task_master/api/routes_repo.py index 02316d7..0dcf776 100644 --- a/src/claude_task_master/api/routes_repo.py +++ b/src/claude_task_master/api/routes_repo.py @@ -264,7 +264,8 @@ async def post_setup_repo( summary="Plan Repository Work", description=( "Create a plan for a repository without executing any work. " - "Uses read-only tools to analyze the codebase and generate a task list." + "Uses the configured planning tools to analyze the codebase and " + "generate a task list." ), ) async def post_plan_repo( @@ -272,8 +273,8 @@ async def post_plan_repo( ) -> PlanRepoResponse | JSONResponse: """Create a plan for a repository. - Uses read-only tools (Read, Glob, Grep) to analyze the codebase - and output a structured plan with tasks and success criteria. + Uses the planning tools configured in config.tools.planning to analyze + the codebase and output a structured plan with tasks and success criteria. No changes are made to the repository. Use this after cloning and setting up a repo to plan work before diff --git a/src/claude_task_master/mcp/server.py b/src/claude_task_master/mcp/server.py index bc3918d..f862ece 100644 --- a/src/claude_task_master/mcp/server.py +++ b/src/claude_task_master/mcp/server.py @@ -260,9 +260,9 @@ async def plan_repo( ) -> dict[str, Any]: """Create a plan for a repository without executing any work. - This is a plan-only mode that reads the codebase using read-only tools - (Read, Glob, Grep) and outputs a structured plan with tasks and success - criteria. No changes are made to the repository. + This is a plan-only mode that reads the codebase using the planning tools + configured in config.tools.planning and outputs a structured plan with + tasks and success criteria. No changes are made to the repository. Use this after `clone_repo` and `setup_repo` to plan work before execution, or to get a plan for a new goal in an existing repository. diff --git a/src/claude_task_master/mcp/tool_handlers_repo.py b/src/claude_task_master/mcp/tool_handlers_repo.py index 0f2c310..4d42792 100644 --- a/src/claude_task_master/mcp/tool_handlers_repo.py +++ b/src/claude_task_master/mcp/tool_handlers_repo.py @@ -310,9 +310,9 @@ def plan_repo( ) -> dict[str, Any]: """Create a plan for a repository without executing any work. - This is a plan-only mode that reads the codebase using read-only tools - (Read, Glob, Grep, Bash) and outputs a structured plan with tasks and - success criteria. No changes are made to the repository. + This is a plan-only mode that reads the codebase using the planning tools + configured in config.tools.planning and outputs a structured plan with + tasks and success criteria. No changes are made to the repository. Use this after ``clone_repo`` and ``setup_repo`` to plan work before execution, or to get a plan for a new goal in an existing repository.