defprod-create-area-stories

Creates user stories with acceptance criteria for a product area by analyzing the codebase.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/defprod1/defprod-skills --skill defprod-create-area-stories-defprod1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: defprod-create-area-stories
Source: https://github.com/defprod1/defprod-skills/tree/main/skills/defprod-create-area-stories
Command: npx skills add https://github.com/defprod1/defprod-skills --skill defprod-create-area-stories-defprod1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Product areas in DefProd often exist without documented user stories, leaving teams without a shared, testable definition of what the software actually does. This Skill reverse-engineers the implemented capabilities of a single product area from the source code and writes them as structured user stories with acceptance criteria via the DefProd MCP server. ## Core Features & Use Cases - Codebase-driven research: Maps an area to its routes, controllers, services, tests, and UI components, then builds a capability matrix of entities, verbs, and variants that acts as a required coverage checklist. - Granularity-enforced story creation: Generates one story per acceptance-test cluster with canonical personas from the product brief, user-observable acceptance criteria, and sequential area-prefixed keys (e.g. AUTH-01). - Add-more and decomposition modes: Detects existing stories, offers add/replace/cancel options, and can split coarse existing stories into fine-grained replacements with tombstoning of retired parents. - Use Case: After defining a BILLING area in DefProd, run the skill against your repo to produce 15-35 verified stories covering listing, editing, state transitions, and permission variants, each ready to drive automated tests. ## Quick Start Ask your AI agent to run /defprod-create-area-stories for your product name and area key, for example: create area stories for the Billing area of my product.

Frequently Asked Questions about defprod-create-area-stories

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

FAQPage Schema
How do I generate user stories from an existing codebase?

Run the skill with a product name and area key, and it researches the area's routes, controllers, services, tests, and UI components to build a capability matrix. It then creates one user story per matrix row via the DefProd MCP server, each with acceptance criteria.

What happens if the product area already has user stories?

The skill lists existing stories and asks whether to add more, replace all, or cancel. In add-more mode it avoids duplicates and can decompose coarse existing stories into fine-grained replacements, tombstoning the originals instead of deleting them.

Does this skill work with Cursor or OpenCode, or only Claude Code?

It works with any agent that discovers skills from .claude/skills/, including Claude Code, Cursor, and OpenCode. Cursor and OpenCode ignore the allowed-tools frontmatter but execute the same SKILL.md instructions.

Why are component names not allowed in acceptance criteria?

Acceptance criteria must be user-observable and testable, so identifiers like Component names, method calls, RxJS primitives, and route config are prohibited. Each criterion is rewritten to describe what the user sees or does, such as navigation outcomes and visible behavior.

What are the prerequisites for running this skill?

You need a DefProd account with at least one product, the DefProd MCP server connected to your AI agent, and an existing product area. Optionally, .defprod/defprod.json can hint at frontend and backend app paths to focus research.