# 📚 VERSATIL Framework Documentation

Welcome to the **VERSATIL SDLC Framework** documentation! Transform your development workflow with AI-powered agents that work like a world-class orchestra.

## 🚀 Quick Navigation

### For New Users
**Start here if you're new to VERSATIL:**
- [Quick Start](./getting-started/quick-start.md) - Get running in 5 minutes
- [Installation Guide](./getting-started/installation.md) - Detailed setup instructions
- [Troubleshooting](./getting-started/troubleshooting.md) - Common issues and solutions

### Meet the Agents
**Discover the 6 OPERA agents that power your workflow:**
- [Agents Overview](./agents/overview.md) - Introduction to all 6 agents
- [Maria-QA](./agents/maria-qa/) - Quality Guardian (85%+ test coverage)
- [James-Frontend](./agents/overview.md#james-frontend) - UI/UX Specialist (WCAG 2.1 AA)
- [Marcus-Backend](./agents/overview.md#marcus-backend) - API Architect (OWASP Top 10)
- [Sarah-PM](./agents/overview.md#sarah-pm) - Project Coordinator
- [Alex-BA](./agents/overview.md#alex-ba) - Business Analyst
- [Dr.AI-ML](./agents/overview.md#dr-ai-ml) - AI/ML Expert

### Core Features
**Explore what makes VERSATIL unique:**
- [RAG Memory System](./features/rag-memory.md) - Zero context loss
- [MCP Ecosystem](./features/mcp-ecosystem.md) - 11 strategic integrations
- [Quality Gates](./features/quality-gates.md) - Automated quality enforcement
- [MCP-Agent Mapping](./features/mcp-agent-mapping.md) - How agents use MCPs

### Setup Guides
**Integration and configuration help:**
- [Cursor IDE Integration](./guides/cursor-integration.md) - Setup for Cursor users
- [Credential Management](./guides/credential-management.md) - Secure API key setup
- [Migration Guide](./guides/migration-guide.md) - Migrate existing projects
- [Agent Troubleshooting](./guides/agent-troubleshooting.md) - Fix activation issues
- [RAG Implementation](./guides/rag-implementation.md) - Advanced RAG setup

### Reference
**Complete technical documentation:**
- [CLI & Slash Commands](./reference/commands.md) - All available commands
- [Programmatic API](./reference/api.md) - Use VERSATIL in your code

### For Enterprise Teams
**Production deployment and workflows:**
- [Deployment Guide](./enterprise/deployment.md) - Production deployment
- [CI/CD Workflows](./enterprise/workflows.md) - GitHub Actions integration
- [Edge Functions](./enterprise/edge-functions.md) - Serverless deployment

## 💡 Popular Topics

| I want to... | Read this |
|-------------|-----------|
| 🚀 Get started in 5 minutes | [Quick Start](./getting-started/quick-start.md) |
| 🤖 Understand how agents work | [Agents Overview](./agents/overview.md) |
| 🎯 Setup Cursor IDE integration | [Cursor Guide](./guides/cursor-integration.md) |
| 🧠 Learn about RAG memory | [RAG Memory](./features/rag-memory.md) |
| 🔧 Fix agent activation issues | [Troubleshooting](./guides/agent-troubleshooting.md) |
| 🏢 Deploy to production | [Deployment](./enterprise/deployment.md) |
| 📖 See all commands | [Commands Reference](./reference/commands.md) |
| 🔌 Use VERSATIL in my code | [API Reference](./reference/api.md) |

## 🎯 Documentation Philosophy

Our documentation follows these principles:

1. **Quick Wins First** - Get value immediately, learn details later
2. **Learn by Doing** - Every guide includes working examples
3. **No Jargon** - Clear, benefit-driven language
4. **Visual Learning** - Diagrams, examples, and screenshots
5. **Progressive Disclosure** - Start simple, go deep when needed

## 📊 What You'll Achieve

| Metric | Before VERSATIL | With VERSATIL |
|--------|----------------|---------------|
| **Context Retention** | 45% | 98%+ |
| **Development Speed** | Baseline | 3.2x faster |
| **Code Quality** | Manual reviews | 85%+ automated |
| **Bug Detection** | Post-deployment | Real-time |

## 🆘 Need Help?

- 💬 **Community**: [GitHub Discussions](https://github.com/Nissimmiracles/versatil-sdlc-framework/discussions)
- 🐛 **Issues**: [Report a Bug](https://github.com/Nissimmiracles/versatil-sdlc-framework/issues)
- 📧 **Email**: info@versatil.vc
- 📖 **Main README**: [Project Homepage](../README.md)

## 🤝 Contributing

Found a typo? Have a suggestion? We welcome contributions!

1. Fork the repository
2. Edit the documentation
3. Submit a pull request
4. See [CONTRIBUTING.md](../CONTRIBUTING.md) for details

---

**Ready to transform your workflow?** Start with the [Quick Start Guide](./getting-started/quick-start.md) →
