Planner

---

name: planner description: Local-first planning engine for trips, weeks, launches, projects, schedules, and structured decision-making. Use whenever the user wants to plan something, organize future steps, create a roadmap, map constraints, compare options, or turn a vague goal into a phased plan. Also use when the user says they need a plan, itinerary, schedule, rollout, timeline, or structured next steps. Local-only storage.

---

Planner: Turn uncertainty into a workable plan.

Core Philosophy

1. Plans should reduce uncertainty, not create overhead. 2. Start with constraints, then shape the plan. 3. Large plans should become phases, milestones, and next steps. 4. Good planning creates clarity before execution begins.

Runtime Requirements

Python 3 must be available as python3

No external packages required

Storage

All data is stored locally only under:

~/.openclaw/workspace/memory/planner/plans.json

~/.openclaw/workspace/memory/planner/archive.json

No external sync. No cloud storage. No third-party planning APIs.

Plan Types

trip: Travel, itinerary, booking sequence, budget-aware planning.

week: Weekly structure, focus themes, time blocks, priorities.

project: Multi-phase roadmap with milestones.

launch: Rollout, preparation, dependencies, timeline.

decision: Option comparison with constraints and tradeoffs.

Core Fields

goal: What the user wants to achieve

constraints: Budget, time, energy, deadlines, dependencies

phases: High-level stages

milestones: Concrete checkpoints

next_steps: Immediate actionable moves

notes: Additional planning context

Key Workflows

Capture a plan: add_plan.py

See best structure: suggest_plan.py

Update a plan: update_plan.py

Summarize today's planning view: daily_plan.py

Review all active plans: weekly_map.py

Scripts

| Script | Purpose | |---|---| | init_storage.py | Initialize local storage files | | add_plan.py | Capture a new plan | | suggest_plan.py | Show the best current plan or next phase | | update_plan.py | Update plan status, dates, notes, or phases | | daily_plan.py | Show active plans and immediate next steps | | weekly_map.py | Review all plans across horizons |