---
roadcrew_template_name: "vision-prd.template.md"
roadcrew_template_type: "template"
roadcrew_template_version: "v2.0"
roadcrew_last_updated: "2025-10-25"
roadcrew_min_version: "1.5.0"
roadcrew_license: "Apache-2.0"
roadcrew_copyright: "Copyright (c) 2025 North Star Holdings, LLC"
spdx_license_identifier: "Apache-2.0"
---

# Product Vision: {{PROJECT_NAME}}

> **This is the Long-Term Product Vision** - It defines WHERE we're going, WHY it matters, and WHO we serve. For detailed product requirements, see PRDs in `memory-bank/requirements/prds/`. For technical implementation, see Specifications in `memory-bank/requirements/specs/`.

**References:**
- 📖 [README](../README.md) - System overview and getting started
- 💼 [Business Strategy](brds/) - Business requirements and monetization
- 📋 [Product Requirements](prds/) - Detailed feature requirements (PRDs)
- 🔧 [Technical Specs](specs/) - Implementation specifications
- 🎯 [Current Release](../memory-bank/releases/current-release.md) - Active goals and epics
- 📦 [Past Releases](../memory-bank/releases/past-releases.md) - Completed release history
- 🔮 [Future Releases](../memory-bank/releases/future-releases.md) - Planned features and roadmap

---

## Document Purpose

**Vision.md (This Document) = Long-Term Product Vision**

This document defines the strategic direction and long-term vision for {{PROJECT_NAME}}. It translates high-level strategic goals into phases and capabilities that inform PRDs, specs, and implementation.

**What It Defines:**
- **WHERE:** Long-term strategic direction (3-5 year horizon)
- **WHY:** Market position, competitive advantages, business outcomes
- **WHO:** Target customers, personas, market segments
- **WHEN:** Capability evolution across phases
- **WHAT:** High-level capabilities and feature themes

**How It's Used:**
- Informs PRD creation for specific features and releases
- Guides long-term roadmap and milestone planning
- Provides strategic context for product decisions
- Aligns team and stakeholders on direction

**Audience:** Leadership, investors, product managers, stakeholders

---

**Document Hierarchy:**
- **Vision (this doc)** → Long-term strategic direction
- **PRDs (memory-bank/requirements/prds/)** → Specific product requirements for features
- **Specs (memory-bank/requirements/specs/)** → Technical implementation details
- **Releases (memory-bank/releases/)** → Epics and issues for execution

**Relationship:** Vision defines strategy → PRDs define features → Specs define implementation → Epics/Issues execute the work.

---

**Vision Statement:**

{{VISION_STATEMENT}}

---

## 🎯 Business Outcomes (Why This Matters)

{{PROJECT_NAME}} delivers **measurable business results**, not activity metrics:

|| **Business Measure** | **Metric** | **Impact** |
||----------------------|------------|------------|
|| {{BUSINESS_MEASURE_1}} | {{METRIC_1}} | {{IMPACT_1}} |
|| {{BUSINESS_MEASURE_2}} | {{METRIC_2}} | {{IMPACT_2}} |
|| {{BUSINESS_MEASURE_3}} | {{METRIC_3}} | {{IMPACT_3}} |
|| {{BUSINESS_MEASURE_4}} | {{METRIC_4}} | {{IMPACT_4}} |
|| {{BUSINESS_MEASURE_5}} | {{METRIC_5}} | {{IMPACT_5}} |
|| {{BUSINESS_MEASURE_6}} | {{METRIC_6}} | {{IMPACT_6}} |
|| {{BUSINESS_MEASURE_7}} | {{METRIC_7}} | {{IMPACT_7}} |

---

## 🌐 System Overview

{{SYSTEM_OVERVIEW_DESCRIPTION}}

### What the System Handles Automatically
{{AUTOMATED_CAPABILITIES}}

### Deployment Modes

{{PROJECT_NAME}} supports three deployment architectures:

1. **{{DEPLOYMENT_MODE_1_NAME}}** - {{DEPLOYMENT_MODE_1_DESCRIPTION}}
2. **{{DEPLOYMENT_MODE_2_NAME}}** - {{DEPLOYMENT_MODE_2_DESCRIPTION}}
3. **{{DEPLOYMENT_MODE_3_NAME}}** - {{DEPLOYMENT_MODE_3_DESCRIPTION}}

Commands auto-detect mode and adapt behavior accordingly.

### When the System Defers to Humans (Preserving Quality & Strategy)

{{HUMAN_HANDOFF_NOTE}}

**Critical criteria for human involvement:**
{{HUMAN_HANDOFF_CRITERIA}}

---

## 📈 Capability Ladder

{{CAPABILITY_LADDER_NOTE}}

|| **Level** | **Capability & AI Role** | **Human Time Today** | **Velocity Gain** |
||-----------|--------------------------|---------------------|-------------------|
|| **0** | {{LEVEL_0_NAME}} | {{LEVEL_0_HUMAN_TIME}} | {{LEVEL_0_VELOCITY}} |
|| **1** | {{LEVEL_1_NAME}} | {{LEVEL_1_HUMAN_TIME}} | {{LEVEL_1_VELOCITY}} |
|| **2** | {{LEVEL_2_NAME}} | {{LEVEL_2_HUMAN_TIME}} | {{LEVEL_2_VELOCITY}} |
|| **3** | {{LEVEL_3_NAME}} | {{LEVEL_3_HUMAN_TIME}} | {{LEVEL_3_VELOCITY}} |
|| **4** | {{LEVEL_4_NAME}} | {{LEVEL_4_HUMAN_TIME}} | {{LEVEL_4_VELOCITY}} |
|| **5** | {{LEVEL_5_NAME}} | {{LEVEL_5_HUMAN_TIME}} | {{LEVEL_5_VELOCITY}} |
|| **6** | {{LEVEL_6_NAME}} | {{LEVEL_6_HUMAN_TIME}} | {{LEVEL_6_VELOCITY}} |
|| **7** | {{LEVEL_7_NAME}} | {{LEVEL_7_HUMAN_TIME}} | {{LEVEL_7_VELOCITY}} |
|| **8** | {{LEVEL_8_NAME}} | {{LEVEL_8_HUMAN_TIME}} | {{LEVEL_8_VELOCITY}} |
|| **9** | {{LEVEL_9_NAME}} | {{LEVEL_9_HUMAN_TIME}} | {{LEVEL_9_VELOCITY}} |
|| **10** | {{LEVEL_10_NAME}} | {{LEVEL_10_HUMAN_TIME}} | {{LEVEL_10_VELOCITY}} |

---

## 💰 Business Model

{{BUSINESS_MODEL_DESCRIPTION}}

**Tier Structure:**
{{TIER_STRUCTURE}}

**Business Model Enablement:**
{{BUSINESS_MODEL_ENABLEMENT}}

---

## Phases & Use Cases

> **Note:** Release details are maintained in two files:
> - **Current Release:** `memory-bank/releases/current-release.md` (active, in-progress release)
> - **Future Releases:** `memory-bank/releases/future-releases.md` (upcoming releases and long-term roadmap)
>
> This section summarizes each release version with links to full details. To update, modify the source milestone files and sync here using `/sync-roadmap` or manual updates.

---

### **{{CURRENT_RELEASE_VERSION}}: {{CURRENT_RELEASE_NAME}}** {{CURRENT_RELEASE_STATUS}}

**GitHub Issue:** #{{CURRENT_RELEASE_GITHUB_ISSUE}}

**Goal:** {{CURRENT_RELEASE_GOAL}}

**Focus Metrics:**
{{CURRENT_RELEASE_FOCUS_METRICS}}

**Key Use Cases:**
{{CURRENT_RELEASE_USE_CASES}}

**Scope:**
- Epic 1: {{CURRENT_RELEASE_EPIC_1_TITLE}} **GitHub Issue:** #{{CURRENT_RELEASE_EPIC_1_GITHUB_ISSUE}}
- Epic 2: {{CURRENT_RELEASE_EPIC_2_TITLE}} **GitHub Issue:** #{{CURRENT_RELEASE_EPIC_2_GITHUB_ISSUE}}
- Epic 3: {{CURRENT_RELEASE_EPIC_3_TITLE}} **GitHub Issue:** #{{CURRENT_RELEASE_EPIC_3_GITHUB_ISSUE}}
- Epic 4: {{CURRENT_RELEASE_EPIC_4_TITLE}} **GitHub Issue:** #{{CURRENT_RELEASE_EPIC_4_GITHUB_ISSUE}}
- Epic 5: {{CURRENT_RELEASE_EPIC_5_TITLE}} **GitHub Issue:** #{{CURRENT_RELEASE_EPIC_5_GITHUB_ISSUE}}

**Value:** {{CURRENT_RELEASE_VALUE}}

**Full Details:** [memory-bank/releases/current-release.md](../memory-bank/releases/current-release.md)

---

### Upcoming Releases (from Future Roadmap)

#### **{{FUTURE_RELEASE_1_VERSION}}: {{FUTURE_RELEASE_1_NAME}}** {{FUTURE_RELEASE_1_STATUS}}

**Goal:** {{FUTURE_RELEASE_1_GOAL}}

**Key Use Cases:**
{{FUTURE_RELEASE_1_USE_CASES}}

**Epics:**
- {{FUTURE_RELEASE_1_EPIC_1_TITLE}}
- {{FUTURE_RELEASE_1_EPIC_2_TITLE}}
- {{FUTURE_RELEASE_1_EPIC_3_TITLE}}

---

#### **{{FUTURE_RELEASE_2_VERSION}}: {{FUTURE_RELEASE_2_NAME}}** {{FUTURE_RELEASE_2_STATUS}}

**Goal:** {{FUTURE_RELEASE_2_GOAL}}

**Key Use Cases:**
{{FUTURE_RELEASE_2_USE_CASES}}

**Epics:**
- {{FUTURE_RELEASE_2_EPIC_1_TITLE}}
- {{FUTURE_RELEASE_2_EPIC_2_TITLE}}

---

#### **{{FUTURE_RELEASE_3_VERSION}}: {{FUTURE_RELEASE_3_NAME}}** {{FUTURE_RELEASE_3_STATUS}}

**Goal:** {{FUTURE_RELEASE_3_GOAL}}

**Key Use Cases:**
{{FUTURE_RELEASE_3_USE_CASES}}

---

#### **{{FUTURE_RELEASE_4_VERSION}}: {{FUTURE_RELEASE_4_NAME}}** {{FUTURE_RELEASE_4_STATUS}}

**Goal:** {{FUTURE_RELEASE_4_GOAL}}

**Key Use Cases:**
{{FUTURE_RELEASE_4_USE_CASES}}

---

**Full Future Roadmap:** [memory-bank/releases/future-releases.md](../memory-bank/releases/future-releases.md)