defprod-create-definition

Populates a DefProd product brief and areas by analyzing documentation and codebase.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a DefProd product exists but its definition is empty, teams face a blank page: no brief, no areas, no shared understanding of what the product does. This Skill removes that cold-start problem by researching your documentation and codebase, then drafting the product brief and structural areas automatically. ## Core Features & Use Cases - Codebase and documentation research: Reads READMEs, docs, ADRs, routes, data models, and project structure to build a mental model of the product before writing anything. - Brief population via MCP: Fills description, positioning, problem statement, user personas, requirements, success criteria, and aesthetics through batched patchBrief calls, never overwriting existing content. - Area proposal and creation: Identifies logical product areas from route groups and feature modules, presents them for confirmation, then creates them with createArea. - Use Case: You just created a DefProd product for an existing SaaS app. Run this Skill to have the agent analyze the repo and produce a complete brief with 8 areas, ready for review in minutes. ## Quick Start Ask your agent to run /defprod-create-definition with your product name to populate its brief and areas from the codebase.

Frequently Asked Questions about defprod-create-definition

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

FAQPage Schema
How do I populate a DefProd product definition from my codebase?

Run /defprod-create-definition with your product name. The skill reads your documentation and source code, then fills the brief via patchBrief and proposes areas for confirmation before creating them with createArea.

What is the difference between defprod-create-definition and defprod-onboard-product?

defprod-create-definition is a focused skill that only populates the brief and areas of an existing product. defprod-onboard-product is the fuller workflow for setting up a product from scratch, including product creation.

Does defprod-create-definition overwrite existing brief content?

No. The skill checks existing brief fields with getBriefForProduct and only fills empty fields. Populated content is left untouched, and areas require explicit user confirmation before creation.

What tools does defprod-create-definition need to run?

It requires an AI agent supporting .claude/skills/ (Claude Code, Cursor, or OpenCode), the DefProd MCP server connected, and read access to the repository. It uses MCP tools like listProducts, patchBrief, and createArea.

When should I not use defprod-create-definition?

Avoid it when the product does not exist yet in DefProd, or when the brief and areas are already populated. For adding user stories to existing areas, use /defprod-create-area-stories instead.