docs/architecture/BASE_ARCHITECTURE.md

BASE_ARCHITECTURE.md

Components

Orchestrator

Coordinates tasks, selects agents, enforces workflow gates and tracks status.

Codebase Scout

Searches existing code, docs and tests before implementation.

Data Agent

Handles datasets, schemas, temporal metadata and anti-leakage checks.

Code Agent

Implements scoped changes after the reuse decision and minimal design.

Reviewer

Checks correctness, scope, security, tests and leakage before merge.

Context Compressor

Updates PROJECT_STATE.md with durable memory and removes conversation noise.

Storage

Stores project files, reports, templates, ADRs and local configuration.

Reports

Task reports live under reports/task_reports/ and provide the audit trail.

Project State

PROJECT_STATE.md is the short memory read before every task.

Mermaid Architecture

flowchart LR
    U[User] --> O[Orchestrator]
    O --> S[Codebase Scout]
    S --> O
    O --> D[Data Agent]
    O --> C[Code Agent]
    C --> T[Tests]
    D --> L[Leakage Audit]
    C --> R[Reviewer]
    L --> R
    T --> R
    R --> TR[Task Reports]
    R --> PS[Project State]
    PS --> O
    TR --> O