feat(learning): Add CAIRA Fundamentals and Troubleshooting Kata Series

[eedorenko]

Summary

This PR introduces a comprehensive learning kata series for CAIRA, providing hands-on exercises for platform engineers and solutions architects to build proficiency with CAIRA reference architectures.

What's Included

CAIRA Fundamentals Category (5 katas)

• Kata 100: Gathering Requirements with CAIRA Assistant (30min) - AI-assisted requirements analysis
• Kata 150: Understanding CAIRA Architecture Patterns (30min) - Architecture comparison and decision-making
• Kata 200: Devcontainer & Foundry Basic Deployment (39min) - First infrastructure deployment
• Kata 350: Validating CAIRA with Sample AI Application (45min) - End-to-end validation
• Kata 400: Customizing CAIRA for Your Requirements (45min) - Production customization

Troubleshooting Category (1 kata)

• Kata 300: Troubleshooting CAIRA Deployments (60min) - Diagnostic skills for deployment failures

Supporting Content

• Category README files with learning paths and prerequisites
• Kata comparison matrices for guided learning sequences
• Real-world application scenarios
• Common challenges and solutions

Learning Path Structure

Requirements Gathering (Kata 100)
    ↓
Architecture Understanding (Kata 150)
    ↓
First Deployment (Kata 200)
    ↓
Validation (Kata 350)
    ↓
Customization (Kata 400)

Total Time: ~189 minutes for complete foundational proficiency

Key Features

• ✅ All katas validated with proper YAML frontmatter (28 fields each)
• ✅ Progressive difficulty scaling (beginner to intermediate)
• ✅ Heavy scaffolding for beginners with step-by-step guidance
• ✅ Integration with CAIRA Assistant chatmode
• ✅ Devcontainer workflow emphasis
• ✅ Real-world scenarios without company names
• ✅ Comprehensive prerequisites and success criteria

Target Audience

• Platform engineers new to CAIRA
• Solutions architects evaluating CAIRA for organizations
• DevOps engineers deploying Azure AI Foundry
• Teams onboarding to CAIRA reference architectures

Testing

• All katas pass validation script checks
• Frontmatter schema compliance verified
• Links validated
• Time estimates based on actual completion testing

How do I learn with Katas?

1. Install the HVE Learning VS Code extension

2. Open any accelerator repository (e.g., CAIRA, edge-ai)

3. Select learning-kata-coach from the Agents dropdown

4. Start your learning session directly in the domain context:

   Coach me on CAIRA architecture patterns Kata
   

Note: Claude Sonnet 4.5 model currently gives the most interactive learning experience, but feel free to go with a model of your choice.

HVE Learning

Related Issues

Addresses the need for hands-on learning content to accelerate CAIRA adoption and reduce time-to-value for platform teams deploying Azure AI Foundry environments.

[eedorenko]

There are two more katas under construction. There will a separate PR for them

[Copilot]

Pull request overview

This PR introduces a comprehensive learning kata series for CAIRA, consisting of 6 hands-on exercises organized into two categories: CAIRA Fundamentals (5 katas) and Troubleshooting (1 kata). The series provides progressive, scaffolded learning from requirements gathering through deployment customization, with validated frontmatter, real-world scenarios, and AI coaching integration.

Key Changes:

• Added complete CAIRA Fundamentals learning path (Katas 100, 150, 200, 350, 400) covering requirements gathering, architecture patterns, devcontainer deployment, validation, and customization
• Introduced Troubleshooting category with diagnostic methodology kata (Kata 300) for deployment failures
• Established category README files with learning paths, prerequisites, and comparison matrices

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
learning/katas/README.md	Entry point for kata series with learning-kata-coach integration instructions
learning/katas/caira-fundamentals/README.md	Category overview with 5-kata learning path, prerequisite guidance, and real-world applications
learning/katas/caira-fundamentals/100-gathering-requirements-with-caira-assistant.md	Beginner kata teaching AI-assisted requirements gathering and architecture selection
learning/katas/caira-fundamentals/150-understanding-caira-architecture-patterns.md	Architecture comparison kata covering all 4 CAIRA reference architectures
learning/katas/caira-fundamentals/200-devcontainer-foundry-basic-deployment.md	First deployment kata using devcontainer workflow and Terraform
learning/katas/caira-fundamentals/350-validating-caira-with-sample-ai-application.md	End-to-end validation kata with Python application testing
learning/katas/caira-fundamentals/400-customizing-caira-for-your-requirements.md	Production customization kata teaching terraform.tfvars configuration
learning/katas/troubleshooting/README.md	Troubleshooting category overview with systematic diagnostic methodology
learning/katas/troubleshooting/300-troubleshooting-caira-deployments.md	Troubleshooting kata covering 6 common failure scenarios with resolution procedures

[eedorenko]

@rameshmanian