planning

name	planning
description	Minimal workflow for creating, editing, and executing plans

Planning Skill (Minimal)

Scope

Use this skill to:

• create plans
• update plans
• execute plans step by step

Plan location

• Store all plans in: .agents/plans/

Plan format

• Use concise, LLM-native language
• Write phased, step-by-step plans
• Each step must be small, concrete, and executable by the model

Use this frontmatter in every plan:

---
title: <short title>
status: planned
progress:
  - step: "<step 1>"
    status: planned
  - step: "<step 2>"
    status: planned
---

Allowed step status values:

• planned
• in_progress
• completed

Creating a plan

1. Create a new markdown file in .agents/plans/.
2. Add frontmatter with progress steps.
3. Add short phase sections under the frontmatter.

Editing a plan

1. Keep steps small and concrete.
2. Update progress statuses as work changes.
3. If scope changes, add/remove steps explicitly in progress.

Executing a plan

1. Pick exactly one planned step.
2. Mark it in_progress.
3. Complete only that step.
4. Mark it completed.
5. Commit immediately after finishing that step.
6. Repeat for the next step.

Commit rule: one completed step per commit.