From 75479abffa62e642824b5c09dd6b10466986468a Mon Sep 17 00:00:00 2001 From: Ty Date: Wed, 8 Jul 2026 20:19:10 +0000 Subject: [PATCH] docs: add Chapter 1 draft - Vision and Scope (chapter 1 draft complete) --- docs/MVP-PRD.md | 51 +++++++++++++++++++++++++++++++++---------------- 1 file changed, 35 insertions(+), 16 deletions(-) diff --git a/docs/MVP-PRD.md b/docs/MVP-PRD.md index 59de88d..a76a7a4 100644 --- a/docs/MVP-PRD.md +++ b/docs/MVP-PRD.md @@ -1,29 +1,48 @@ -# MVP PRD (Product Requirements Document) +## Chapter 1: Vision and Scope -**Status**: Stub / Draft -**Owner**: -**Last Updated**: 2026-07-08 +### 1.1 Vision -## 1. Overview +#### What are we building? -> TODO: High-level description of what the MVP should achieve. +Athena is an autonomous AI research intelligence engine designed to continuously ingest signals from multiple sources across the AI ecosystem, apply structured scoring, and use falsification logic to surface real practitioner momentum and cross-source convergence rather than noise. -## 2. Goals & Success Metrics +#### Why are we building it? -> TODO +The AI space produces an overwhelming volume of new research, tools, discussions, and model releases every day. Individual sources only provide partial views, making it difficult to distinguish genuine, sustained trends from one-day spikes. Without a system that can detect convergence across sources and validate momentum over time, real opportunities tied to emerging capability gaps are missed. -## 3. Core Features (MVP Scope) +#### What happens if we don’t build it? -> TODO +Without this capability, builders and researchers will continue to operate with fragmented, noisy signals. Early indicators of meaningful trends will remain hidden, decisions will stay reactive, and the ability to spot validated cross-source momentum before it becomes obvious will be lost. -## 4. Out of Scope +#### When must it be done? -> TODO +The foundational ability to reliably ingest, score, and validate signals through falsification must be established before meaningful trend detection and opportunity mapping can occur. This forms the core of the MVP and must be in place to enable the system to deliver on its intended value. -## 5. User Stories / Key Use Cases +### 1.2 Personas and Archetypes -> TODO +See committed document: +**`docs/Personas-and-Archetypes.md`** (on `MVP-milestone` branch) -## 6. Non-Functional Requirements +**Summary of scoped personas and archetypes for MVP:** -> TODO +**Personas** +- Pers-1 (Bob) – Sector Trend Tracker (New to AI) +- Pers-2 (Alice) – Content Creator +- Pers-3 (Sam) – Hermes Research Agent + +**Archetypes** +- Arch-1 (Small Scrappy VPS) +- Arch-2 (Research Consumption Layer) + +All user stories in this PRD are scoped to combinations of the above. + +### 1.3 Use Case Priority Taxonomy + +This PRD focuses on defining the core functionality required for MVP. It also catalogs use cases and requirements across V1.0 – V1.5 to maintain context. The primary goal is to deliver a working MVP, with future PRDs derived from the remaining prioritized content. + +We will use the following prioritization model: + +- **MVP**: The short list of P1 use cases required to prove the concept with a working prototype. +- **P1**: Use cases that are fundamental to successfully implementing the product vision. +- **P2**: Use cases that add strength, convenience, and quality to the product vision. +- **P3**: Use cases that bring additional value but can be cut if time or resource constrained.