Decision Index

ADRs and key architectural decisions across the organisation. Individual decision records are linked to their source files — the wiki does not duplicate their full content.

CascadeGuard ADRs

#	Decision	Status	Summary
001	Cloudflare Stack with Python Workers	Accepted	Full Cloudflare stack (Workers, Pages, D1, R2, Queues) with Python runtime — ~$1/mo MVP cost, zero ops
002	Auth Provider — Clerk	Accepted	Clerk for auth with GitHub SSO, org/team management, API key support; free tier for 10K MAU
003	CRM, Lead Management, and Billing	Proposed	HubSpot Free CRM for MVP; billing platform deferred to Beta (Stripe, Metronome, or Orb)
004	Migrate from Turso to D1	Accepted	Replace Turso with Cloudflare D1 for zero-latency local SQL binding, eliminating network hops
005	Dedicated GitHub Actions Repo	Accepted	Public cascadeguard-actions repo for reusable composite actions (build, scan, sign, publish)

Source: .ai/projects/cascadeguard/adr/

HIP Decisions

Decision	Status	Summary
k6 Load Testing Framework	Proposed	k6-based load testing with K8s Jobs; chosen over Gatling for Kubernetes-native flexibility

Source: .ai/projects/hip/perf-testing/

Infrastructure Decisions

Key architectural decisions embedded in infrastructure sub-project specs at .ai/projects/infrastructure/. These are documented as design specifications rather than formal ADRs.

Decision	Type	Summary
Authenticated External Ingress	Spec	External access architecture — authenticated ingress design for k8s-lab services
Central Secret Store	Design	ESO-based secrets management — centralised secret store with External Secrets Operator
Per-Agent Pod Architecture	Plan	Agent isolation model — dedicated pods per agent with resource controls
ZFS Storage Integration	Design	Storage layer — ZFS pool integration for persistent volumes
Multi-Repo Builder Worktrees	Spec	Build isolation — git worktree-based isolation for multi-repo builds
Ingress Management	Design	Ingress controller design and routing configuration
ClickHouse Stack	Spec	ClickHouse observability stack (currently disabled)
n8n Workflow Platform	Design	n8n workflow automation on Kubernetes (currently disabled)
Security Proxy	Design	Security proxy for external service access
Repository Structure	Design	Multi-repo layout and conventions

Source: .ai/projects/infrastructure/

Market Making Decisions

Design decisions in .ai/projects/market-making/. Documented as specs and design docs rather than formal ADRs.

Decision	Type	Summary
Grid Exit Strategy	Spec	Position closing approach — strategy for exiting grid trading positions
Regime Management	Design	Market regime detection — design for identifying and responding to market conditions
Dashboard Architecture	Design	Data visualisation — dashboard for market maker monitoring and metrics
Dashboard Spot Checks	Spec	Validation framework for dashboard data accuracy

Source: .ai/projects/market-making/

Steering Documents

See standards for the 18 living steering documents that codify ongoing development standards and workflows.

Related

• cascadeguard — CascadeGuard project
• development-tools — Infrastructure project