planning-and-task-breakdown

Decomposes specifications into ordered, verifiable implementation tasks with acceptance criteria.

1|Updated Mar 2, 2025
One-click install
npx skills add https://github.com/marjorg/setup --skill planning-and-task-breakdown-marjorg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-and-task-breakdown
Source: https://github.com/marjorg/setup/tree/main/home/.agents/skills/planning-and-task-breakdown
Command: npx skills add https://github.com/marjorg/setup --skill planning-and-task-breakdown-marjorg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large or vaguely defined work items cause agents and developers to start coding without a plan, producing tangled implementations and missed requirements. This Skill turns a spec into a written plan with small, testable tasks, explicit acceptance criteria, and verification checkpoints. ## Core Features & Use Cases - Dependency-aware task ordering: Maps the dependency graph (schema, API, UI) and slices work vertically so each task delivers working, testable functionality. - Structured task format: Every task includes acceptance criteria, verification steps, dependencies, files likely touched, and a size estimate (XS through XL, with XL flagged for further breakdown). - Flexible output targets: Writes the plan to tasks/plan.md and the task list to tasks/todo.md by default, or maps tasks onto an external tracker like GitHub Issues, Jira, Linear, or beads when the project designates one. - Use Case: Given a spec for a user registration feature, produce a plan document with phased tasks (schema, endpoint, UI), checkpoints after each phase, and a risk table before any code is written. ## Quick Start Break this feature spec into an ordered task list with acceptance criteria and save the plan to tasks/plan.md.

Frequently Asked Questions about planning-and-task-breakdown

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

FAQPage Schema
How do I break a large feature spec into implementable tasks?

Map the dependency graph first, then slice vertically so each task delivers one complete working feature path rather than a horizontal layer. Give every task acceptance criteria, verification steps, dependencies, and a size estimate of Small or Medium.

What is vertical slicing in task breakdown?

Vertical slicing builds one complete feature path at a time, such as schema plus API plus UI for registration, instead of building the entire database, then all endpoints, then all UI. Each slice leaves the system in a working, testable state.

When should a task be broken down further?

Break a task down when it exceeds one focused session, needs more than three acceptance criteria bullets, touches two independent subsystems, or its title contains the word "and". Tasks sized Large or bigger should always be split.

Can tasks be tracked in GitHub Issues or Jira instead of a markdown file?

Yes. If the project's agent rules or the user designate an external tracker such as GitHub Issues, Jira, Linear, or beads, create one tracker item per task instead of writing tasks/todo.md, and note the tracker in tasks/plan.md.

What happens if tasks/plan.md already exists with unchecked tasks?

The Skill never overwrites an incomplete plan. If the existing plan covers different work, it stops and asks the user whether to finish the old plan, discard it, or write the new plan elsewhere, since unchecked tasks may be mid-build in another session.

When should I not use a formal task breakdown process?

Skip it for single-file changes with obvious scope or when the spec already contains well-defined tasks. The planning process is designed for multi-component work where implementation order and dependencies are not obvious.