PAPI exposes 24 tools via the MCP protocol. Your AI coding tool calls these automatically — you direct the workflow in plain language.
orient→plan→build_list→build_execute→review_submit→releasesetupInitialise PAPI for your project. Generates a Product Brief, seeds Active Decisions, and scaffolds workflow instructions. Run once per project after installing.
orientSingle-call session orientation. Returns your current cycle, task counts by status, velocity snapshot, and recommended next action.
planGenerate BUILD HANDOFFs for the next cycle. Two-phase: prepare assembles context and returns a planning prompt, apply writes the results. PAPI selects and scopes tasks based on your backlog, active decisions, and velocity history.
build_listList cycle tasks with their BUILD HANDOFFs ready for execution. Shows In Progress first, then Backlog.
build_describeShow the full BUILD HANDOFF for a specific task — scope, acceptance criteria, relevant files, and effort estimate.
build_executeStart or complete a build task. Call once to start (creates a feature branch, returns handoff). Call again with a build report to complete (records effort, surprises, discovered issues, and creates a PR).
build_cancelCancel a build task with a reason. Moves it back to backlog.
ideaCapture an idea, improvement, or bug as a Backlog task for the next cycle's plan to triage. Doesn't interrupt the current cycle.
bugReport a bug as a prioritised Backlog task. Severity determines the priority assigned.
ad_hocRecord quick work done outside the normal cycle — no branch, no PR, just a log entry. Keeps your cycle history accurate.
review_listList tasks waiting for review — those that have been built but not yet accepted.
review_submitRecord your verdict on a completed build. Accept merges the PR and marks the task Done. Request-changes sends it back. Reject cancels it.
releaseCut a versioned release — creates a git tag, generates a CHANGELOG entry, and pushes to remote.
board_viewView the task board with optional filters by status, priority, or module.
board_deprioritiseMove a task out of the current cycle back to backlog. Use this to adjust scope mid-cycle without cancelling.
board_archiveArchive Done or Cancelled tasks to keep the board focused on active work.
board_reconcileDetect and fix board state mismatches — orphaned branches, missed completions, status drift between git and the board.
strategy_reviewRun a strategy review — assesses Active Decisions, velocity, and project direction. Two-phase: prepare returns the review prompt, apply saves the results with recommendations for the next plan.
strategy_changeCapture a strategic direction change as a new or updated Active Decision — with reasoning, evidence, and confidence level.
zoom_outStep back and get a high-level view of project direction, horizon progress, and strategic alignment.
hierarchy_updateUpdate your project's horizon, stage, or phase structure — reflecting meaningful shifts in project scope or direction.
doc_registerRegister a research or planning document in the doc registry. Stores metadata, a structured summary, and any actionable findings — not the full content.
doc_searchSearch the doc registry by type, tags, keyword, or pending actions. Returns summaries for context gathering.
doc_scanScan your docs directory for markdown files not yet registered in the registry.