MicroHack LLM Context

An AI-agent-driven approach to creating customized MicroHack workshops.

This repository is the brain behind MicroHack content creation. Instead of containing fixed, final workshop content, it provides context, constitution, schemas, and skills that an AI agent uses to generate customized MicroHack instances — tailored to specific industries, event durations, difficulty levels, and guidance styles.

What's Inside

Folder	Purpose
constitution/	Core principles: what MicroHacks are, how they're structured, challenge design, technologies, environment provisioning, guidance levels
microhacks/	Challenge context catalog organized by topic (App Innovation, GitHub Platform, IaC, Data & AI, Security, Migration)
.github/agents/	Custom Copilot agents: @creator (builds + validates content), @tester (student simulator, hands-on execution)
.github/skills/	Technical skill references: Azure CLI, Bicep, Terraform, environment provisioning, GitHub Actions, portal guides, presentations
.github/prompts/	Reusable prompt templates for common tasks
AGENTS.md	Comprehensive agent instructions for Copilot CLI

How It Works

1. User invokes @creator and describes their event needs
2. Agent asks clarifying questions — topic, duration, audience, guidance level, challenges to include
3. Agent generates a complete MicroHack instance under instances/ — challenges, solutions, infrastructure code, devcontainer, CI/CD workflows
4. @tester validates the generated content by simulating a student experience (hands-on execution)
5. @deployer provisions the lab environment (this agent is generated inside the instance repo for teachers)

Generated instances are nested git repos inside the gitignored instances/ folder. Students clone the instance repo directly — it has its own .github/ with workflows, Copilot context, and optionally student-facing agents.

Guidance Levels

MicroHacks support three levels of guidance:

Level	Description	Best For
Lab Style	Step-by-step with screenshots and copy-paste commands	Beginners, time-constrained events
Light Challenge	Pre-built scaffolding with gaps to fill, fix, or extend	Intermediate audiences
Deep Challenge	Goals and hints only — build from scratch	Experienced teams, collaborative events

Available Topics

Topic	Challenges	Duration
App Innovation	Containerize, Azure SQL, Container Apps, Autoscaling, Monitoring	Full day
GitHub Platform	Codespaces, Copilot, Specs, Actions, DevSecOps	Full day
Infrastructure as Code	Manual Azure, Terraform, Modules, CI/CD	Full day
Data & AI	Fabric Lakehouse, Medallion Architecture, AI Agents	Full day
Security & Compliance	Governance, Encryption, Confidential Computing	Full day
Migration & Modernization	Azure Migrate, Copilot Modernization, Containerization	Full day

Getting Started

1. Open this repository in VS Code or GitHub Copilot CLI
2. Use @creator to start designing a new MicroHack
3. Or read the constitution to understand MicroHack principles

License

See LICENSE for details.