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

docs: remove ROADMAP.md and scrub all references

Browse Source 
## Why

ROADMAP.md was a static file that duplicated tracking information now
owned by Gitea milestones and issues. Keeping it created a maintenance
burden — references drifted out of sync with the actual state of work,
and agents were directed to read it when the source of truth had moved.

## Implementation Notes

All inbound references replaced with either the relevant Gitea milestone
("Skills & Agents") or removed where the context made them redundant.
Test assertions that verified ROADMAP.md content removed; test output
strings updated to drop the ROADMAP cross-reference instruction.

## Impact

Agents no longer read docs/ROADMAP.md at session start. Gitea milestones
and issues are the canonical source for roadmap and open-question tracking.

---

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Defame1297
2026-06-28 19:37:43 +00:00
parent 01f6171347
commit 7a00368683
7 changed files with 5 additions and 160 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -130,19 +130,6 @@ contains "@import" "$VISION" \
&& pass "VISION.md: @import mechanism mentioned" \
|| fail "VISION.md: @import mechanism not mentioned"
ROADMAP="$REPO_ROOT/docs/ROADMAP.md"
contains "[Gg]overnance workstream" "$ROADMAP" \
&& pass "ROADMAP.md: Governance workstream entry present" \
|| fail "ROADMAP.md: Governance workstream entry missing"
contains "CONTROLS" "$ROADMAP" \
&& pass "ROADMAP.md: Phase 2 / CONTROLS.md reference present" \
|| fail "ROADMAP.md: Phase 2 reference missing"
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.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" \

5
tests/test-instructions-and-docs.sh
View File

@@ -291,14 +291,13 @@ echo ""
echo "Scenario 1 required three rounds to fix:"
echo " Round 1 FAIL: agent gave verbose answer, no format rule."
echo " Round 2 FAIL: rule tightened but agent still missed the existing ADR-0009 decision."
echo " Round 3 PASS: @import CONTEXT.md + standing rule added to check docs/adr/ and ROADMAP"
echo " resolved entries before answering design questions."
echo " Round 3 PASS: @import CONTEXT.md + standing rule added to check docs/adr/ before answering design questions."
echo "Scenario 4 untestable: no origin remote in this repo. Rule was tightened to 'do not call"
echo " the tool until user says yes'. Re-test when a remote is configured."
echo ""
echo "0004 — CLAUDE.md behavior"
echo " 1. Ask an exploratory design question (or one already answered by an ADR)."
echo " Expect: agent checks docs/adr/ and ROADMAP resolved entries, states existing decision"
echo " Expect: agent checks docs/adr/, states existing decision"
echo " in 1-2 sentences with source, or gives 1 rec + 1 tradeoff in 2-3 sentences if open."
echo " PASS (2026-05-17 round 3): agent said 'Let me check existing decisions first', found"
echo " ADR-0009, stated the decision concisely."