Skip to content

Analyst PRD Wizard + Industry Templates (guided creation, not auto-fill) #21

Description

@DevVig

Summary
Add an interactive PRD Wizard that guides users through industry-standard sections with prompts and examples. Provide domain-specific templates (e.g., B2B SaaS, Marketplace, Fintech, Healthcare) and make the wizard the default path for @analyst assess fresh rather than auto-generating a generic PRD.

Why

  • Prevents low-quality, generic PRDs; captures goals/aims explicitly
  • Aligns A2Dev with best practices across industries

Scope

  • New CLI: a2dev prd-wizard and route option from @analyst
  • Domain templates under .a2dev/templates/prd/*.md
  • Inline guidance and examples in each section, with “what good looks like” checklists

Tasks

  • Add wizard command in a2a/cli.py with prompts for: Summary, Goals & Success Metrics (SMART), Users & Personas, Problem Statement, Scope/Out of Scope, Functional Areas/Epics, NFRs (security/privacy/perf/reliability/a11y/observability), Constraints & Assumptions, Dependencies & Risks, Analytics, Rollout Plan, Open Questions
  • Store interim answers; allow save/resume
  • Add domain templates: prd_saas.md, prd_marketplace.md, prd_fintech.md, prd_healthcare.md
  • Update @analyst greeting to offer: (1) Wizard (2) Use Prepared PRD (3) Brownfield assessment
  • Write to docs/PRD.md and back up previous version to docs/archive/PRD-<ts>.md
  • Unit tests for prompt-to-doc flow; ensure idempotent writes

Acceptance Criteria

  • Running @analyst offers Wizard; completing it produces a PRD with all required sections
  • Domain choice influences examples and checklists
  • Cyon test: wizard captures business goals and aims before stories; avoids placeholder content

References

  • Cyon repo docs with goals (e.g., CYON_VALUE_OFFERING_COMPREHENSIVE.md)
  • .a2dev/templates/prd.md in A2Dev (baseline)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions