Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

feat: implement ADR-0012 — AGENTS.md refactor (issue 0015)

Browse Source 
Create AGENTS.md at repo root and core/AGENTS.md as provider-agnostic
sources of always-on rules. Slim both CLAUDE.md files to thin adapters.
Deploy core/AGENTS.md → ~/.agents/AGENTS.md via deploy-manifest.sh.
Update three test suites to check correct locations post-refactor.
All automated tests pass (57 instructions, 106 install, 25 governance).
HITL behavioral test plan in test-instructions-and-docs.sh scenarios 9–12.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Defame1297
2026-05-17 15:41:05 +00:00
parent 9457efff36
commit a1f1f9ded8
12 changed files with 267 additions and 114 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
tests/test-governance-layer.sh
View File

@@ -63,14 +63,15 @@ contains "@.*governance\.md" "$CLAUDE_PROVIDER" \
&& pass "@import for governance.md present in providers/claude-code/CLAUDE.md" \
|| fail "@import for governance.md missing from providers/claude-code/CLAUDE.md"
# Communication and Behavior rules must be retained unchanged
contains "[Cc]hallenge" "$CLAUDE_PROVIDER" \
&& pass "providers CLAUDE.md: challenge-bad-ideas rule retained" \
|| fail "providers CLAUDE.md: challenge-bad-ideas rule missing — may have been overwritten"
# Communication and Behavior rules moved to core/AGENTS.md by issue 0015 — verify correct location
CORE_AGENTS="$REPO_ROOT/core/AGENTS.md"
contains "[Cc]hallenge" "$CORE_AGENTS" \
&& pass "core/AGENTS.md: challenge-bad-ideas rule present (moved from providers CLAUDE.md, issue 0015)" \
|| fail "core/AGENTS.md: challenge-bad-ideas rule missing — may have been lost in 0015 refactor"
contains "[Ii]rreversible" "$CLAUDE_PROVIDER" \
&& pass "providers CLAUDE.md: irreversible-ops confirmation rule retained" \
|| fail "providers CLAUDE.md: irreversible-ops confirmation rule missing"
contains "[Ii]rreversible" "$CORE_AGENTS" \
&& pass "core/AGENTS.md: irreversible-ops confirmation rule present (moved from providers CLAUDE.md, issue 0015)" \
|| fail "core/AGENTS.md: irreversible-ops confirmation rule missing — may have been lost in 0015 refactor"
echo ""
@@ -150,10 +151,11 @@ contains "Resolved" "$ROADMAP" \
&& pass "ROADMAP.md: always-on refinement open question marked resolved" \
|| fail "ROADMAP.md: always-on refinement open question not resolved"
REPO_CLAUDE="$REPO_ROOT/CLAUDE.md"
contains "[Gg]overnance" "$REPO_CLAUDE" \
&& pass "CLAUDE.md: governance workstream referenced" \
|| fail "CLAUDE.md: governance workstream not referenced"
# Repo CLAUDE.md is now a thin adapter importing AGENTS.md — check AGENTS.md for governance reference
REPO_AGENTS="$REPO_ROOT/AGENTS.md"
contains "[Gg]overnance" "$REPO_AGENTS" \
&& pass "AGENTS.md: governance workstream referenced (repo CLAUDE.md imports AGENTS.md)" \
|| fail "AGENTS.md: governance workstream not referenced"
echo ""
echo "Results: $PASS passed, $FAIL failed"