Repository navigation
v1.4.0 — Comprehension Contract formalised as §7
What's new in v1.4.0
The Comprehension Contract is now fully formalised as §7 of the specification.
Specification: §7 Comprehension Contract (14 sub-sections)
The mechanism introduced at a high level in v1.3.0 now has a complete formal treatment across 14 sub-sections:
- §7.1 Structural Classifier — the action-time gate that must fire before any action executes
- §7.2 Quarantine and Composed Actions — path-completion timescale and action chain handling
- §7.3 Audit and Lesson Memory — days-to-weeks feedback loop closing the contract
- §7.4 Review Regime Formula — deterministic algorithm: Constitutional → Governance Council; Novel → Peer Review; Pre-registered + current + low blast → Event-line; else → REVIEW_TABLE[trust_tier][blast_radius]
- §7.5 Three Load-Bearing Properties — Completeness, Calibration, Temporal Closure
- §7.6 Classifier as Constitutional — why the classifier cannot be bypassed even for preauthorised actions
- §7.7 What the Contract Does Not Prevent — honest limits: micro-misalignment, false comprehension artefacts
- §7.8 Agent Mirror Changes — the four new Mirror fields that formalise the contract on disk
- §7.9 Relationship to Existing Mechanisms — how the Comprehension Contract interacts with the Trust Ladder, Equilibrium System, and Immune System
- §7.10 Critical Path Position — the structural vs. dynamic distinction
- §7.11 NFRs in the Mirror — colony-level and agent-specific non-functional requirements
- §7.12 Multi-Perspective Valuation — self, peer, audit, human dimensions; no single source authoritative
- §7.13 Graduation Checklist — how agents earn autonomy through demonstrated trustworthiness
- §7.14 False Comprehension Artefacts — micro-misalignment and four required defences (output-action consistency, blind audit, cross-agent blast radius verification, capability-tier heterogeneity)
Section renumbering
- Old §7 (Standards Landscape) → §8
- Old §8 (Scales of Application) → §9
- §7.5 sub-sections carry forward (now §8.5)
Two new conformance anti-patterns (§8.5.1, items 6 and 7)
- Shallow artefact production — agents that produce comprehension artefacts without genuine capability mapping
- Blast radius deflation — agents that systematically understate blast radius to avoid review
Supporting changes
thesis.md§3: Comprehension Contract subsection with Jones (2026) dark code and IndyDevDan (2026) citationsCHANGELOG.md: v1.4.0 entryCITATION.cff: version v1.4.0
Status: The pattern remains practically untested at production scale — no full LLM-backed reference implementation exists yet. The Comprehension Contract formalises the mechanism; the next step (v2.0) is empirical validation.
Previous release: v1.3.0 — Comprehension Contract Mirror fields, schema v0.2.0, hello-colony-runtime, equilibrium-playground
Cite as:
Oliver, D. (2026). The Agent Colony: A Pattern Language for Self-Governing AI Agent Ecosystems (v1.4.0). https://github.com/DavidROliverBA/agent-colony-pattern