Tool Name

Parameters

Description

assess_project_readiness

path: str = "."

Scan the workspace and evaluate its onboarding readiness score (0-100%) against required Project Brain documents.

project_readiness_report

path: str = "."

Generate a formatted Markdown project readiness report showing missing files, scoring audit, and recommended actions.

bootstrap_project

path: str = "."

Auto-generate template files and directories (PRD, milestones, active tasks, config yaml) to instantly onboard an unknown repository.

adopt_existing_project

path: str = "."

Scan an existing legacy codebase (directories, package lists, readmes) and generate context, PRDs, milestones, and audit tasks.

doctor

path: str = "."

Check the diagnostic health and configuration integrity of the Project Brain and MCP server.

reset_project_brain

path: str = "."

Wipe all Project Brain configuration, tasks, and context metadata inside the selected project. Leaves git and source code untouched.

archive_project_brain

path: str = "."

Archive current Project Brain settings and context files to .project_brain_archive/ before a reset or pivot, preserving history.

Tool Name

Parameters

Description

generate_project_brain

path: str = "."

Generate a complete aggregated Project Brain dashboard showing current status, phase, active/blocked tasks, recent changes, and recommendations.

next_best_action

path: str = "."

Intelligently calculate and recommend the next best task to work on based on phase, priority, dependencies, and file hints.

start_session

path: str = "."

Start a development session. Loads state, PRD, active tasks, and latest handoff to generate a detailed Session Brief for the AI.

end_session

session_summary: str, known_issues: str = "", path: str = "."

End the current session, update progress, and generate a handoff file (does not auto-commit changes).

prepare_commit

session_summary: str, path: str = "."

Analyze modified workspace files and generate a suggested conventional git commit message and summary for approval.

commit_changes

message: str, path: str = "."

Stage all workspace changes and commit them to Git with the approved commit message.

Tool Name

Parameters

Description

create_task

title: str, description: str, phase: str = "", priority: str = "medium", depends_on: str = "", path: str = "."

Create a new task with phase, priority, dependencies, and description.

update_task

task_id: str, title: str = "", description: str = "", phase: str = "", status: str = "", priority: str = "", depends_on: str = "", path: str = "."

Update a task's status, priority, or description by ID.

complete_task

task_id: str, notes: str = "", path: str = "."

Mark a task as completed with optional notes.

next_task

path: str = "."

Get the highest-priority task that is ready to work on (dependencies met, current phase).

blocked_tasks

path: str = "."

List all tasks that are blocked, either by dependencies or explicitly.

list_tasks

phase: str = "", status: str = "", path: str = "."

List all active tasks, optionally filtered by phase or status.

Tool Name

Parameters

Description

get_current_phase

path: str = "."

Get the current active phase and its status.

set_phase

phase_name: str, description: str = "", path: str = "."

Set the current active development phase. Only tasks in this phase are considered 'in scope'.

complete_phase

notes: str = "", path: str = "."

Mark the current phase as completed and optionally advance to the next phase.

next_phase

phase_name: str, description: str = "", path: str = "."

Mark current phase as complete and advance to the next phase in sequence.

list_phases

path: str = "."

List all phases and their status (completed, active, pending).

add_milestone

name: str, target_date: str = "", features: str = "", path: str = "."

Define a milestone with a target date and associated features.

list_milestones

path: str = "."

Show all milestones and their status.

Tool Name

Parameters

Description

get_prd

document: str = "PRD", path: str = "."

Retrieve a PRD document (PRD, VISION, SCOPE, REQUIREMENTS). Returns the content of the specified document.

update_prd

document: str, content: str, path: str = "."

Create or update a PRD document (PRD, VISION, SCOPE, REQUIREMENTS).

summarize_prd

path: str = "."

Summarize key requirements from PRD documents into a concise bullet list.

compare_work_to_prd

path: str = "."

Compare current project context and tasks against PRD requirements to check alignment.

extract_requirements

path: str = "."

Parse PRD markdown files to extract structured requirements and save them into requirements.json.

verify_requirements

feature_name: str = "", path: str = "."

Scan codebase to map requirement keywords and verify their implementation status and feature coverage.

verify_outcome

task_id: str, path: str = "."

Perform outcome audits verifying user flows, business goals, and objective completion based on target tasks.

Tool Name

Parameters

Description

sync_workspace

path: str = "."

Scan the physical workspace (Git diff, new files, current branch, commits) and compare to the Todo plan to auto-detect finished work.

verify_work

task_id: str, path: str = "."

Perform deep sanity, test, git diff, and architecture checks against a task to output a reality verification dossier.

project_dashboard

path: str = "."

Generate a unified Project Manager Dashboard combining phase state, todo progress, git status, architecture violations, and a project health score.

Tool Name

Parameters

Description

generate_handoff

session_summary: str = "", known_issues: str = "", path: str = "."

Generate a session summary capturing what was done, what's next, and current project state for handoff to another AI.

get_last_handoff

path: str = "."

Retrieve the most recent AI handoff document so a new AI session has full context.

list_handoffs

path: str = "."

List all AI session handoffs with dates.

Tool Name

Parameters

Description

validate_architecture

path: str = "."

Scan the codebase and validate imports/technologies against the project's architectural guidelines and forbidden tools.

build_dependency_graph

path: str = "."

Scan files and construct a complete mapping of dependencies and references in the project.

impact_analysis

file_path: str, path: str = "."

Calculate direct and transitive downstream files affected if a given file is modified.

Tool Name

Parameters

Description

init_context

path: str = "."

Initialize or auto-detect project context. Scans project files to detect tech stack, languages, and frameworks.

get_context

dot_path: str = "", path: str = "."

Get the full project context as formatted JSON/text. Optionally filter by dot path (e.g. tech_stack.languages).

update_context

dot_path: str, value: str, path: str = "."

Update a specific field in the project context using dot notation (e.g. project.description).

add_to_context_list

dot_path: str, item: str, path: str = "."

Add an item to a list field in the context (e.g. tech_stack.languages, key_files). Supports strings or JSON strings.

add_key_file

file_path: str, purpose: str, details: str = "", root_path: str = "."

Register a key file with its purpose and optional details in the project context.

add_task

task_id: str, description: str, status: str = "pending", branch: str = "", notes: str = "", path: str = "."

Add an active task to the project context.

add_decision

decision: str, reason: str, alternatives: str = "", path: str = "."

Log an architecture decision record (ADR) in the project context.

export_context_markdown

path: str = "."

Export the project context as a Markdown document for sharing with other LLMs and AI tools.

remove_context_item

dot_path: str, index: int, path: str = "."

Remove an item from a list in the project context by index.

reset_context

path: str = "."

Reset the project context to default values (clears all data).

project_info

path: str = "."

Get information about the current project environment (languages, frameworks, file counts).

Tool Name

Parameters

Description

read_file

path: str

Read the contents of a file at the given path.

write_file

path: str, content: str

Write content to a file, creating it if it doesn't exist.

edit_file

path: str, old_string: str, new_string: str

Edit a file by replacing an exact string with a new string. Use this for targeted code changes.

delete_path

path: str

Delete a file or an empty directory.

delete_recursive

path: str

Recursively delete a file or directory tree. Use with caution.

list_directory

path: str

List files and directories inside a given directory.

glob_files

pattern: str, base_path: str = "."

Find files matching a glob pattern (e.g. **/*.ts, src/**/*.py).

create_directory

path: str

Create one or more directories (like mkdir -p).

Tool Name

Parameters

Description

run_command

command: str, timeout_seconds: int = 60, workdir: str = None

Run a shell command and return its output. Always set a reasonable timeout. Avoid destructive commands.

search_code

pattern: str, path: str = ".", glob_filter: str = None, max_results: int = 50

Search for a text pattern across files in the project using ripgrep (or Python fallback).

git_status

repo_path: str = "."

Show the working tree status (git status).

git_diff

repo_path: str = ".", staged: bool = False

Show staged and unstaged changes (git diff).

git_log

repo_path: str = ".", max_count: int = 10

Show recent commit history (git log).

git_branch

repo_path: str = "."

List local branches (git branch).

git_add

repo_path: str = ".", files: str = "."

Stage file(s) for commit (git add).

git_commit

repo_path: str = ".", message: str = "update"

Commit staged changes with a message (git commit).

git_create_branch

repo_path: str = ".", branch_name: str = ""

Create and switch to a new git branch (git checkout -b).