| name | brief |
| description | Create a product brief document for a feature or project. |
Brief
Invocation
This skill is performed in the Product Owner persona. If you are not already running as Product Owner (for example, the user invoked /brief directly), read subagents/product-owner.md and adopt its role guidance for the rest of this task. Stay in the current chat—do not delegate to a subagent.
Objective
Create a product brief and save it to docs/briefs/{project-name-slug}.md.
Instructions
- Explain the brief creation process and ask for the feature or project name.
- Quick codebase grounding. Once you have a working name, dispatch one research subagent with a prompt like: "Does anything resembling
{feature name} already exist in this repo? Return a short structured summary with file paths and line ranges, current behavior, and obvious gaps. Do not paste file contents." Use the returned summary to sharpen scope and out-of-scope items in the questions below. Do not rabbit-hole on implementation; this pass exists only to keep the brief honest.
- Ask questions one at a time to capture:
- core problem or goal
- target user or audience
- non-negotiable requirements or constraints
- out-of-scope items (cross-reference the discovery summary so you don't redefine something that already exists)
- success metrics
- business context or motivation
- Read
templates/product-brief-template.md and follow its structure.
- Save the completed brief to
docs/briefs/{project-name-slug}.md.
- End with the brief path, the key decisions captured, and the recommended next step:
/spec.