Yipxiyi Product Governance
Use this skill when creating or updating docs/PRD.md.
Goal
Build a product source of truth that is clear enough for agents to implement against without inventing product intent.
Use Clarification Gate output when available. If the goal, audience, non-goals, constraints, or success criteria are still unclear, run clarification-gate before creating or rewriting docs/PRD.md.
Fixed Clarification Flow
If the user has not clearly specified the product direction, follow this flow before writing:
- Discover existing signals: README, docs, specs, routes, UI copy, package metadata, tests, issues, and assets.
- Extract knowns, unknowns, contradictions, and risky assumptions.
- Ask focused questions for material gaps only.
- Draft PRD sections from confirmed information.
- Cross-check with
docs/DESIGN.md,docs/BRAND.md, and latestdocs/specs/*when present. - Confirm unresolved product decisions with the user.
- Create or patch
docs/PRD.md.
PRD Owns
- Product background
- Problem statement
- Audience
- Goals and non-goals
- User stories
- Functional requirements
- UX requirements
- Data requirements
- AI / prompt requirements
- Performance and security requirements
- Success metrics
- Risks and open questions
Rules
- Do not fill core product strategy with generic guesses.
- Do not write PRD requirements from ambiguous goals; clarify first or record unresolved questions explicitly.
- Preserve existing product language when it is coherent.
- Keep requirements testable.
- Link features to specs instead of duplicating detailed implementation plans.
- Use
templates/PRD.template.mdfor new documents.