docs: add ADR index workflow, standardize all ADR formats
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s

- Add Gitea Action to auto-update README badges and ADR table on push
- Standardize 8 ADRs from heading-style to inline metadata format
- Add shields.io badges for ADR counts (total/accepted/proposed)
- Replace static directory listing with linked ADR table in README
- Accept ADR-0030 (MFA/YubiKey strategy)
This commit is contained in:
2026-02-09 17:25:27 -05:00
parent dd277f6459
commit 3a46a98be3
11 changed files with 200 additions and 60 deletions

View File

@@ -1,12 +1,9 @@
# ADR-0014: Docker Build Best Practices
# Docker Build Best Practices
## Status
Accepted
## Date
2026-02-02
* Status: accepted
* Date: 2026-02-02
* Deciders: Billy
* Technical Story: Standardize container build practices for GPU-heavy ML images
## Context

View File

@@ -1,12 +1,9 @@
# ADR-0015: CI Notifications and Semantic Versioning
# CI Notifications and Semantic Versioning
## Status
Accepted
## Date
2026-02-02
* Status: accepted
* Date: 2026-02-02
* Deciders: Billy
* Technical Story: Add pipeline notifications and automated versioning to Gitea Actions CI
## Context

View File

@@ -1,12 +1,9 @@
# ADR-0019: Python Module Deployment Strategy
# Python Module Deployment Strategy
## Status
Accepted
## Date
2026-02-02
* Status: accepted
* Date: 2026-02-02
* Deciders: Billy
* Technical Story: Define how Python handler modules are packaged and deployed to Kubernetes
## Context

View File

@@ -1,12 +1,9 @@
# ADR-0020: Internal Registry URLs for CI/CD
# Internal Registry URLs for CI/CD
## Status
Accepted
## Date
2026-02-02
* Status: accepted
* Date: 2026-02-02
* Deciders: Billy
* Technical Story: Bypass Cloudflare 100MB limit by using internal registry endpoints for CI pushes
## Context

View File

@@ -1,8 +1,9 @@
# ADR-0021: Notification Architecture
# Notification Architecture
## Status
Accepted
* Status: accepted
* Date: 2026-02-04
* Deciders: Billy
* Technical Story: Unify notification delivery across CI, alerting, and monitoring systems
## Context

View File

@@ -1,8 +1,9 @@
# ADR-0022: ntfy-Discord Bridge Service
# ntfy-Discord Bridge Service
## Status
Accepted
* Status: accepted
* Date: 2026-02-04
* Deciders: Billy
* Technical Story: Forward ntfy notifications to Discord webhooks with proper embed formatting
## Context

View File

@@ -1,8 +1,9 @@
# ADR-0023: Valkey for ML Inference Caching
# Valkey for ML Inference Caching
## Status
Accepted
* Status: accepted
* Date: 2026-02-04
* Deciders: Billy
* Technical Story: Consolidate and configure Valkey for ML caching use cases
## Context

View File

@@ -1,12 +1,9 @@
# ADR-0024: Ray Repository Structure
# Ray Repository Structure
## Status
Accepted
## Date
2026-02-03
* Status: accepted
* Date: 2026-02-03
* Deciders: Billy
* Technical Story: Document repository layout for Ray Serve and KubeRay image components
## Context

View File

@@ -1,6 +1,6 @@
# MFA and Yubikey Strategy
* Status: proposed
* Status: accepted
* Date: 2026-02-04
* Deciders: Billy
* Technical Story: Enable hardware security key (Yubikey) authentication across homelab applications
@@ -52,7 +52,7 @@ WebAuthn provides the best security (phishing-resistant) and user experience (to
| Application | WebAuthn Support | Current Status | Action Required |
|-------------|------------------|----------------|-----------------|
| Authentik | ✅ Native | ⚠️ In Progress | Configure enforcement policies |
| Authentik | ✅ Native | ✅ Implemented | Blueprint deployed via ConfigMap |
| Vaultwarden | ✅ Native | ✅ Implemented | None - WebAuthn enrolled |
## Authentik Configuration