plan

Transform approved feature specifications into ordered atomic technical build plans.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/bernajaber/pi-product-system --skill plan-bernajaber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/bernajaber/pi-product-system/tree/main/skills/plan
Command: npx skills add https://github.com/bernajaber/pi-product-system --skill plan-bernajaber

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms an approved feature specification into a precise, ordered technical build plan so autonomous agents can implement features reliably without operator interaction.

Core Features & Use Cases

  • Stack selection: Chooses a minimal, mature stack and justifies the choice against engineering and product constitutions.
  • Atomic task generation: Produces ordered, independently testable tasks mapped to acceptance scenarios with "Write Tests" as the final task.
  • Project updates and handoff: Updates REVIEW_GUIDELINES.md, creates a feature branch, writes .pi/specs/<feature>/plan.md, and updates workflow-state.json for the analyze and build skills.
  • Use case: Convert a shopping-list spec into a step-by-step plan that the build skill will commit and the test skill will verify.

Quick Start

Create a technical plan for the feature defined in .pi/specs/<feature>/spec.md and save it to .pi/specs/<feature>/plan.md.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I turn a feature spec into an atomic build plan for autonomous agents?

To turn a feature spec into an atomic build plan, you apply this Skill to your spec.md file. It generates an ordered plan.md with atomic tasks where each task is independently testable, mapped to acceptance scenarios, and corresponds to a single commit.

What is an atomic task in a technical build plan?

An atomic task in a technical build plan is a single, independently testable unit of work that corresponds to one commit. It includes a clear "Done when" condition and maps directly to an acceptance scenario from the feature specification.

How do I generate a file structure and select a stack from a feature specification?

You can generate a file structure and select a stack by processing your approved feature spec. This Skill selects a minimal, mature stack by justifying choices against engineering constitutions and defines the project file structure within the output plan.

Do I need an approved specification before generating an ordered task list?

Yes, you need an approved specification. The Skill requires a spec.md input located in .pi/specs/<feature>/ and checks that workflow-state.json currentPhase is set to analyze before generating the technical plan.

What is the best way to structure tasks for autonomous agent implementation?

The best way to structure tasks for autonomous agents is creating an ordered list of atomic tasks. This Skill produces a plan.md where each task is independently testable, mapped to acceptance scenarios, and ends with a final "Write Tests" task.

What files are updated when creating a technical build plan?

When creating a technical build plan, the Skill updates REVIEW_GUIDELINES.md and workflow-state.json. It also creates a feature branch and saves the generated plan to .pi/specs/<feature>/plan.md for downstream build and test skills.