Skip to content

v1.4.0 — Comprehension Contract formalised as §7

Choose a tag to compare

@DavidROliverBA DavidROliverBA released this 13 Apr 20:29
· 12 commits to main since this release

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) citations
  • CHANGELOG.md: v1.4.0 entry
  • CITATION.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