CAIRA (Composable AI Reference Architectures) is a small reference library for agents building Azure AI solutions. The primary entrypoint is the CAIRA skill: install the skill, let your coding agent inspect this repository, and have it copy or adapt only the reference pieces that fit your scenario.
Each directory under reference-architectures/ is an independent reference component that should be easy to read, validate, copy, and modify.
Install the skill from your project directory:
bunx skills add github.com/microsoft/CAIRA/skillsor:
npx skills add github.com/microsoft/CAIRA/skillsThen ask your agent to use CAIRA for your scenario, for example:
Create an agentic monitoring system to detect security-related issues in a configured GitHub repository using Foundry, an API, and a React frontend with a dashboard.
| Path | Purpose |
|---|---|
reference-architectures/iac/foundry/ |
Terraform for a Foundry account, project, and model deployment. |
reference-architectures/iac/container-apps/ |
Terraform for Azure Container Apps hosting exactly two apps: API and frontend. |
reference-architectures/app/api/typescript/openai-agents-sdk/ |
Agentic API reference for Typescript using the OpenAI Agents SDK. |
reference-architectures/app/api/typescript/foundry-agent-service/ |
Agentic API reference for Typescript using Foundry Agent Service. |
reference-architectures/app/api/csharp/microsoft-agent-framework/ |
Agentic API reference for C# and Microsoft Agent Framework. |
reference-architectures/app/frontend/typescript/react/ |
Minimal React frontend with a small BFF proxy to the API. |
Install dependencies and validate all reference components:
task bootstrap
task validateValidation is intentionally component-local: TypeScript components use npm scripts, C# uses .NET build, Terraform uses fmt/init/validate, and each app container has a Dockerfile that can be built independently. You can also run pieces independently with task security, task validate:code, and task validate:containers.
The CAIRA skill test can be run locally with task test:skill. It installs the skill into a fresh empty workspace, runs the README example prompt through GitHub Copilot CLI in unattended mode, then asks Copilot to verify the generated result.
For information related to developing CAIRA, start with the documentation in docs/. It includes contributor guidance, local environment setup, troubleshooting notes, and the repository security posture.