product-spec-kit

## Overview This skill helps Product Managers produce structured, high-quality documentation for product development. It supports both comprehensive documentation workflows (PRD → Plan → Stories) and standalone quick issues (individual stories, tasks, or bugs). Always use the language of the user interaction to create the final files, including headings and default content of templates. If the user explicitly requests a different language, use it. ## When to use? Use this skill when user asks to: - Create a PRD specification - Create an epic and your stories/tasks - You need to create or clarify a product specification, such as a Product Requirements Document (PRD), a Release Plan, or a User Story. - It can also be used to create standalone PRD, Plan, Story, Task or Bug. ## Core Principles Constitution All documentations need to follow the constitution defined in `rules/product-speckit-constitution.md`. This constitution is a set of non-negotiable principles that govern all product documentation created with this skill. These principles apply regardless of language, workflow type (full or quick), or document format. ### Principle I: Complete & Unambiguous Requirements Every requirement must be clear enough that a reader with no prior context can understand what's needed and why. ### Principle II: Design-Driven Acceptance Criteria Acceptance criteria should be based on visual designs, user flows, and specific UI elements - never written from assumptions. ### Principle III: Functional Over Descriptive Criteria must describe what the system does, not what it looks like. Focus on behavior, actions, and outcomes. ### Principle IV: Right Level of Detail - PRDs: Macro-level requirements and general rules - Stories: Detailed, functional acceptance criteria - Each document serves its purpose without overlap ### Principle V: Never Assume, Always Validate When information is missing or ambiguous: - Ask specific questions - Request designs/mockups - Reference previous discussions - Mark uncertain items for validation - Wait for confirmation before finalizing ## Workflows or Commands - *Starting the interaction - how to start a new specification*: If the user don't provide the type of specification want to build, always ask for it, using the `workflows/prod-start.md` instructions. Ignore the start step if the user provide the type of specification want to build. - *Creating a PRD*: When the user want to create a PRD, use the `workflows/prod-spec-prd.md` instructions. - *Clarifying an specification*: When the user want to clarify an specification (such as PRD, Plan, Story, Task or Bug), use the `workflows/prod-clarify.md` instructions. If the user doesn't provide an existing specification, ask for it. - *Breakdown specs*: When the user want to break the PRD in smaller parts such as Epics -> Stories / Tasks, use the `workflows/prod-spec-breakdown.md` instructions. You need to validate an existing PRD or create the PRD before breaking it down. If the user doesn't provide an existing PRD, ask for it. - *Creating a Story*: When the user want to create a story, use the `workflows/prod-spec-story.md` instructions. - *Creating a Task*: When the user want to create a task, use the `workflows/prod-spec-task.md` instructions.