execution-plans
/execution-plans
Manage execution plans as versioned artifacts with progress tracking and decision logs. Use when you say "create execution plan", "update plan progress", "log decision", "complete plan", or "abandon plan". Do NOT use to break work into milestones (use plan) or to execute an approved plan file through delegation (use planner).
- Author
- rjmurillo ↗
- Repository
- ai-agents ↗
- Licence
- MIT
- Last repository change
- 12.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 1
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
What it does and when to use it
Manage execution plans as versioned artifacts with progress tracking and decision logs. Use when you say "create execution plan", "update plan progress", "log decision", "complete plan", or "abandon plan". Do NOT use to break work into milestones (use plan) or to execute an approved plan file through delegation (use planner).
Triggers from the description
Original author description
Manage execution plans as versioned artifacts with progress tracking and decision logs. Use when you say "create execution plan", "update plan progress", "log decision", "complete plan", or "abandon plan". Do NOT use to break work into milestones (use plan) or to execute an approved plan file through delegation (use planner).
How it works
- Directory Structure
- Triggers
- Plan Template
- Process
- Integration
- Anti-Patterns
- Verification
SKILL.md preview
---
name: execution-plans
version: 1.0.0
description: Manage execution plans as versioned artifacts with progress tracking and decision logs. Use when you say "create execution plan", "update plan progress", "log decision", "complete plan", or "abandon plan". Do NOT use to break work into milestones (use plan) or to execute an approved plan file through delegation (use planner).
license: MIT
metadata:
routing:
role: lifecycle
invoker: plan
trigger: plan persists the finished plan as a versioned artifact through execution-plans
user-facing: false
---
# Execution Plans Skill
Treat execution plans as first-class artifacts, versioned in the repository.
<!-- vendor-portability: declared. This skill reads and writes plan artifacts under the consumer's .project-toolkit/plans/ (active/, completed/, abandoned/) and .project-toolkit/debt/tech-debt-registry.md, seeded from .project-toolkit/plans/TEMPLATE.md. These are consumer-side write targets created on demand; a vendored install without .project-toolkit/ creates the directories when the first plan is written rather than failing silently. -->
## Directory Structure
```text
.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
```
## Triggers
| 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 |
## Plan Template
Use `.project-toolkit/plans/TEMPLATE.md` as the starting point for new plans.
### Required Sections
| 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 |
## Process
### Creating a Plan
1. Copy TEMPLATE.md to `.project-toolkit/plans/active/{slug}.md`
2. Fill metadata (status: In Progress, created: today, owner: agent name)
3. Define objectives as checkboxes
4. Link to related issue/PR
### Updating Progress
1. Check off completed objectives
2. Add entry to Progress Log table with date, update, and agent name
3. Update blockers if any emerge
### Logging Decisions
Add row to Decision Log table:
| Date | Decision | Rationale | Alternatives Considered |
|------|----------|-----------|------------------------|
| YYYY-MM-DD | What was decided | Why this choice | What else was evaluated |
### Completing a Plan
1. Verify all objectives checked
2. Update status to Completed
3. Move file from `active/` to `completed/`
4. Add final progress entry
### Blocking a Plan
1. Update status to Blocked
2. Document impediment in Blockers section
3. Add progress entry noting the block
### Abandoning a Plan
1. Update status to Abandoned
2. Document rationale in blockers or final progress entry
3. Move file from `active/` to `abandoned/`
## Integration
- Session logs reference active plans when relevant
- Planner skill creates plans here when executing complex work
- Retrospectives link back to completed plans
## Anti-Patterns
| 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 |
## Verification
After creating a plan:
- [ ] File in `.project-toolkit/plans/active/`
- [ ] Metadata section complete
- [ ] At least one objective defined
- [ ] Linked to issue or PR
After completing:
- [ ] All objectives checked
- [ ] Final progress entry added
- [ ] File moved to `completed/`
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · rjmurillo/ai-agents | 100 | MIT |
| rjmurillo/ai-agents | 100 | MIT |
Database snapshot: 13.11.2026 · package version c0171bee5c8f (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100project-planner
Detects stale project plans and suggests session commands. Triggers on: sync plan, update plan, check status, plan is stale, track progress, project planning. - 95sprint-executor
Execute approved sprint plans with test-driven development, continuous linting, progress tracking, and pause points. Supports parallel milestone execution via Task sub-agents. Use when user says "execute sprint", "start sprint", or wants to implement an approved sprint plan. - 96planner
Use when the user asks to create, write, or review a docs/plans plan. - 95sprint-executor
Execute approved sprint plans with test-driven development, continuous linting, progress tracking, and pause points. Supports parallel milestone execution via Task sub-agents. Use when user says "execute sprint", "start sprint", or wants to implement an approved sprint plan. - 100plan
Create and manage implementation plans in .agent/plan/ files. Use this skill when: starting a new feature or refactor, the user says "plan this", "think about how to", "design the approach", "prepare a plan", or any time structured planning is needed before execution. Plans are… - 100new
Create and manage implementation plans in .agent/plan/ files. Use this skill when: starting a new feature or refactor, the user says "plan this", "think about how to", "design the approach", "prepare a plan", or any time structured planning is needed before execution. Plans are…