NAVIGATION.md

Complete Navigation Index

This comprehensive index provides multiple ways to navigate the Spec-Driven Development Guide based on your needs, experience level, and current goals.

🎯 Quick Start Paths

New to Spec-Driven Development

1. Methodology Overview - Understand the foundation
2. Simple Feature Example - See it in action
3. Requirements Template - Try it yourself
4. Process Guide - Learn the full workflow

Ready to Create Your First Spec

1. Requirements Template - Start here
2. Requirements Phase Guide - Detailed instructions
3. EARS Standards - Format reference
4. Prompting Strategies - Get better AI help

Working with AI Systems

1. Prompting Strategies - Core communication techniques
2. AI Decision Frameworks - Understand AI reasoning
3. Best Practices - Avoid common mistakes
4. Troubleshooting - Fix problems

Implementing from Specs

1. Implementation Guide - Execute tasks systematically
2. Quality Assurance - Maintain code quality
3. Tasks Template - Structure your implementation plan
4. Execution Troubleshooting - Handle implementation issues

📚 By Content Type

Core Methodology

• Methodology Overview - Philosophy and approach
• When to Use - Decision framework
• Process Guide - Three-phase workflow
• Workflow Diagrams - Visual process flows

Step-by-Step Guides

• Requirements Phase - Transform ideas to requirements
• Design Phase - Create technical architecture
• Tasks Phase - Break down into implementation steps
• Implementation Guide - Execute the plan

Templates & Tools

• Requirements Template - EARS-formatted structure
• Design Template - Comprehensive design framework
• Tasks Template - Implementation planning format
• Checklists - Quality validation checklists

Real Examples

• Simple Feature Specs - Basic feature examples
• Complex System Specs - Large system examples
• Case Studies - Success stories and lessons
• Troubleshooting Examples - Common mistakes

AI Collaboration

• Prompting Strategies - Core communication approaches
• Prompt Templates - Ready-to-use patterns
• Best Practices - Effective techniques
• AI Decision Frameworks - How AI makes choices

Reference Materials

• EARS Standards - Requirements syntax reference
• Tools & Resources - Recommended tools
• Tool Integration - Setup and configuration

🎭 By User Role

Developers

Start Here: Simple Feature Example

• Implementation Guide - Execute specs systematically
• Quality Assurance - Maintain code quality
• Troubleshooting - Fix common problems
• AI Reasoning - Understand AI decisions

Project Managers

Start Here: Methodology Overview

• When to Use - Decision framework
• Process Guide - Three-phase workflow
• Case Studies - Success stories
• Complex System Examples - Large project examples

Technical Leads

Start Here: Process Guide

• Design Phase - Architecture and technical decisions
• AI Decision Frameworks - Decision-making insights
• Complex System Specs - Advanced examples
• Quality Assurance - Quality standards

AI Practitioners

Start Here: AI Reasoning

• Decision Frameworks - Systematic decision-making
• Prompting Strategies - Effective communication
• Best Practices - Advanced techniques
• Thought Processes - Reasoning examples

🔍 By Problem/Need

"I don't know where to start"

→ Methodology Overview → Simple Example → Requirements Template

"My requirements are unclear/vague"

→ Requirements Phase Guide → EARS Standards → Troubleshooting

"I need help with technical design"

→ Design Phase Guide → AI Decision Frameworks → Complex Examples

"My AI collaboration isn't working well"

→ Prompting Strategies → Best Practices → Troubleshooting

"I'm stuck during implementation"

→ Implementation Guide → Quality Assurance → Execution Troubleshooting

"I need examples for my specific situation"

→ Simple Features → Complex Systems → Case Studies

📖 By Learning Style

Sequential Learners (Step-by-Step)

1. Methodology Overview
2. Process Guide
3. Requirements Phase
4. Design Phase
5. Tasks Phase
6. Implementation Guide

Example-Driven Learners

1. Simple Feature Example
2. Complex System Example
3. Case Studies
4. Templates

Reference-Oriented Learners

1. Standards Reference
2. Templates Collection
3. Tools & Resources
4. AI Decision Frameworks

Problem-Solving Learners

1. Troubleshooting Guide
2. Case Studies
3. Best Practices
4. Quality Assurance

🔗 Cross-Reference Map

Requirements ↔ Related Content

• Requirements Phase ↔ EARS Standards, Requirements Template
• User Stories ↔ Simple Examples, Troubleshooting
• Acceptance Criteria ↔ EARS Reference, Quality Assurance

Design ↔ Related Content

• Design Phase ↔ AI Decision Frameworks, Design Template
• Architecture Decisions ↔ Complex Examples, Case Studies
• Technical Research ↔ Prompting Strategies, Best Practices

Tasks ↔ Related Content

• Tasks Phase ↔ Implementation Guide, Tasks Template
• Task Breakdown ↔ Quality Assurance, Simple Examples
• Implementation Planning ↔ Execution Guide, Tools Reference

AI Collaboration ↔ Related Content

• Prompting ↔ AI Reasoning, Decision Frameworks
• Communication ↔ Best Practices, Troubleshooting
• Understanding AI ↔ Thought Processes, Case Studies

🏷️ Topic Tags

By Complexity Level

• Beginner: Methodology, Simple Examples, Templates
• Intermediate: Process Guide, Prompting Strategies, Implementation Guide
• Advanced: AI Reasoning, Complex Examples, Decision Frameworks

By Phase

• Requirements: Requirements Phase, EARS Standards, Requirements Template
• Design: Design Phase, Decision Frameworks, Design Template
• Tasks: Tasks Phase, Implementation Guide, Tasks Template

By Content Type

• Process: Process Guide, Workflow Diagrams
• Examples: Examples, Case Studies
• Templates: Templates, Checklists
• Reference: Resources, Standards

---

💡 Tip: Use your browser's search function (Ctrl/Cmd+F) to quickly find specific topics within this index.

← Back to Main Guide