Skip to content

Repository files navigation

APEX MicroHack

1-day hackathon: Master IaC-driven Azure infrastructure delivery using platform engineering practices — accelerated by GitHub Copilot.

Overview

This repository contains the workshop docs site, facilitator guides, and governance scripts. Participants do not work directly in this repo during the event.

Repository Purpose Who uses it
This repo (apex-microhack) Workshop docs, facilitator guides, scoring rubric, governance scripts Facilitators, content maintainers
APEX Accelerator (apex-accelerator) Starting point for participant work — contains agents, skills, dev container, and Bicep + Terraform scaffolds Participants ("Use this template" → create your own)

APEX stands for Agentic Platform Engineering eXperience for Azure. Teams use GitHub Copilot to move from requirements through Azure platform design, implementation planning, and delivery.

Participants should create their own repository from the APEX Accelerator template instead of cloning this repository directly. Participant guidance is published at microhack.apexops.pro.

Participant Path

  1. Create a working repository from the APEX Accelerator.
  2. Read Getting Started for the participant overview.
  3. Complete the Setup Guide before the event.
  4. Read Workshop Prep for the scenario and team roles.

Maintainer Commands

  • Use Node 24 (.node-version or .nvmrc) for local maintenance and CI parity.
  • npm install
  • cd site && npm install && npm run lint:md && npm run build

Repository Structure

site/                   # Astro Starlight documentation site
facilitator/            # Facilitator guide, scoring rubric, solution reference
scripts/                # Governance PowerShell scripts

Quick Links

Resource Description
APEX Accelerator Create your own working repository from the template
Workshop Docs Published participant guidance
Getting Started Orientation page for participants
Setup Guide Canonical pre-event setup, quota, and cleanup page
Workshop Prep Scenario, mission, and team roles
Copilot Guide Agents, skills, and prompting tips
Quick Reference Card Printable one-page cheat sheet
Scoring Rubric WAF-aligned evaluation criteria
Troubleshooting Common issues and fixes

License

This project is released under the MIT License.

About

Apex Microhack

Resources

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages