# MCP Ticketer Documentation

Welcome to the comprehensive documentation for MCP Ticketer - the universal ticket management interface for AI agents.

**📍 New here? See the [Documentation Navigation Map](NAVIGATION.md) for a complete overview of all documentation.**

## Documentation Structure

Our documentation is organized by audience and purpose:

### 🚀 [Getting Started](getting-started/README.md)
Quick setup and initial configuration
- [MCP Endpoint Setup](getting-started/MCP_ENDPOINT_SETUP.md)
- [Quick Start Guide](getting-started/QUICK_START.md)
- [Configuration Guide](getting-started/CONFIGURATION.md)

### 📖 [User Guides](guides/README.md)
Comprehensive guides for using MCP Ticketer
- [User Guide](guides/USER_GUIDE.md)
- [Bulletproof Ticket Creation](guides/BULLETPROOF_TICKET_CREATION.md)
- [Label Management](guides/LABEL_MANAGEMENT.md)

### ⚡ [Features](features/README.md)
Feature documentation and capabilities
- [Automatic Validation](features/AUTOMATIC_VALIDATION.md)
- [Semantic Priority Matching](features/SEMANTIC_PRIORITY_MATCHING.md)
- [Token Pagination](features/TOKEN_PAGINATION.md)

### 👨‍💻 [Developer Documentation](developer/README.md)
For contributors and developers
- [Development Guide](developer/DEVELOPMENT.md)
- [API Reference](developer/api/README.md)
- [Adapter Development](developer/adapters/README.md)
- [Release Management](developer/releasing/README.md)

### 🏛️ [Architecture Documentation](architecture/README.md)
Technical deep-dives and design documents
- System architecture
- Design documents (PRD)
- Integration architecture

### 🔌 [Integration Guides](integrations/README.md)
Platform-specific setup and integration
- AI client integration
- Platform setup guides (Linear, JIRA, Claude Desktop, etc.)
- Pull request integration

### 📚 [Reference Documentation](reference/)
Technical reference and API documentation
- [CLI JSON Output](reference/CLI_JSON_OUTPUT.md)
- [Project URL Validation](reference/project-url-validation.md)
- [MCP Tools](reference/mcp-tools/)

### 🔧 [Troubleshooting](troubleshooting/README.md)
Common issues and solutions
- [Troubleshooting Guide](troubleshooting/TROUBLESHOOTING.md)
- General troubleshooting steps
- Adapter-specific issues (Linear, GitHub, JIRA)
- Configuration and performance issues

### 🔄 [Migration Guides](migration/README.md)
Version migration and upgrade guides
- [Migration v2.0.2](migration/MIGRATION-v2.0.2.md)
- [Upgrading v2.0](migration/UPGRADING-v2.0.md)

### 📦 [Releases](releases/README.md)
Release notes and version information
- [Release v2.0.2](releases/RELEASE-v2.0.2.md)
- Version verification reports

### 🗄️ [Archive](_archive/README.md)
Historical documentation and older reports

---

## Quick Start Paths

### I'm a new user
1. [Quick Start Guide](getting-started/QUICK_START.md)
2. [Configuration Guide](getting-started/CONFIGURATION.md)
3. [User Guide](guides/USER_GUIDE.md)

### I want to integrate with an AI client
1. [AI Client Integration](integrations/AI_CLIENT_INTEGRATION.md)
2. Choose your platform: [Claude Desktop](integrations/setup/CLAUDE_DESKTOP_SETUP.md), [Codex](integrations/setup/CODEX_INTEGRATION.md)
3. [Bulletproof Ticket Creation](guides/BULLETPROOF_TICKET_CREATION.md)

### I want to contribute
1. [Development Guide](developer/DEVELOPMENT.md) - Build system, testing, and workflows
2. [Developer Guide](developer/getting-started/DEVELOPER_GUIDE.md)
3. [Contributing Guide](developer/getting-started/CONTRIBUTING.md)
4. [Code Structure](developer/getting-started/CODE_STRUCTURE.md)

### I need to understand the architecture
1. [Architecture Overview](architecture/README.md)
2. [MCP Integration](architecture/MCP_INTEGRATION.md)
3. [API Reference](developer/api/README.md)

---

## Documentation Standards

- **Format**: Markdown (`.md`) for all active documentation
- **Organization**: Audience-based directory structure
- **Links**: Relative links within documentation
- **Updates**: Documentation updated with each release
- **Archive**: Historical docs moved to `_archive/`

## Getting Help

- **Having Issues?**: Check the [Troubleshooting Guide](troubleshooting/TROUBLESHOOTING.md) first
- **Missing Information**: Open an issue describing what's missing
- **Unclear Instructions**: Submit a pull request with improvements
- **Broken Examples**: Report with steps to reproduce
- **General Questions**: Check [User Guide](guides/USER_GUIDE.md) or GitHub Discussions

---

**Last Updated**: December 2025
**Documentation Version**: 3.0 (Reorganized and Consolidated)
