From copilot-cli-toolkit
Manages execution plans as versioned Markdown artifacts with progress tracking, decision logs, and archiving in .agents/plans. Use for creating, updating, or archiving plans in complex multi-step work.
npx claudepluginhub rjmurillo/ai-agentsThis skill uses the workspace's default tool permissions.
Treat execution plans as first-class artifacts, versioned in the repository.
Manages execution plans as versioned Markdown artifacts with progress tracking, decision logs, and archiving in .agents/plans. Use for creating, updating, or archiving plans in complex multi-step work.
Manages ExecPlan lifecycle for multi-step work: creates formatted plans, enforces progress updates, handles active-to-completed transitions. For tasks >1 session or >3 files.
Executes tasks from PLAN.md sequentially with human oversight, handling task splitting, clarifying questions, tests, and learning persistence. Useful for deliberate progress on planned work.
Share bugs, ideas, or general feedback.
Treat execution plans as first-class artifacts, versioned in the repository.
.agents/
├── plans/
│ ├── active/ # Plans currently in progress
│ ├── completed/ # Successfully finished plans
│ └── abandoned/ # Plans that were stopped (with rationale)
└── debt/
└── tech-debt-registry.md # Known technical debt items
| Trigger Phrase | Operation |
|---|---|
create execution plan | Create new plan in active/ |
update plan progress | Add progress entry to existing plan |
log decision | Add decision to plan's decision log |
complete plan | Move plan to completed/ |
abandon plan | Move plan to abandoned/ with rationale |
Use .agents/plans/TEMPLATE.md as the starting point for new plans.
| Section | Purpose |
|---|---|
| Metadata | Status, dates, owner, complexity |
| Objectives | Checkboxes for trackable goals |
| Decision Log | Table of decisions with rationale |
| Progress Log | Timestamped updates with agent attribution |
| Blockers | Current impediments |
| Related | Links to issues, PRs, ADRs |
.agents/plans/active/{slug}.mdAdd row to Decision Log table:
| Date | Decision | Rationale | Alternatives Considered |
|---|---|---|---|
| YYYY-MM-DD | What was decided | Why this choice | What else was evaluated |
active/ to completed/active/ to abandoned/| Avoid | Why | Instead |
|---|---|---|
| Plans without objectives | Not trackable | Define measurable checkboxes |
| Undocumented decisions | Lost institutional knowledge | Log every non-trivial choice |
| Stale active plans | Clutters workspace | Complete or abandon promptly |
| Plans without issue links | No traceability | Always link to source issue |
After creating a plan:
.agents/plans/active/After completing:
completed/