📄️ ADR-001: Async TaskExecutor Refactoring - CODITECT Core Framework
---
📄️ ADR-001: CODITECT Framework Architecture
Status
📄️ Overview
Architecture Decision Records documenting significant technical decisions. 77 ADRs covering system architecture, security, integration patterns, and more.
📄️ ADR 002: Hybrid Deployment Architecture (Local First + Cloud Services)
**Status:** Accepted **Date:** 2025-11-23 **Decision Makers:** Hal Casteel (Founder/CEO/CTO) **St...
📄️ ADR-003: CODITECT Agent System
Status
📄️ ADR-002 Addendum: License Validation Strategy
Document: ADR-002-ADDENDUM-LICENSE-VALIDATION-STRATEGY
📄️ ADR 003: User Registration and Authentication
**Status:** Accepted **Date:** 2025-11-23 **Decision Makers:** Hal Casteel (Founder/CEO/CTO) **St...
📄️ ADR 006: Work Item Hierarchy and Sprint Management for Project Planning
ADR-006: Work Item Hierarchy and Sprint Management for Project Planning Context and Problem Statement The Project Tracking Problem CODITECT currently uses fl...
📄️ ADR 010: Autonomous Multi Agent Orchestration System
Context and Problem Statement The Autonomous Operation Problem CODITECT's V2 project plan contains 122+ tasks organized in ADR-006 hierarchy (Epic → Feature ...
📄️ ADR-011: Uncertainty Quantification Framework for LLM Interactions
Context and Problem Statement
📄️ ADR 012: Mixture of Experts (MoE) Analysis Framework
Context and Problem Statement The Research Quality Problem Current multi-agent research workflows suffer from: Implicit Certainty - Findings presented withou...
📄️ ADR-013: Mixture of Experts (MoE) Judges Framework
Context and Problem Statement
📄️ ADR-009: CODITECT Multi-Tenant Architecture
Status
📄️ Component Capability Schema
Status: Accepted
📄️ Self-Awareness Framework
Status: Accepted
📄️ ADR-012: CODITECT Data Isolation Strategy
Status
📄️ ADR-016: LLM Council Pattern
Status: Accepted
📄️ ADR 017: Agent Skills Framework Adoption for A2A Protocol Parity
**Status:** Accepted **Date:** 2025-12-20 **Deciders:** Hal Casteel, CODITECT Core Team **Categor...
📄️ ADR 018: Agentic Documentation Standard v1.1.0
**Status:** Accepted **Date:** 2025-12-22 **Deciders:** Hal Casteel, CODITECT Core Team **Categor...
📄️ ADR 100: CODITECT Master Index Search and Retrieval System
**Status:** Proposed **Date:** December 16, 2025 **Author:** AZ1.AI INC / CODITECT Architecture T...
📄️ ADR-020: Context Extraction Command (/cx) - Anti-Forgetting Memory System
Status
📄️ ADR-021: Context Query System (/cxq) - Anti-Forgetting Memory Architecture
Status
📄️ Codebase Management Indexing and Search Expansion
Status: Proposed
📄️ SQLite Scalability Analysis for Codebase Intelligence Platform
Status: Accepted with Conditions
📄️ ADR-CXQ-009: Multi-Tenant Platform Architecture for CODITECT Intelligence Layer
Status: Proposed
📄️ Comprehensive Entry Schema - Zero Data Loss Extraction
Status: Accepted
📄️ ADR-026: Intent Classification System for LLM Inference Management
Status: Accepted
📄️ ADR-027: Guardrail Engine
Status
📄️ ADR LMS 004: User Authentication & Identity Management
**Status:** Proposed **Date:** 2025-12-11 **Phase:** Phase 2 - Core LMS Infrastructure **Deciders...
📄️ ADR-LMS-PHASE-1: Learning Management System - Onboarding Database Architecture
Status: Accepted
📄️ ADR LMS 007: Interactive Assessment Engine
**Status:** Proposed **Date:** 2025-12-11 **Phase:** Phase 2 - Core LMS Infrastructure **Deciders...
📄️ ADR-LMS-PHASE-2: Learning Management System - Advanced Learning Platform
Status: Proposed
📄️ ADR-LMS-005: Certificate Generation & Verification System
Status: Proposed
📄️ ADR LMS 010: External LMS Integration API
**Status:** Proposed **Date:** 2025-12-11 **Phase:** Phase 3 - Enterprise Integration **Deciders:...
📄️ ADR-LMS-006: SCORM/xAPI Compliance Layer
Status: Proposed
📄️ ADR 005: Token Accounting System for Cost Analysis and Budget Management
ADR-005: Token Accounting System for Cost Analysis and Budget Management Context and Problem Statement The Token Visibility Problem AI-assisted development w...
📄️ ADR WORKFLOW EXECUTOR: State Machine Orchestrated Workflow Execution
**Status:** Accepted **Date:** 2025-12-18 **Deciders:** Hal Casteel (Founder/CEO/CTO), CODITECT C...
📄️ ADR-LMS-008: Learning Analytics & Reporting
Status: Proposed
📄️ ADR-LMS-009: Instructor Dashboard & Admin Interface
Status: Proposed
📄️ ADR 044 Custom REST Sync Architecture
Custom REST sync replaces PowerSync due to FSL license restrictions and operational simplicity
📄️ ADR 045 Team/Project Context Sync Architecture
Team and project-level context backup and synchronization extending ADR-044
📄️ ADR-042: Litestream for Standalone SQLite Backup
Status: Superseded (Standalone Mode Only)
📄️ ADR-043 PowerSync PostgreSQL-SQLite Sync
Status: Accepted SUPERSEDED
📄️ ADR 050 Submodule Initialization Lifecycle
Standardized 5-step process for converting folders to CODITECT-compatible git submodules with GitHub repo creation and symlink setup
📄️ ADR-046: Continual Learning System
Status
📄️ ADR-047: CODITECT-PLATFORM Foundation Architecture Discovery
Executive Summary
📄️ ADR-048: PILOT Execution Workflow System
Status
📄️ ADR-049: Component Creation Lifecycle
Status
📄️ ADR-056: Task Tracking
Establishes the protocol for correlating tool calls to parent task IDs for complete audit trails
📄️ ADR-051: Work Discovery System
Status
📄️ Intent-Aware Context Management
Status: Accepted
📄️ ADR 057: CODITECT Core Initial Setup for Individual Contributors
Architecture decision record for CODITECT Core initial setup on macOS for individual contributors with protected installation location
📄️ ADR-053: Cloud Context Sync Architecture
Status
📄️ ADR-054: Track Nomenclature Extensibility
Status
📄️ ADR 060: MoE Verification Layer Constitutional Court Architecture
Multi-perspective verification layer using Constitutional Court pattern with judge personas, debate protocol, and multi-model evaluation
📄️ ADR-055 Licensed Docker Container Schema Design
Status
📄️ ADR-056 Container Session UI Architecture
Status
📄️ ADR-058: Machine-Specific Session Logs with Multi-Device Sync
Status
📄️ ADR-061: Provisioning Strategies - License & Workstation
| Field | Value |
📄️ ADR-062: Claude Code Statusline Configuration System
| Field | Value |
📄️ ADR-064: Master Inventory Management and Deployment Synchronization
| Field | Value |
📄️ ADR-065: Codanna Code Intelligence Integration
Status
📄️ ADR-066 Context Automation Services
Status
📄️ ADR-067 Time-Controlled Licensing System
Status
📄️ ADR-068 Large Project Plan Token Economics
Status
📄️ ADR-069: A2UI (Agent-to-User Interface) Integration
Status
📄️ ADR-070: ADK (Agent Development Kit) Integration
Status
📄️ ADR-072 Recent Files Command with Diff Analysis
Status
📄️ ADR-073: MoE Provider Flexibility - Single to Multi-Provider Modes
Status
📄️ ADR-074: SessionStart Governance Hook - Mandatory Skill Checking
Status
📄️ ADR-077: Recursive Agent Chain Architecture
Status
📄️ ADR-078: Subagent Context Isolation Pattern
Status
📄️ ADR-079: Trajectory Visualization System
Status
📄️ ADR-080: MCP Semantic Search with Hybrid RRF Fusion
Context and Problem Statement
📄️ Adr 081 Centralized Logging Architecture
Status: Accepted
📄️ ADR-083: Modular ZSH Configuration Architecture
Status
📄️ ADR-085: Atomic Design Component Library
---
📄️ ADR-086: AG-UI Event Protocol Integration
---
📄️ ADR-087: HITL Approval Workflow for UI Changes
---
📄️ ADR-096 Token Limit Pivot Management System
Status
📄️ ADR-100: Unified Nomenclature Standard - Track-Integrated System
Status
📄️ ADR-101: Database Usage Patterns for Discovery and Analytics
Status
📄️ ADR-102: Universal Semantic Index Architecture
Status
📄️ ADR-106: Contributor Framework Sync Workflow
Status
📄️ ADR-107 - Comprehensive Backup Strategy
Status
📄️ ADR-108 - Agent Checkpoint and Handoff Protocol
Status
📄️ ADR-110 - Agent Health Monitoring Layer
Status
📄️ ADR-111 - Token Economics Instrumentation
Status
📄️ ADR-112 - Ralph Wiggum Database Architecture
Status
📄️ ADR-113 - Post-Push Protected Installation Sync
Status
📄️ ADR-114 - User Data Separation from Framework
Status
📄️ ADR-117: Hierarchical Plan Location Strategy
Status
📄️ ADR-118: Four-Tier Database Architecture
Status
📄️ ADR-119: Multi-Tenant Local Database Schema
Status
📄️ ADR-120 - Unified Database Daemon & Script Consolidation
Status
📄️ ADR-121: Path Discovery Consolidation
Status
📄️ ADR-130 - Business Intelligence Dashboard Architecture
Status
📄️ ADR-131 - Dynamic BI Pages Cloud Architecture
Status
📄️ Adr 133 Kimi Automated Session Export
Status
📄️ Adr 134 Unified Multi Llm Watcher
Status
📄️ ADR-141 - Pitch Deck Mastery v3.0 Interactive Workflow Architecture
Status
📄️ ADR-142: Unified Development Studio Architecture
Status
📄️ ADR-143: IN-PLACE Document Translation Architecture
Status
📄️ ADR-144: Multi-Project Registry Architecture
Status
📄️ ADR-145: Project-Level RBAC & Multi-Tenant Access Control
Status
📄️ ADR-146: Unified Task ID Strategy for Multi-Project Environments
Status
📄️ ADR-147: Submodule Observability Dashboard Architecture
Status: Accepted
📄️ ADR-148: Database Schema Documentation Standard
Status
📄️ ADR-149: Query Language Evolution Strategy
Status
📄️ ADR-150: ADR Single Source of Truth Consolidation
Status
📄️ ADR-151: Context Graph Evolution Architecture
Status
📄️ Enterprise Plugin Architecture
Status
📄️ Plugin Development Framework
Status
📄️ ADR-154: Context Graph Query DSL and Agent Workflow Context Management
Status
📄️ ADR-155: Project-Scoped Session Logs Architecture
Status
📄️ ADR-156: Project-Scoped Context Databases Architecture
Status
📄️ Research-to-Artifacts Plugin Pattern
Status
📄️ ADR-158: Cloud Project Registration API
Status
📄️ ADR-159: Multi-Tenant Command Architecture
Status
📄️ ADR-160: Inter-Session Messaging Architecture
Status
📄️ ADR-161 Component Quality Assurance Framework
Status: Accepted
📄️ ADR-162: Progressive Component Disclosure Architecture
Status
📄️ ADR-163: Agentic Trajectory Dashboard Architecture
Status
📄️ ADR-164: Universal Document Object Model (UDOM)
Status
📄️ Adr 165 Wasm Split Architecture Browser Ide
Status: Proposed
📄️ Adr 166 Websocket Protocol Browser Ide Sidecar
Status: Proposed
📄️ Adr 167 Claude Code Cli Integration Zero Cost Llm
Status: Proposed
📄️ Adr 168 Module Extraction Codestory Sidecar
Status: Proposed
📄️ Adr 169 Browser Terminal Emulation Pty Websocket
Status: Proposed
📄️ ADR-170 Multi-Project Executive Dashboard with Autonomous Refresh
Status
📄️ ADR-171 Cloud-Hosted User Dashboard
Status
📄️ ADR-172: General Multi-Source Provider Architecture
Status
📄️ ADR-173: Structured Inter-Session Message Schema
---
📄️ ADR-174: Research Continuum — Agentic Knowledge Infrastructure
---
📄️ Adr 175 Component Migration Process
Status
📄️ ADR-176 Comprehensive Change Management Framework
Status
📄️ ADR-177 Database-Driven Financial Model Engine
Status
📄️ ADR-178: Orphan Task Detection and Context Vacuum
Status
📄️ ADR-179 Hybrid Financial Model Distribution Architecture
Status
📄️ ADR-180 Modular Product Installation Architecture
Status
📄️ ADR-181: Incremental Context Extraction and Watcher Role Redefinition
Status
📄️ ADR-182: Zero Trust File Integrity Registry
Status
📄️ ADR-183: Governance Hook Architecture
Status
📄️ ADR-184: Customer Backup Architecture
Status
📄️ ADR-186: Protected Installation and User Data Separation
Status
📄️ ADR-187 Lowercase Naming Migration
Status
📄️ ADR-188: Customer Extensions Architecture
Status
📄️ ADR-189: Activity Association Fallback Strategies
Status
📄️ ADR-190: Cross-LLM Bridge Architecture
Status
📄️ ADR-190 macOS Code Signing and TCC Compliance
Status
📄️ ADR-191: Intent Classification System
Status
📄️ ADR-192: Bidirectional Context Memory Sync Architecture
Status: Accepted SUPERSEDED
📄️ ADR-193: Licensed Docker Container Schema Design
Status
📄️ ADR-194: Codi-Watcher v3.0 — Hash-Based Change Detection
Status
📄️ ADR-195: Push-Button Documentation Publishing Platform
Status: Accepted
📄️ ADR-196: NDA-Gated Conditional Access Control
Status: Accepted
📄️ ADR-197: Unified Web Publishing Component System
Status: Accepted
📄️ ADR-198: Namespaced Component Registry Architecture
Status
📄️ ADR-199: Two-Phase Project Status Token Optimization
Status: Accepted
📄️ ADR-200 MiniMax Provider Integration
Status: Accepted
📄️ ADR-201 Multi-Provider LLM Gateway
Status: Accepted
📄️ ADR-202: MCP Call Graph — Memory-Linked Code Navigation
Context and Problem Statement
📄️ ADR-203: MCP Impact Analysis — Decision-Aware Change Risk Assessment
Context and Problem Statement
📄️ ADR-204: MCP Unified Gateway — Single-Endpoint MCP Aggregator
Context and Problem Statement
📄️ ADR-205: MCP Git Status — Submodule Health Monitoring
Context and Problem Statement
📄️ ADR-206: Autonomous Research Pipeline — Multi-Agent Workflow with Project Genesis Handoff
Status
📄️ ADR-207: Research Artifact Organization Taxonomy & Promotion Lifecycle
Status
📄️ ADR-208: Research-to-Product Promotion Lifecycle
Status
📄️ ADR-209: Executive Briefing Generator Integration
Status: Accepted
📄️ ADR-210: Background Agent Manifest for Session Recovery
Status
📄️ ADR-211: Validation Interview Tracking System
Status: Accepted
📄️ ADR-212: CODITECT.md as Controlled Source with CLAUDE.md Symlink
Status
📄️ ADR-213: Documentation Externalization to coditect-documentation
Status
📄️ ADR Renumbering Plan
Status: Proposed