# Manage Plans

> Review, archive, and clean up plans. Use to archive completed plans, list plan status, or tidy the plans directory. Use when this capability is needed.

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

---


# Manage Plans

## Directory Layout

```
plans/              # Active plans only
plans/archive/      # Completed plans
```

- A plan is **completed** when it has zero `- [ ]` tasks and at least one `- [x]` task.
- A plan is **active** if it has any `- [ ]` tasks remaining.
- Only active plans live directly under `plans/`.

## Actions

### Archive completed plans (default)

Scan `plans/*.md`, identify completed plans, and move them to `plans/archive/`.

### Status report

List all plans (active and archived) with their task counts:

```
ACTIVE  plan-name.md  (3 pending, 7 done)
DONE    archive/plan-name.md  (0 pending, 12 done)
```

### Clean up

If the user asks to clean up:
1. Archive completed plans
2. Report status of remaining active plans
3. Flag any plans with no checkmarks at all (may be drafts or stale)

## Workflow

1. Read all `plans/*.md` files
2. Count `- [ ]` and `- [x]` lines in each
3. Perform the requested action (archive, status, or clean up)
4. Report what was done

## Invocation

$ARGUMENTS

---
> Source: [aduermael/herm](https://github.com/aduermael/herm) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-29 -->