glassbox

Coding conventions and architectural constraints for the Glassbox repository — ESM-only, zero-dependency, no-network, single normalization boundary, strict layering, one-metric-per-file, graceful degradation. Read when writing or reviewing any code in this repo.

The Glassbox harness operating loop — how to start a session, work one feature at a time, verify before claiming done, and leave a clean handoff. Based on walkinglabs Learn Harness Engineering. Read at the start of any working session and before claiming completion.

Reference for the Claude Code JSONL transcript schema as consumed by Glassbox — the normalized Event model and the (to-be-confirmed) raw field mapping. Read when working on discover.js, read.js, normalize.js, or classify.js. Update the "Confirmed raw schema" section after the Slice 1 discovery spike.