# Agent Control Plane Documentation

Welcome to the Agent Control Plane documentation! This comprehensive guide will help you understand, use, and contribute to the Agent Control Plane.

## Table of Contents

### Getting Started
- [Quick Start Guide](guides/QUICKSTART.md) - Get up and running in 5 minutes
- [Implementation Guide](guides/IMPLEMENTATION.md) - Implementation details and best practices
- [Philosophy](guides/PHILOSOPHY.md) - Core principles and design philosophy

### Architecture & API
- [Architecture Overview](architecture/architecture.md) - System architecture and components
- [Core API](api/CORE.md) - Main API reference

### Advanced Topics
- [Adapter Guide](ADAPTER_GUIDE.md) - Framework integration (OpenAI, LangChain, MCP, A2A)
- [Advanced Features](ADVANCED_FEATURES.md) - Shadow Mode, Mute Agent, Supervisors
- [Docker Deployment](DOCKER_DEPLOYMENT.md) - Production containerization

### Research & Reproducibility
- [Research Foundation](RESEARCH_FOUNDATION.md) - Theoretical basis
- [Related Work](RELATED_WORK.md) - Academic context
- [Bibliography](BIBLIOGRAPHY.md) - References and citations
- [Reproducibility](REPRODUCIBILITY.md) - How to reproduce results
- [Ablation Studies](ABLATION_STUDIES.md) - Component analysis
- [Limitations](LIMITATIONS.md) - Known limitations and future work
- [Case Studies](CASE_STUDIES.md) - Real-world applications

### Publishing
- [PyPI Publishing](PYPI_PUBLISHING.md) - Package distribution guide
- [Release Notes v1.1.0](RELEASE_v1.1.0.md) - Latest release details

### Examples
See the [examples directory](../examples/) for working code examples:
- Basic Usage - Fundamental concepts
- Advanced Features - Mute Agent, Shadow Mode, etc.
- Configuration - Different agent profiles

### Contributing
- [Contributing Guide](../CONTRIBUTING.md) - How to contribute to the project

## What is Agent Control Plane?

Agent Control Plane is a governance and management layer for autonomous AI agents. It treats the LLM as a raw compute component and provides a kernel-like layer for safe, controlled execution.

For complete documentation, see the main [README](../README.md).

## Quick Links

- [GitHub Repository](https://github.com/imran-siddique/agent-control-plane)
- [PyPI Package](https://pypi.org/project/agent-control-plane/)
- [Issue Tracker](https://github.com/imran-siddique/agent-control-plane/issues)
- [Research Paper](../paper/draft_main.md)

## License

This project is licensed under the MIT License - see the LICENSE file for details.
