Skip to main content

Case studies

Write-ups with enough detail to check the work — two tracks: reliability engineering and applied LLM systems.

2026

2026-01[amiable-templates]
Building an OSS Foundation: ADR-001 Implementation

How we established community standards for amiable-templates using Architecture Decision Records (ADRs) and multi-model AI review.

2026-01[amiable-templates]
Choosing MkDocs Material: ADR-002 Site Architecture

Why we chose MkDocs Material over Docusaurus or a custom solution, and how we structured the site.

2026-01[amiable-templates]
Designing the Template Registry: ADR-003

How we built a declarative configuration system for Railway templates with JSON Schema validation.

2026-01[amiable-templates]
CI/CD for a Docs Site: ADR-004

How we built a deployment pipeline that stays fresh without manual intervention.

2026-01[amiable-templates]
DevSecOps for a Docs Site (ADR-005)

We added security scanning to a documentation site. Most DevSecOps guides assume you have application code. We don't.

2026-01[amiable-templates]
Build-Time Documentation Aggregation (ADR-006)

We built a system to fetch documentation from multiple GitHub repositories at build time. The trick: SHA-based caching that makes incremental builds near-instant.

2026-01[stentorosaur]
Stentorosaur

A Docusaurus plugin that creates an Upptime-like status monitoring dashboard powered by GitHub Issues and Actions. Tracks both system uptime and process-based issues with real-time notifications.