Changelog

AGF follows Keep a Changelog. This page surfaces the highlights for site readers; the canonical CHANGELOG.md on GitHub is the source of truth.

Site-level infrastructure changes (build config, MDX-only edits) are excluded unless they affect published framework content.

Unreleased

Added

• First 30 Days workplan — a week-by-week starter at /docs/overview/first-30-days for teams adopting the Minimum Viable Control composition pattern. Prerequisites, four week sections (Inventory & Scope → Identity & Attribution → Provenance & Observability → Scoped Environment), and exit criteria into Validation Pipeline and Governed Decision Flow.
• Reference Walkthrough — a single threaded scenario at /docs/overview/reference-walkthrough tracing a customer refund through all four Rings, with two complete GDR YAML examples and a primitive/artifact/event mapping table.
• Transparency section — public surfaces for Changelog, Decisions, Roadmap, and Contribute.
• Confidence markers across flagship pages — empirical claims now carry <Confidence level="established|informed|open" /> proportional to the evidence base. Time-sensitive references (Agent 365 GA target, CSA AICM v1.0.3, Trust Ladders research citations) carry verification dates so readers can confirm currency.
• AI Engineering profile rewrite — restructured around the four canonical Composition Patterns instead of the retired "Phase 1–5" sequence. Pairs with the new First 30 Days and Reference Walkthrough pages for an AI engineer's reading path.

Changed

• Composition Patterns canonicalized at four (Minimum Viable Control / Validation Pipeline / Governed Decision Flow / Full Governed Agentic System). The "Phase 1–5" growth language is retired; the #11/#15/#18 hardening stack is expressed as a hardening posture modifier, not a fifth named pattern. See Decision D10(a).
• "Governance" qualifier conventions — five-sense disambiguation table added to /docs/resources/vocabulary. Bare "governance" is reserved for the framework sense; structural senses use qualified forms ("AGF" for the framework, "the Governance ring" or "Ring 2", "AGF program maturity", "Governance Gates", "NIST CSF Govern"). See Decision D10(b).
• Observability three-layer disambiguation — Primitive #10 emits, Agentic Observability correlates, the Observability Profile implements. See Decision D10(c).
• Per-signal dual-form table — the Composability Interface specification now includes a per-signal emission table (which Ring Control Signals emit observability events vs Governance Decision Records). Trust Ladder promotions/demotions now have an explicit GDR emission spec. See Decisions D5 / D9 and Governance Decision Record.

0.2.0 — 2026-04-22

Added

• Governance Decision Record (GDR) as canonical audit artifact at gate boundaries — new doc, JSON Schema (docs/schemas/gdr.yaml), five-state lifecycle. Decisions: D16 + D17.
• Relationship to Frameworks — new canonical doc positioning AGF in the seven-layer landscape (OWASP / MAESTRO / AICM / ATF / AGT / FAIR), with Trust Ladders ↔ ATF mapping.
• Macro positioning diagrams — seven-layer landscape, four-verb invariants, reference architecture macro.
• Gate Vocabulary disambiguation — four-part vocabulary (Ring Control Signals / Gate Resolutions / Domain Outcomes / GDR). Decision: D16.
• Five new vocabulary sections — positioning pillars, harness, maturity, identity & credentialing, governance program.
• DECISIONS.md entries D12–D17 — positioning pillars, seven-layer stack, gate-boundary dual-form, maturity model, harness definition, gate vocabulary, GDR.
• 16-diagram refresh — full architecture diagram set regenerated.

Changed

• L1 Maturity renamed from "Awareness" → "Non-existent". Inventory content absorbed into L2 Foundation. Decision: D14.
• Primitive #8 (Governance Gates) now requires GDR emission at every gate resolution.
• Cross-doc references updated for new relationship-to-frameworks doc and GDR primitive.

Fixed

• Gate-boundary dual-form language reconciled across relationship-to-frameworks.md per D16.

0.1.0 — 2026-03-19

Initial public release: Rings Model · 19 Primitives · Three-Level Security Model · Five domain profiles · Original 18-diagram set · Documentation site at agf.jessepike.dev. License: CC BY 4.0 (docs); Apache-2.0 / MIT for tooling.

---

For commit-level history and the complete Unreleased section, see the canonical CHANGELOG on GitHub.