Skip to content

Source-Aware PRD Ingestion — aggregate goals from adjacent docs #23

Description

@DevVig

Summary
Augment the Assess phase to discover and ingest adjacent domain docs (e.g., value proposition, roadmap, market validation) to seed PRD sections with real content. Offer a preview and require confirmation before writing.

Why

  • Many repos already contain rich business docs (like Cyon). We should leverage them instead of generating placeholders.

Scope

  • Discovery + extraction pipeline with heuristics; safe preview mode

Tasks

  • Implement a2a/analyst/prd_aggregator.py:
    • Discover files by name/keywords: *VALUE*OFFERING*, *ROADMAP*, market*validation*, vision*, mission*, strategy*
    • Extract candidate content for sections (Goals, Personas, NFRs, Analytics, Rollout)
    • Summarize into structured JSON and a preview markdown
  • Add a2dev prd-ingest --preview CLI to show diff and let user accept
  • Wire ingest step into @analyst assess prepared as an optional enhancement
  • Cache parsed results; record sources in docs/timeline/

Acceptance Criteria

  • On Cyon, ingest pulls concrete goals/aims from CYON_VALUE_OFFERING_COMPREHENSIVE.md and roadmap files
  • Preview shows changes; accept writes to docs/PRD.md with citations in comments
  • Deterministic runs with temp=0; no hallucinated content

References

  • Cyon: CYON_VALUE_OFFERING_COMPREHENSIVE.md, CYON_FEATURE_ROADMAP_2025.md

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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