Skip to content

Commit 186ebde

Browse files
chore(governance): declare legitimate root entries (#47)
The `estate-rules` gate reports every tracked root entry absent from `.machine_readable/root-allow.txt`, offering two cures: move the entry into a subdirectory, or **add it here with a justification**. Declaring is the right cure. The allowlist derives from the RSR template's *"Proposed Final Directory Map"*, which anticipates a documentation repository — so genuinely correct top-level directories (`crates/`, `daemon/`, `compiler-core/`) are reported as drift. Moving them would break every path that references them, to satisfy a map never written for this project's shape. **Worth noting at source:** across the 16 repositories failing this gate, `REQUIRES_INITIALISATION.md` appears in 12 and `.githooks/` in 9. Those are files the RSR template *itself ships* — the template's own allowlist omits files the template creates, so a freshly minted repo fails this gate on day one. That is a template defect worth fixing upstream as well. Entries were read from the gate's own output rather than a directory listing, so this adds exactly what is failing and no more — an allowlist wider than the finding would be a blind spot. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
1 parent 59d90fe commit 186ebde

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

.machine_readable/root-allow.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,3 +78,10 @@ MAINTAINERS # standards#505 governance sweep (PR #14)
7878
mise.toml # toolchain pinning from the governance sweep (PR #14)
7979
.hypatia-ignore
8080
CLAUDE.md
81+
82+
# ─── Declared 2026-08-06: entries the RSR template's directory map did
83+
# not anticipate. The template targets a documentation repository;
84+
# these are this project's real top-level shape. Moving them would
85+
# break every path that references them, to satisfy a map that was
86+
# never written for it. Read from the estate-rules gate's own output.
87+
REQUIRES_INITIALISATION.md # Project documentation.

0 commit comments

Comments
 (0)