pbs-plan

Converts PRDs and design docs into grounded, verifiable implementation tasks.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Peterson-Benhame/agent-skills --skill pbs-plan-peterson-benhame
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pbs-plan
Source: https://github.com/Peterson-Benhame/agent-skills/tree/main/packages/skills-catalog/skills/%28development%29/pbs-plan
Command: npx skills add https://github.com/Peterson-Benhame/agent-skills --skill pbs-plan-peterson-benhame

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Decided work — a PRD, design doc, RFC, or thread — often arrives as prose that a builder cannot act on without guessing. This Skill turns that source into task files with observable acceptance criteria, explicit boundaries, and recorded open questions, so nothing plausible-but-undecided silently ships. ## Core Features & Use Cases - Vertical slicing: Enumerates observable outcomes from the source and defaults to one task per source, splitting only for order constraints, external blockers, or team ownership. - Code grounding: Reads the repository to find what the change disturbs, which decisions are truly irreversible, and where the source contradicts the actual code. - Surface walk and nine-dimension sweep: Systematically checks UI states, API shapes, CLI behavior, validation, idempotency, concurrency, observability, and more — recording each landing as a criterion, existing behavior, n/a, or Unresolved, never an invented requirement. - Use Case: Given a billing design doc, produce a .tasks/<name>.md file with numbered Given/When/Then criteria, an impact table, a Decided table of one-way doors, and an Unresolved table marking blocking questions — ready for handoff to an implementation skill. ## Quick Start Ask the agent to turn this PRD into tasks using pbs-plan, and it will cut slices, ground them in the repository, and write the task file.

Frequently Asked Questions about pbs-plan

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

FAQPage Schema
How do I turn a PRD into implementation tasks?

Provide the PRD or design doc and invoke pbs-plan. It reads the full source, enumerates vertical slices, grounds them against the repository code, and writes a task file with observable criteria, boundaries, and open questions.

What makes a good acceptance criterion for a development task?

A criterion must be an observable outcome with a concrete value that one execution can settle, such as a status code or field value. Vague terms like gracefully or fast are rejected, and guarantees that something will not happen must name the mechanism preventing it.

When should a PRD be split into multiple tasks?

Splitting is the exception and needs a defensible reason: an order constraint where one piece cannot land before another, an answer only someone else can give, or work belonging to another team. The default is one task per source.

Can pbs-plan handle vague or undecided feature ideas?

No. The skill requires a decided source such as a PRD, RFC, or even a one-line ticket. A blank wish with no decision is explicitly out of scope, and gaps in the source become questions rather than invented criteria.

What is the difference between pbs-plan and pbs-implement?

pbs-plan converts decided sources into task documents with criteria and open questions. pbs-implement consumes those task files, turning each criterion into a check with a proof during actual implementation.