ADR-0001: Pattern Library Organization
Decision to organize engineering knowledge into three levels with patterns in this repository.
ADR-0002: AI Agent Entrypoint
Decision to require AGENTS.md as mandatory entrypoint for AI agents in every repository.
ADR-0003: Taskfile as Contract
Decision to use Taskfile as the mandatory operational contract for repository operations.
ADR-0004: Infrastructure Layout
Decision to use .infra/ convention for infrastructure-as-code in application repositories.
ADR-0006: AWS Resource Tagging Taxonomy
Decision to establish a mandatory three-tier tagging taxonomy for all AWS resources to enable cost allocation and operational traceability.
ADR-0007: AWS Bedrock Inference via Application Inference Profiles
Decision to require application inference profiles for all AWS Bedrock model invocations to enable cost attribution and tagging.
ADR-0008: Python Dependency Management with uv
Decision to adopt uv as the standard Python dependency and project management tool, replacing Poetry.
ADR-0010: Repository Context Directory Convention
Decision to adopt .context/ as a structured directory for sharing repository knowledge between humans, AI coding agents, and sessions.
ADR-0011: Lambda Deploy Strategy
Decision to use direct zip upload as the default Lambda code deployment method from CI/CD.
ADR-0012: Workflow Architecture for Multi-Environment Deploys
Extend the GitHub Actions Workflows pattern to cover authentication, multi-environment architecture, and topic ownership across CI/CD patterns.
ADR-0013: Taskfile Contract v2 — Prescriptive Naming and Recipes
Decisions to extend the Taskfile contract with prescriptive task naming, CI namespace, developer lifecycle, environment handling, and CodeArtifact recipes.
ADR-0014: setup:* Namespace as First-Use Setup Standard
Replaces dev:setup and dev:install with a setup:* namespace that models the distinct lifecycle of first-use setup operations independently from the daily developer workflow.
ADR-0015: Infrastructure Layer Model inside .infra/
Formalizes the bootstrap / shared / service layer model inside .infra/, each an isolated Terraform stack, and renames the CI-roles layer to bootstrap.