Contents
Architecture Decision Records (ADRs) documenting key technical and design decisions.
Development Environment and Tooling
Section titled “Development Environment and Tooling”- ADR-0001: Claude Code multi-profile system
- ADR-0002: Use generic just recipes
- ADR-0009: Nix flake-based development environment
Nix Configuration
Section titled “Nix Configuration”Nix Fleet Architecture
Section titled “Nix Fleet Architecture”- ADR-0018: Deferred module composition architecture
- ADR-0019: Clan-core orchestration
- ADR-0020: Deferred module composition + Clan integration
- ADR-0021: Terranix infrastructure provisioning
Monorepo Architecture
Section titled “Monorepo Architecture”- ADR-0004: Monorepo structure
- ADR-0005: Semantic versioning with semantic-release
- ADR-0006: Monorepo tag strategy
- ADR-0007: Bun workspaces configuration
- ADR-0008: TypeScript configuration strategy
Testing and Quality
Section titled “Testing and Quality”Security and Secrets
Section titled “Security and Secrets”CI/CD and Deployment
Section titled “CI/CD and Deployment”- ADR-0012: GitHub Actions CI/CD pipeline
- ADR-0013: Cloudflare Workers deployment
- ADR-0016: Per-job content-addressed caching