doc/claude/j-space.md
Grounding: "Verbalizable Representations Form a Global Workspace in Language Models" (Transformer Circuits, 2026, https://transformer-circuits.pub/2026/workspace/index.html). The paper identifies a small, privileged set of internal representations — the J-space — that behaves like a global workspace: the model can report these concepts, deliberately compute with them, and reuse them as arguments to many downstream computations. Everything else is automatic processing that bypasses the workspace. Key findings that matter here:
A prompt or doc cannot target activations; the J-lens is an interpretability instrument, not a prompting API, and the paper studied one model family with a single-token-concept lens. The lever available at the CLAUDE.md/skill level is what the agent verbalizes, when, and how much. That lever is real: verbalizing a constraint immediately before the action loads it into the workspace where it can steer computation; a rule 200 lines back in context is background text that may never make it in.
Edit. The pre-edit
verbalization (discipline 1) is the deliberate-mode interrupt on those paths.tasks.md checklist — they are workspace extensions,
not paperwork.| Discipline | Operationalized by |
|---|---|
| Verbalize to load | ss-hotpath pre-edit statement; ss-new-driver contract restatement; cpp-compiler-flags nearest-invariant statement |
| Respect capacity | CLAUDE.md progressive disclosure (sub-docs + auto-skills); task-scoped invariant naming in ss-tasks |
| Break automatic mode | ss-hotpath auto-activation paths; ctor-closure rule in CLAUDE.md; spec-driven gates for non-trivial work |
| Counterfactual self-check | ss-implement Definition of Done self-review; CLAUDE.md "self-review before handoff" |
| Named lenses | ss-plan candidate designs; qt-cpp-review six named missions |
| Externalize to free capacity | spec-driven artifacts (spec.md/plan.md/tasks.md); ss-implement keeping tasks.md a live record; ss-tasks naming each task's binding invariant in its Does line |
These disciplines sharpen practices this repo already had ("state the plan", "read before writing", named review agents, the spec artifacts); the paper supplies the mechanism for why they work and the rule for applying them well: name it, name few, name it late, name it again before handoff — and write everything else down so it stops competing for the workspace.