Skip to main content
Version: main 🚧

Development Guide

Welcome to the CAIPE development documentation! This section provides comprehensive guides for developers who want to contribute to the project or build their own agents and MCP servers.

📚 What You'll Learn​

This development guide covers:

🎯 Who Is This For?​

These guides are designed for:

  • Contributors wanting to add new features or fix bugs
  • Developers building custom agents for their organization
  • Platform Engineers extending the platform with new capabilities
  • Students learning about AI agents and MCP

🛠️ Prerequisites​

Before you begin, you should have:

  • Basic knowledge of Python 3.11+
  • Familiarity with async/await patterns
  • Understanding of REST APIs
  • Git and Docker installed
  • An LLM API key (OpenAI, Anthropic, or Azure OpenAI)

🚀 Quick Start Path​

  1. Understand spec-driven development - How CAIPE uses spec-kit for feature development
  2. Set up your development environment - Install dependencies and configure your workspace
  3. Explore the template agent - Understand the project structure
  4. Build your first agent - Follow the step-by-step guide
  5. Add an MCP server - Connect your agent to external APIs

📖 Additional Resources​

💡 Development Philosophy​

CAIPE follows these principles:

  • Convention over Configuration - Sensible defaults with flexibility
  • Security by Default - Built-in authentication and authorization
  • Observable & Traceable - OpenTelemetry integration out of the box
  • Test-Driven - Comprehensive testing with evaluations
  • Production-Ready - Docker, Kubernetes, and CI/CD support

🤝 Getting Help​

Let's build something amazing together! 🚀