# Development Workflow — WrinkleBrane

This document outlines development roles and testing procedures for the WrinkleBrane project.

## Roles

1) **Builder (Codex)**
   - Implements modules per `README.md` and unit tests.
   - Guardrails: preserve shapes; no silent dtype/device changes; pass tests.

2) **Experiment Runner**
   - Executes `experiments/p0_assoc_mem.py` sweeps and `viz_latents.py`.
   - Produces CSVs/plots; verifies capacity/interference claims.

3) **Telemetry Agent**
   - Computes and logs K/C/S/I via `telemetry.py`.
   - Monitors energy budgets and layer orthogonality.

4) **Validator**
   - Enforces limits: max per-layer energy, code coherence thresholds.
   - Flags anomalies: entropy spikes, excessive cross-talk.

5) **Archivist**
   - Version-controls artifacts (`results/`, `plots/`, `artifacts/`), seeds, configs.
   - Maintains CAR definitions for future P1 distillation.

## Loops

- **Build→Test Loop**
  1. Builder generates/updates code.
  2. Run tests in `tests/`.
  3. If any fail, fix and repeat.

- **Experiment Loop**
  1. Select sweep config (L,K,T,codes,alpha,λ).
  2. Run P0 harness; gather metrics.
  3. Telemetry Agent computes K/C/S/I; Validator evaluates thresholds.
  4. Archivist stores CSVs/plots with config hashes.

## Guardrails & Thresholds (initial)
- Gram coherence: max |off‑diag(Gram(C))| ≤ 0.1 (orthogonal modes)
- Energy clamp: per‑layer L2 ≤ configurable bound
- Interference scaling: empirical slope within band of √((T−1)/L)
- Logging: persist seeds, device, library versions

## Future (P1)
- Query-conditioned slicing agent; distillation CAR tracking; oblique/complex modes.