troubleshooting

• [@kazini](https://github.com/kazini) in their spec kit https://github.com/kazini/yask-spec-kit
• Amazon in internal presentations: _"It’s the best stuff I have found on [spec driven development]. I will be sharing links back to your repo with full attribution."_

New to spec-driven development? → Start with [Methodology Overview](spec-process-guide/methodology/README.md)

Ready to create your first spec? → Jump to [Process Guide](spec-process-guide/process/README.md)

Looking for examples? → Browse [Examples & Case Studies](spec-process-guide/examples/README.md)

Need templates? → Get [Ready-to-Use Templates](spec-process-guide/templates/README.md)

Working with AI? → Learn [Prompting Strategies](spec-process-guide/prompting/README.md)

📍 Need detailed navigation? → See [Complete Navigation Index](spec-process-guide/NAVIGATION.md) - Find content by role, problem, or learning style

---

🎯 [Methodology](spec-process-guide/methodology/README.md)

Learn the foundational concepts and philosophy behind spec-driven development

• [Overview](spec-process-guide/methodology/overview.md) - Core concepts and benefits
• [Philosophy](spec-process-guide/methodology/philosophy.md) - Why spec-driven development works
• [When to Use](spec-process-guide/methodology/when-to-use.md) - Decision framework and scenarios

📋 [Process Guide](spec-process-guide/process/README.md)

Step-by-step walkthrough of the three-phase workflow

• [Requirements Phase](spec-process-guide/process/requirements-phase.md) - Gathering and structuring requirements using EARS
• [Design Phase](spec-process-guide/process/design-phase.md) - Creating comprehensive design documents
• [Tasks Phase](spec-process-guide/process/tasks-phase.md) - Breaking down design into actionable coding tasks
• [Workflow Diagrams](spec-process-guide/process/workflow-diagrams.md) - Visual process flows and decision points

🧠 [AI Reasoning](spec-process-guide/ai-reasoning/README.md)

Insights into decision-making frameworks and thought processes

• [Decision Frameworks](spec-process-guide/ai-reasoning/decision-frameworks.md) - How choices are evaluated
• [Thought Processes](spec-process-guide/ai-reasoning/thought-processes.md) - Analysis and prioritization methods
• [Examples](spec-process-guide/ai-reasoning/examples.md) - Real reasoning chains and decision points

💬 [Prompting Strategies](spec-process-guide/prompting/README.md)

Effective communication techniques for AI collaboration

• [Strategies](spec-process-guide/prompting/strategies.md) - Core prompting approaches
• [Templates](spec-process-guide/prompting/templates.md) - Ready-to-use prompt patterns
• [Best Practices](spec-process-guide/prompting/best-practices.md) - Tips for clear, effective communication

⚡ [Execution Guide](spec-process-guide/execution/README.md)

Practical guidance for implementing features from specs

• [Implementation Guide](spec-process-guide/execution/implementation-guide.md) - Step-by-step execution strategies
• [Quality Assurance](spec-process-guide/execution/quality-assurance.md) - Testing and validation techniques
• [Troubleshooting](spec-process-guide/execution/troubleshooting.md) - Common issues and solutions

📚 [Resources](spec-process-guide/resources/README.md)

Curated references and learning materials