# Guides & How-To

This section contains practical guides and step-by-step instructions for common tasks.

## Quick Navigation

- **[Deployment Guide](deployment-guide.md)** - How to deploy the system
- **[Developer Guide](developer-guide.md)** - Development workflow and setup
- **[Migration Guide](migration-guide.md)** - Migrating data and systems
- **[Modernization Guide](modernization-guide.md)** - Python and infrastructure modernization
- **[Team Onboarding](team-onboarding.md)** - Getting new team members productive

## Practical Guides

### For MCP/CLI/API
- **[MCP/CLI/API Matrix](mcp-cli-api-matrix.md)** - Capability matrix + offline/online behavior
- **[Config Precedence](config-precedence.md)** - Where config lives and how it resolves

### For Operations
- **[Deployment Guide](deployment-guide.md)** - Production deployment procedures
- **[Troubleshooting](../08-reference/troubleshooting.md)** - Common issues and fixes

### For Development
- **[Developer Guide](developer-guide.md)** - Local development setup
- **[Contributing](../01-getting-started/contributing.md)** - Contribution workflow
- **[Migration Guide](migration-guide.md)** - Data and system migrations

### For Teams
- **[Team Onboarding](team-onboarding.md)** - Onboarding new members
- **[Quick Reference](../08-reference/quick-reference.md)** - Common commands and patterns

### For Infrastructure
- **[Modernization Guide](modernization-guide.md)** - Infrastructure updates
- **[Architecture](../02-architecture/README.md)** - System design

## Task-Based Navigation

| Task | Guide |
|------|-------|
| Deploy to production | [Deployment Guide](deployment-guide.md) |
| Set up development environment | [Developer Guide](developer-guide.md) |
| Migrate data | [Migration Guide](migration-guide.md) |
| Modernize infrastructure | [Modernization Guide](modernization-guide.md) |
| Onboard new team member | [Team Onboarding](team-onboarding.md) |
| Get quick help | [Quick Reference](../08-reference/quick-reference.md) |
| Troubleshoot issues | [Troubleshooting](../08-reference/troubleshooting.md) |

## Related Documentation

- **Getting Started**: [Quick Start](../01-getting-started/quick-start.md)
- **Architecture**: [System Design](../02-architecture/README.md)
- **Reference**: [Glossary](../08-reference/glossary.md), [FAQ](../08-reference/faq.md)

---

**Last Updated**: November 2024
**Scope**: Practical how-to guides and operational documentation
