limps-planning

Guide for using limps MCP tools to plan, track, and update work across plans and agents.

limps planning

Purpose

Provide consistent guidance for selecting limps MCP tools in common planning workflows.

When to Use

  • Creating or updating plans and agents
  • Finding the next task or plan status
  • Searching or updating documents in a plans directory

Quick Tool Selection

  • Create a plan: create_plan, then create_doc for plan files
  • List plans: list_plans
  • List agents: list_agents
  • Plan status: get_plan_status
  • Next task: get_next_task
  • Search docs: search_docs
  • Update status: update_task_status
  • Read/process docs: process_doc, process_docs
  • Update plan priority/severity: update_doc (edit plan frontmatter)

Examples

Find the next task in a plan

  1. list_plans → pick plan name
  2. get_next_task with plan number/name

Update an agent status

  1. list_agents for the plan
  2. update_task_status with task ID and new status

Automate plan priority and severity

  1. process_doc the plan file (e.g., plans/0030-foo/0030-foo-plan.md) to read frontmatter
  2. Determine priority and severity values (low | medium | high | critical)
  3. update_doc with new frontmatter fields (do not edit config.json)
  4. Optional: add a brief note in plan content or decisions log describing why it was updated

Extract open features across plans

  1. process_docs with pattern plans/*/*-plan.md
  2. Use extractFeatures() to filter GAP

Notes

  • Paths should be relative to the configured plansPath or docsPaths.
  • Use process_doc(s) for structured extraction instead of manual parsing.