plan

Edit agent plan.md files and manage weekly task approvals.

11|1|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/runbear-io/aweek --skill plan-runbear-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/runbear-io/aweek/tree/main/skills/plan
Command: npx skills add https://github.com/runbear-io/aweek --skill plan-runbear-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning weekly work across multiple agents is error-prone when done in silos. This skill provides a single entry point to edit each agent's free-form planning surface, adjust weekly tasks, and govern pending weekly-plan approvals to keep the team aligned.

Core Features & Use Cases

  • Edit the agent's planning markdown at .aweek/agents/<slug>/plan.md.
  • Adjust weekly tasks (add / update) and manage task metadata (runAt, track, priority, etc.).
  • Approve / reject / edit pending weekly plans to unblock heartbeats and maintain governance.
  • Integrates with plan-markdown and planning services to maintain a living weekly plan across agents.

Quick Start

Open an agent's plan.md, then choose an action to edit, adjust, or review a pending plan.

Frequently Asked Questions about plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit weekly agent plans in markdown?

You can adjust weekly agent tasks by adding or updating entries in the plan.md file. This skill manages task metadata including runAt, track, and priority to maintain a living weekly plan across agents.

What is the best way to manage pending weekly plan approvals for agents?

Yes, you can route approvals by editing pending weekly plans. The skill reconciles changes and manages pending approvals to unblock heartbeats, ensuring structured planning workflows remain governed.

Do I need a specific directory structure to plan weekly agent tasks?

Yes, you need the agent's .aweek/agents directory and a plan.md file to drive structured weekly planning workflows. These directories act as the required planning surface for orchestrating task adjustments and approvals.

How does weekly agent planning reconcile changes across multiple agents?

Weekly agent planning reconciles changes by applying edits across each agent's plan.md file. It orchestrates structured planning workflows to seed weekly plans, adjust tasks, and manage pending approvals, preventing error-prone siloed planning.

Can I update task metadata like runAt and priority in a weekly agent plan?

Yes, you can update task metadata such as runAt, track, and priority within the plan.md file. Adjusting weekly tasks involves managing this metadata to maintain a structured and living weekly plan across agents.