CODITECT Architecture

This section contains architecture documentation for the CODITECT platform, including Architecture Decision Records (ADRs) that document significant technical decisions.

Architecture Decision Records (ADRs)

Browse All ADRs

Architecture Decision Records document the significant architectural decisions made during CODITECT development. Each ADR captures:

• Context - The situation and constraints that led to the decision
• Decision - What was decided and why
• Consequences - The positive and negative outcomes of the decision

Total ADRs: 56

Key ADRs by Category

Core Architecture

ADR	Title	Status
ADR-001	Async Task Executor Refactoring	Accepted
ADR-002	Hybrid Deployment Architecture	Accepted
ADR-047	CODITECT Platform Foundation	Accepted

Context & Memory

ADR	Title	Status
ADR-020	Context Extraction	Accepted
ADR-021	Context Query	Accepted
ADR-052	Intent-Aware Context Management	Accepted
ADR-053	Cloud Context Sync Architecture	Accepted

AI & Intelligence

ADR	Title	Status
ADR-008	MoE Analysis Framework	Accepted
ADR-009	MoE Judges Framework	Accepted
ADR-011	Self-Awareness Framework	Accepted
ADR-012	LLM Council Pattern	Accepted
ADR-060	MoE Verification Layer	Accepted

Component System

ADR	Title	Status
ADR-010	Component Capability Schema	Accepted
ADR-013	Agent Skills Framework Adoption	Accepted
ADR-049	Component Creation Lifecycle	Accepted

Security & Authentication

ADR	Title	Status
ADR-003	License Validation Strategy	Accepted
ADR-004	User Registration Authentication	Accepted
ADR-055	Licensed Docker Container Schema	Accepted

Infrastructure

ADR	Title	Status
ADR-057	CODITECT Core Initial Setup	Accepted
ADR-058	Machine Specific Session Logs	Accepted
ADR-061	Provisioning Strategies	Accepted
ADR-062	Statusline Configuration System	Accepted

---

System Design

High-Level Architecture

CODITECT follows a local-first, cloud-enhanced architecture:

┌─────────────────────────────────────────────────────────────┐
│                     Developer Machine                        │
│  ┌───────────────┐  ┌───────────────┐  ┌───────────────┐   │
│  │  Claude Code  │──│   CODITECT    │──│    Context    │   │
│  │    (IDE)      │  │    Core       │  │    Storage    │   │
│  └───────────────┘  └───────────────┘  └───────────────┘   │
│         │                   │                  │             │
└─────────┼───────────────────┼──────────────────┼─────────────┘
          │                   │                  │
          ▼                   ▼                  ▼
┌─────────────────────────────────────────────────────────────┐
│                    CODITECT Cloud (Optional)                 │
│  ┌───────────────┐  ┌───────────────┐  ┌───────────────┐   │
│  │   License     │  │    Context    │  │     Team      │   │
│  │   Service     │  │     Sync      │  │  Collaboration│   │
│  └───────────────┘  └───────────────┘  └───────────────┘   │
└─────────────────────────────────────────────────────────────┘

Key Principles

1. Local-First - All core functionality works offline
2. Cloud-Enhanced - Cloud services add collaboration and persistence
3. Component-Based - Modular architecture with 3,458 components
4. MoE Intelligence - Multiple AI models for specialized tasks

---

Further Reading

• Reference Documentation - Component reference
• Guides - Usage tutorials and best practices