References
Deep-dive technical documentation for optional follow-up.
Infrastructure
- Bootstrap - Complete bootstrap setup for both deployment modes
- Protection Strategies - Branch, tag, environment protection
- Deployment Modes - Multi-environment strategy and infrastructure
- CI/CD Workflows - Workflow architecture and mechanics
- Claude PR Review - Automated PR review setup: GitHub App, model auth paths, and workflow behavior
- Cloud SQL Scaling and Reliability - Instance tiers, backups, HA, connection pooling, monitoring
- Cloud Run Concurrency Tuning - Async runtime model and concurrency sizing
Security
- Security Posture - Defense-in-depth rationale and architectural security decisions
Operations
- ADK Origin Check Middleware - Origin validation, CORS interaction, and ALLOW_ORIGINS configuration
- Image Digest Resolution - Index vs platform digests, provenance verification, and digest-based debugging
- OpenTelemetry Architecture - ADK coexistence, instrumentation strategy, dependency management
Development
- Testing Strategy - Lane taxonomy and the unit-test guide
- Integration Tests - The Postgres + FastAPI lane: coverage, running locally, and CI
- Smoke Tests - The post-deploy lane: live-URL checks, authentication, running locally, and CI
- Agent Evals - The full agent-evaluation surface: formats, commands, metrics, and user simulation
- Code Quality - Tool usage and exclusion strategies
- Cloud Backend Options - Advanced options for uv run server with cloud backends
- Docker Compose Workflow - Watch mode, volumes, and configuration
- Dockerfile Strategy - Multi-stage builds and optimization
- MkDocs Setup - Documentation site setup and customization