# 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

```mermaid
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
```