# Limps Planning

> Guide for using limps MCP tools to plan, track, and update work across plans and agents. Use when this capability is needed.

- Skill: `tomevault-io/limps-planning` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/limps-planning`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/limps-planning/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/limps-planning

---

# 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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/paulbreuler) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-12 -->