product-plan

Converts a project brief into a product plan with user journeys, app shell spec, and chunk decomposition.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/hontauadrian/sfx-app-empty-test --skill product-plan-hontauadrian
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: product-plan
Source: https://github.com/hontauadrian/sfx-app-empty-test/tree/main/.claude/skills/product-plan
Command: npx skills add https://github.com/hontauadrian/sfx-app-empty-test --skill product-plan-hontauadrian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams starting a new top-level objective often jump straight into issue creation and task dispatch, ending up with layer-based work splits (backend, frontend, database) that never assemble into a usable app. This Skill turns a brief into a concrete product plan before any sub-issues are created or agents are dispatched. ## Core Features & Use Cases - User journey mapping: Defines 3-7 end-to-end flows with entry points, action sequences, and exit states so every primary entity has a reachable creation path. - App shell specification: Documents global navigation, exact labels and URLs, empty-state CTAs, and where every "Create <Entity>" affordance lives. - Vertical chunk decomposition: Splits work into capability-oriented chunks of 2-5 features that one lead can own end-to-end, explicitly forbidding layer-based splits. - Slot-aware dispatch planning: Chooses between leads mode (4+ concurrent slots) and direct-builder mode (3 or fewer slots) based on maxConcurrent in .overstory/config.yaml. - Use Case: A coordinator receives a brief for a team management app. Before running sd create or ov sling, it invokes this Skill to produce .overstory/specs/<issue-id>.md containing journeys, nav spec, chunks like "Team management" and "Project kanban", and runtime acceptance criteria. ## Quick Start Ask the coordinator to run the product-plan skill on the new top-level objective brief before creating any sub-issues or dispatching leads.

Frequently Asked Questions about product-plan

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

FAQPage Schema
How do I plan a new app before creating sub-issues and dispatching agents?▼

Invoke the product-plan skill on the top-level objective before running sd create or ov sling. It produces a spec file with user journeys, an app shell definition, and vertical chunks that leads can each own end-to-end.

What is vertical chunk decomposition in multi-agent planning?▼

Vertical chunking groups work by user capability, such as "Team management" or "Project kanban", with 2-5 features per chunk owned by one lead. Layer-based names like "Backend API" or "Frontend pages" are explicitly forbidden because they prevent any single lead from delivering a usable feature.

When does the coordinator use leads mode versus direct-builder mode?▼

The choice depends on maxConcurrent in .overstory/config.yaml. With 4 or more available slots, one lead is dispatched per chunk. With 3 or fewer slots, the coordinator acts as lead, rewrites chunks as flat features, and invokes the feature-plan skill for scout and builder dispatch.

Does the product plan replace the existing authentication setup?▼

No. Unless the brief explicitly requests auth replacement, the plan preserves the scaffold's existing provider, such as Keycloak with oauth2-proxy and RS256/JWKS. It must not introduce email/password login, /register pages, or local JWT cookies.

Why do builders hit RESOURCE_CAPTURE_PATHPARAM_UNDECLARED errors?▼

This happens when one chunk locks a parent module as "do not modify" while a later chunk nests children under that parent's path. The plan must note that the parent CREATE handler may need additive @ResourceCaptures tuples from downstream chunk builders.