Architecture Decision Records
Architecture Decision Records (ADRs) capture the key architectural decisions made during the development of Claude Ops. Each ADR documents the context, decision drivers, considered options, and the chosen approach with its trade-offs.
| ADR | Decision |
|---|---|
| ADR-0001 | Use Tiered Claude Model Escalation for Cost-Optimized Monitoring |
| ADR-0002 | Use Markdown Documents as Executable Instructions |
| ADR-0003 | Enforce Permission Tiers via Prompt Instructions and Allowed-Tool Lists |
| ADR-0004 | Use Apprise CLI for Universal Notification Abstraction |
| ADR-0005 | Allow Mounted Repos to Extend the Agent via Convention-Based Discovery |
| ADR-0006 | Use MCP Servers as Primary Infrastructure Access Layer |
| ADR-0007 | Persist Cooldown State in a JSON File on Mounted Volume |
| ADR-0008 | Build a Go/HTMX/DaisyUI Web Dashboard as the Application Entrypoint |
| ADR-0009 | Package as Docker Compose Application for Single-Host Deployment |
| ADR-0010 | Invoke Claude via Claude Code CLI as Subprocess |
| ADR-0011 | Show CLI Activity Log and Formatted Response on Session Page |
| ADR-0012 | Enable Browser Automation for Authenticated Web UIs via Chrome DevTools MCP |
| ADR-0013 | Manual Ad-Hoc Session Runs from the Dashboard |
| ADR-0014 | Real-Time Dashboard and Events System |
| ADR-0015 | Persistent Agent Memory System |
| ADR-0016 | Session-Based Escalation with Structured Handoff Files |
| ADR-0017 | REST API with OpenAPI Specification and Swagger UI |
| ADR-0018 | PR-Based Workflow for Runbook, Playbook, and Manifest Changes |
| ADR-0019 | MCP Server for Git Provider Interface |
| ADR-0020 | Bidirectional Notification Gateway (superseded) |
| ADR-0020 | OpenAI-Compatible Chat Endpoint for Mobile Access |
| ADR-0021 | Adopt pressly/goose for SQLite Schema Migrations |
| ADR-0022 | Skills-Based Tool Orchestration |
| ADR-0023 | AllowedTools-Based Tier Enforcement |
| ADR-0024 | Inbound Webhook Alert Ingestion via LLM-Mediated Prompt Synthesis |
| ADR-0025 | Use Markdown Input Format for Apprise Notifications |
| ADR-0026 | CI Pipeline Failure Detection and Self-Correction via Auto-Discovered Git Provider |
| ADR-0027 | URL-Driven Service Provisioning via Provisioning Mode |
| ADR-0028 | Use --dangerously-skip-permissions for Headless Non-Interactive CLI Execution |
| ADR-0029 | Hooks for Deterministic Lifecycle Guardrails |
| ADR-0030 | Structured Output via JSON Schema for Reliable Data Extraction |
| ADR-0031 | Session Continuity via --resume for Escalation Chains |
| ADR-0032 | Channel-Based Operator Interface |
| ADR-0033 | Persistent Session Architecture with Intra-Session Scheduling |