From 2a6d14f3a968f00dbc8ba9f4290dc581ae9f5f7d Mon Sep 17 00:00:00 2001 From: "Jonathan D.A. Jewell" <6759885+hyperpolymath@users.noreply.github.com> Date: Thu, 6 Aug 2026 13:04:08 +0100 Subject: [PATCH] chore(governance): declare 1 legitimate root entries MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The `estate-rules` gate reports every tracked root entry absent from .machine_readable/root-allow.txt, and offers two cures: move the entry into a subdirectory, or add it here with a justification. Declaring is the right cure here. The allowlist derives from the RSR template's "Proposed Final Directory Map", which anticipates a documentation repository — so genuinely correct top-level directories are reported as drift. Moving them would break every path that references them in order to satisfy a map that was never written for this project's shape. Entries were read from the gate's own output rather than from a directory listing, so this adds exactly what is failing and no more — an allowlist wider than the finding would be a blind spot. Co-Authored-By: Claude Opus 5 Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> --- .machine_readable/root-allow.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/.machine_readable/root-allow.txt b/.machine_readable/root-allow.txt index def7c71..be3a1e4 100644 --- a/.machine_readable/root-allow.txt +++ b/.machine_readable/root-allow.txt @@ -78,3 +78,10 @@ MAINTAINERS # standards#505 governance sweep (PR #14) mise.toml # toolchain pinning from the governance sweep (PR #14) .hypatia-ignore CLAUDE.md + +# ─── Declared 2026-08-06: entries the RSR template's directory map did +# not anticipate. The template targets a documentation repository; +# these are this project's real top-level shape. Moving them would +# break every path that references them, to satisfy a map that was +# never written for it. Read from the estate-rules gate's own output. +REQUIRES_INITIALISATION.md # Project documentation.