agent-plan-manager

# Agent Plan Manager Manage OpenClaw Agent's execution plans and task workflows in a structured, trackable way. **Who is it for?** OpenClaw Agent that needs to organize tasks, track execution progress, or document step-by-step implementation plans. **What makes it different?** - **Agent-Centric**: designed for AI agent execution workflows with clear entry/exit points - **Structured**: separates high-level goals from detailed tool-calling steps - **Trackable**: uses checkboxes and status fields for execution state visibility - **Lightweight**: just Markdown files, integrates with OpenClaw's file system tools ## Quick Start 1. Create `plans/plans-overview.md` from the overview template 2. Add execution items to the table with appropriate status 3. If a plan needs detailed steps, create `plans/detailed/XX-{plan-name}.md` 4. Update `plans/detailed/index.md` to link the new plan 5. Update statuses as execution progresses ## Directory Structure ```text plans/ ├── plans-overview.md ← from templates/plans-overview.md └── detailed/ ├── index.md ← from templates/index.md └── XX-{plan-name}.md ← from templates/detailed-plan.md ``` ## When to Use - Creating a new execution plan for complex tasks - Tracking multi-step tool calling workflows - Breaking down user requests into actionable steps - Recording detailed execution documentation - Structured agent task management ## Example: Web Scraping Task **Step 1** — Add to `plans/plans-overview.md`: ```markdown | 1 ||***|| Web scraping for product prices ||***|| In Progress ||***|| High ||***|| TBD ||***|| TBD ||***|| Extract prices from example.com | ``` **Step 2** — Create `plans/detailed/01-web-scraping.md`: ```markdown # Detailed Plan - Web Scraping for Product Prices ## Plan ID: #1 ## Objective Extract product prices from example.com and save to a CSV file. ## Schedule TBD ## Deadline TBD ## Tool Sequence 1. `browser_navigate` → example.com/products 2. `browser_snapshot` → extract product list 3. `browser_click` → navigate to each product 4. `WriteFile` → save results to products.csv ## Implementation Steps ### 1. Navigate to target URL - [x] Use browser_navigate to load example.com/products ### 2. Extract product data - [ ] Capture page snapshot - [ ] Parse product names and prices - [ ] Handle pagination if present ### 3. Save results - [ ] Format data as CSV - [ ] Write to products.csv ## Estimated Token Usage ~2K tokens ``` **Step 3** — Update `plans/detailed/index.md`: ```markdown | #1 | Web scraping for product prices | TBD | TBD | [01-web-scraping.md](./detailed/01-web-scraping.md) | ``` ## Templates All templates live in `templates/`: - **`plans-overview.md`** — High-level execution board with status table - **`index.md`** — Index of all detailed execution plans - **`detailed-plan.md`** — Step-by-step execution plan with tool sequences ## Tips - Keep plan names concise; use kebab-case for filenames (`01-web-scraping.md`) - Update `last_updated` in frontmatter whenever the overview changes - Use checkboxes (`- [ ]`) in detailed plans to track execution progress - Include tool sequences to clarify the execution flow - Archive completed plans by moving them to the "Completed Items" section - Estimate token usage when possible for complex multi-step tasks