Copyright © 2026 Saccadic LLC · Patent pending.

Browse chapters
  1. Release NotesChanges by version
  2. Chapter 1What IRIS Is and Is Not
  3. Chapter 2The IRIS Data Model
  4. Chapter 3How IRIS Measures
  5. Chapter 4Safe Interpretation and the First 15 Minutes
  6. Chapter 5Dashboard Overview
  7. Chapter 6Installation
  8. Chapter 7Configuration
  9. Chapter 8Build the Model Spec and Probe Set
  10. Chapter 9Minimal Tracker Integration
  11. Chapter 10Launch the Bench and Verify Capture
  12. Chapter 11Runtime Control, Signals, Metrics, and Logs
  13. Chapter 12Integration Patterns by Model Family
  14. Chapter 13Distributed Training
  15. Chapter 14Artifacts, Reports, Export, and Security
  16. Chapter 15Troubleshooting
  17. Chapter 16Whole Model and Layer Structure
  18. Chapter 17Domain Training and Affinity
  19. Chapter 18Attention-Head Diagnostics
  20. Chapter 19MoE Expert and Router Diagnostics
  21. Chapter 20Facets and Emergent Pathways
  22. Chapter 21Gradient Residuals, Stability, Curvature, and Update Efficiency
  23. Chapter 22Adaptive Cadence and Event Detection
  24. Chapter 23CLI Reference
  25. Chapter 24Configuration-Key Reference
  26. Chapter 25API Reference
  27. Chapter 26File and Schema Reference
  28. Chapter 27Glossary and Concept Index
  29. Chapter 28The Flow Map
  30. Appendix ADiagnostic Availability Matrix
  31. Appendix BLLM Prompt Library
On this page

Chapter 18 — Attention-Head Diagnostics

What a head view covers

Head diagnostics require attention-head structure and the corresponding capture. A declared model without attention does not acquire heads through a setting. A supported model can still lack a head reading on frames where its inputs were not captured or were shed.

Compare effective dimensionality, similarity, motion, and available residual or weight-motion-share readings across the model's actual heads. Use stable head/layer identities and the same measured frame when comparing panels. A head's displayed role label is descriptive; it is not a validated claim that the head implements a named algorithm.

Layer numbering

Read the layer numbering convention with the chart. IRIS™ layer indices are not an additional embedding layer, and model wrappers can expose different module names. Use the spec and the chart's own labels to match a reading to the model rather than inferring identity from screen position.

Coverage and interpretation

An inactive-looking head on the chosen probes is not proof that it is unnecessary on the training distribution. Similar-looking heads are not automatically interchangeable. A concentrated motion share is an observation about that interval, not a statement that the remaining heads are finished.

Check domain and category coverage before interpreting a per-category head view. Keep uncertainty, missing-channel notes, and architecture limits with any exported image. If a head interests you, examine representative probes and independent task behavior before proposing a mechanism.

Attention-head contributions — Figures 6.20–6.24

Where the architecture and captures support them, these figures inspect what individual heads write and compare contributions across pairs of probe groups. Preserve each figure's grouping, frame, coverage, and availability explanation. A measured difference in contribution does not, by itself, establish that a head implements a named behavior or circuit.