From b3510393cac106eebfe24461f5db28e2bac01bec Mon Sep 17 00:00:00 2001 From: Eric Rakestraw Date: Wed, 23 Sep 2026 08:31:09 -0500 Subject: [PATCH] Update the Documentation Policy to incorporate the updated Agent Policy and Release Policy --- docs/policy/agents.md | 2 +- docs/policy/documentation.md | 5 +++-- docs/policy/release.md | 4 ++-- 3 files changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/policy/agents.md b/docs/policy/agents.md index ddbc40f..5b7c03b 100644 --- a/docs/policy/agents.md +++ b/docs/policy/agents.md @@ -2,7 +2,7 @@ **Base Policy Version:** 1.0 -**Last Updated**: 2026-09-06 +**Last Updated**: 2026-09-23 ## Base Policy Template diff --git a/docs/policy/documentation.md b/docs/policy/documentation.md index 286534f..cc166e2 100644 --- a/docs/policy/documentation.md +++ b/docs/policy/documentation.md @@ -1,8 +1,8 @@ # Documentation Policy -**Base Policy Version:** 1.0 +**Base Policy Version:** 1.1 -**Last Updated**: 2026-09-06 +**Last Updated**: 2026-09-23 ## Base Policy Template @@ -73,6 +73,7 @@ secret values. | Product orientation and minimal end-to-end quickstart | `README.md` | What this application is, why it is useful, one shortest successful invocation, and links onward. | Complete command reference, configuration reference, operational procedures, implementation detail. | | Contributor entry point | `docs/development.md` | Task-oriented reading guide, minimal contributor orientation, baseline validation commands, and links to canonical docs. | Package inventory, architecture rules, subsystem behavior, detailed change recipes. | | Application architecture policy | `docs/policy/architecture.md` | System shape, normative ownership, dependency direction, architectural boundaries, invariants, safety properties, and non-goals. | Concrete package inventory, implementation mechanics, contributor procedures, decision history, future work. | +| Agent policy | `docs/policy/agents.md` | Implementation discipline for coding agents, including proportionality, idiomatic simplicity, and rules against inventing requirements, restrictions, guarantees, or repository policy. | Application contracts, architecture, testing policy, and contributor procedures. | | Documentation policy | `docs/policy/documentation.md` | Documentation ownership, audience boundaries, maintenance rules, and ADR/document lifecycle. | Application architecture or product behavior. | | Testing policy | `docs/policy/testing.md` | Test philosophy, risk-based sufficiency, test boundaries, doubles, coverage guidance, regression-test policy, and criteria for adding, rewriting, or deleting tests. | Subsystem behavior, application contracts, subsystem-specific test inventories, and implementation plans. | | Release policy | `docs/policy/release.md` | Versioning and compatibility rules, release integrity and immutability requirements, release-documentation policy, required gates, publication controls, verification requirements, and exception policy. | Repository-specific commands, product installation guidance, CLI version semantics, historical release summaries, and CI implementation detail. | diff --git a/docs/policy/release.md b/docs/policy/release.md index f673814..700361e 100644 --- a/docs/policy/release.md +++ b/docs/policy/release.md @@ -1,8 +1,8 @@ # Release Policy -**Base Policy Version:** 0.1.0 +**Base Policy Version:** 1.0 -**Last Updated**: 2026-09-06 +**Last Updated**: 2026-09-23 ## Base Policy Template