Skip to content

Architecture Decision Records

The decisions behind Rootweaver — context, the call that was made, and what it cost. 74 ADR records · 7 legacy records · 4 historical design notes, including proposals, superseded decisions and one withdrawn duplicate.

ADR archive · records through 30 June 2026

Full source bodies, with disclosure edits marked. This is a record-date cutoff: the text was retrieved on 14 October and includes labelled later amendments. The journal remains separately backfilled through 14 June.

Explore the dated journey →
Source history and reconciliation

85 records

id decision status
ADR-088 Self-Healing SRE — LLM Autonomy LadderSource record accepted ADR-087 Severity-Routed Discord Alerting via Self-Built masgustavos ForwarderSource record accepted ADR-086 GPU/WebGL Graph Lens over FalkorDB (rootweaver-console Graph Tab)Source record accepted ADR-085 Self-Host the spend-tracker Off-Cloud: Private Forgejo, k8s Secrets, Code-Only RepoSource record accepted ADR-084 Data-Driven CI/CD Engineering: Measurement, Pipeline Optimization, and LLM-Channel ContractsSource record accepted ADR-083 Sever the neural-vault Import Blind Spot (vs Workspace-ify It)Source record accepted ADR-082 Vault Ingest Lanes and Lane-Aware RetrievalContains later amendments accepted ADR-081 Evaluation Harness Governance FrameworkSource record accepted ADR-080 Cluster-Wide Namespace Taxonomy and rootweaver DecompositionSource record accepted ADR-079 Claude-drives-Codex Autonomous Handoff (Dual-Agent Coding Routing)Later context accepted ADR-078 Writable Console Terminal — Socket-Bounded ttyd Supersedes Read-Only Mirror (Phase A)Source record accepted ADR-077 Inter-Hop Context Compaction for Multi-Hop ReasoningSource record accepted ADR-076 Radar→Mac YouTube Transcript-Extraction Lane (off-cluster, rationed, BYO-data)Source record accepted ADR-075 Workload-Level Provenance for Autonomous Agent CommitsSource record proposed ADR-074 AI Agent Subscription Budget Governance (Claude + Codex)Source record accepted ADR-073 Interactive Agent Sessions — Audited Free-Form Supersedes Template-OnlySource record accepted ADR-072 Agent-Ops Console Module — Desktop Session Runner with Template-Gated LaunchSource record accepted ADR-071 Graph Node Lifecycle & Event-Loop Offloading ContractSource record accepted ADR-070 Config-Keyed Client SingletonsSource record accepted ADR-069 LLM-Facing Diagnostics API (Curated, Read-Only, sre-brain)Source record proposed ADR-068 Memory API in rag-gateway; mcp-bridge Becomes a Thin ProxySource record proposed ADR-067 Dual-Audience HTTP API Contract (LLM-First Conventions)Source record proposed ADR-066 Feature-Flag Fail-Closed PolicySource record accepted ADR-065 Kafka Consumer & Producer Durability ContractSource record accepted ADR-064 Vault Path & Payload ContractSource record accepted ADR-063 Dreaming Enrich Re-Extraction — Hardened Two-Phase Memory Re-Mining with Supersede GateSource record proposed ADR-062 Deprecate 99-Meta As Live Retrieval And Workflow SurfaceSource record accepted ADR-061 Developer-Agent Provenance & Cryptographic AttributionSource record accepted ADR-060 Heterogeneous Multi-Node k3s: Dedicated Worker Nodes & Node-Separated Backup TierLater context accepted ADR-059 Memory-Writer Asynchronous Embedding (Decouple from Hot Path)Source record accepted ADR-058 Rootweaver Deployment Contracts for Baked Images and TEI-Safe EmbeddingSource record accepted ADR-057 MCP Bridge Efficiency: Composite Tools over Full Code-Execution MigrationContains later amendments accepted ADR-056 Dynamic Test Impact Analysis for CI (selective per-package testing)Source record proposed ADR-055 Data-Store Backup Strategy & the Qdrant Snapshot-Disruption TradeoffSource record accepted ADR-054 Dedicated CPU Embedding Worker Node (rduffy-mini)Later context accepted ADR-053 Observability Data Routing — Multi-Backend Log/Trace/Metric StrategyLater context accepted ADR-052 Benchmark Agentic Metrics and Statistical ImprovementsSource record accepted ADR-051 Radar Feed Acquisition — Tiered Hierarchy for Sites Without Native RSSSource record proposed ADR-050 Personal Industry Radar Pipeline — Native Workspace ImplementationSource record accepted ADR-049 Personal Industry Radar Pipeline — Precis + Karpathy LLM Wiki + Claude Code Subscription SynthesisSource record superseded · in part ADR-048 Egress Control Strategy — Forward Proxy Now, CNI Migration LaterSource record proposed ADR-047 LLM Content Trust Boundary — Four-Layer Defence with End-to-End ProvenanceSource record accepted Note MCP transport: moving from SSE to Streamable HTTPHistorical design note design note ADR-046 Memory-System Embedder Architecture — Dimension + Deployment DecisionSource record accepted · caveats Note Measuring search quality with a repeatable benchmarkHistorical design note design note ADR-045 Memory Eval Methodology v2 — Engineering Memory FocusSource record proposed ADR-044 Memory Eval Methodology v1 — Synthesis-Layer, Anchor-Mode Toggle, Three-Tier Artifact Split [SUPERSEDED]Source record superseded Note Refusal gate: answer only when the evidence supports itHistorical design note design note ADR-043 Memory System Derived-Data GDPR PositionSource record proposed ADR-042 NL-to-Cypher LLM Backend SelectionSource record accepted ADR-041 K3s Pods Dashboard ArchitectureSource record accepted ADR-040 NER System Evaluation — Span-Based ExtractionContains later amendments accepted ADR-039 Anthropic GitHub Tools IntegrationSource record proposed ADR-038 Daily Consolidator Reads JSONL Directly + Streaming Synth Model SwapSource record accepted ADR-037 Daily Journal Consolidator External API DependencySource record superseded ADR-036 Vault Structured Index in PostgresContains later amendments accepted ADR-035 Q2 2026 Retrieval, Inference & Evaluation Enhancement ProgramContains later amendments proposed ADR-034 Data Source Connector ArchitectureContains later amendments proposed ADR-033 Short-Form Video Generation PipelineSource record proposed ADR-032 Journal LLM Context Handling for Large SessionsSource record proposed ADR-031 Journal LLM Context Handling for Large SessionsSource record withdrawn ADR-030 Repository Structure for AI-Assisted DevelopmentContains later amendments accepted ADR-029 KEDA-Based GPU Swap Controller for Embed/Inference CoexistenceLater context accepted ADR-026 Agent Lifecycle Patterns — Lessons from Claude Code Source LeakSource record proposed ADR-025 Trading Intelligence Platform ArchitectureSource record proposed ADR-024 GitLab Flow Branching and Release StrategySource record proposed ADR-023 HLD-Aware Architecture Review PipelineSource record proposed ADR-022 Local LLM Hybrid Routing — From Claude Code Augmentation to Full ReplacementSource record accepted ADR-020 Enterprise-Grade CodeGraph PlatformLater context proposed ADR-019 Claude Voice Agent Architecture — VoiceAssistant-Eval Benchmarking & Prompt Repetition OptimizationSource record proposed Note K3s on the home platformHistorical design note design note ADR-017 SRE Agent Architecture — Autonomous Infrastructure Monitoring with Change IntelligenceSource record proposed ADR-016 Modular Architecture DocumentationSource record accepted Legacy 015 Graphiti + FalkorDB Knowledge Graph IntegrationLegacy source · identity notes inside accepted Legacy 015 Matrix Accessibility Layer ArchitectureLegacy source · identity notes inside proposed Legacy 014 MCP Bridge Authentication StrategyLegacy source · identity notes inside proposed ADR-013 Migrate LLM Observability from OpenLIT+ClickHouse to Kafka→Vector→ElasticsearchSource record proposed Legacy 013 Secret Management Strategy for Rootweaver PlatformLegacy source · identity notes inside accepted ADR-012 Journal Pipeline Quality Overhaul — Model Selection & E2A ArchitectureSource record proposed ADR-011 Journal Consolidator LLM Generation TuningSource record accepted ADR-010 Streaming Journal System ArchitectureSource record accepted Legacy 009 Unified Classification System ArchitectureLegacy source · identity notes inside proposed Legacy 008 Trunk-Based Development with Feature FlagsLegacy source · identity notes inside proposed ADR-001 LinkedIn Content Automation PipelineSource record accepted Legacy Anthropic GitHub Tools IntegrationLegacy source · identity notes inside proposed

81 source documents: 74 ADR records (including the withdrawn duplicate) and seven legacy documents found outside the main ADR directory. Legacy records retain conflicting or unregistered numbers; they are not newly allocated canonical ADRs. The four journal design notes remain separate. Source reproduction does not establish deployment or independently revalidate historical claims.