What's missing
CLAUDE.md's "Documentation sources of truth" table lists six files:
create-dev-loop.md, README.md, RESEARCH.md, CONTRIBUTING.md, SECURITY.md,
.github/PULL_REQUEST_TEMPLATE.md.
It omits the three issue templates added in PR #64, which restate project conventions and can drift from
CLAUDE.md exactly the way the PR template can — which is why PR #76 added the PR template to that table:
.github/ISSUE_TEMPLATE/feature_request.md restates the doc-sync rule ("those need to stay in sync with
README.md per CLAUDE.md's doc-sync rule") and the research-grounding rule.
.github/ISSUE_TEMPLATE/template_rule.md restates the retrofit rule from CLAUDE.md's "Promoting a rule
into the template" section.
.github/ISSUE_TEMPLATE/bug_report.md enumerates Steps by name ("Step 2 (explore), Step 3 (write skill),
Step 4 (fill placeholders)"), which drifts if a Step is renamed or renumbered.
All three are accurate as of c1ac200 — this is about the table being incomplete, not about current drift.
Proposed change
Add a row to the table:
| `.github/ISSUE_TEMPLATE/*.md` | Restated conventions and Step names still match this file (`CLAUDE.md`) |
Note
CLAUDE.md is agent-loaded config, which the dev-loop classifies as requiring explicit human authorization
to edit — hence an issue rather than a PR. Found during a Stage A documentation-accuracy sweep on 2026-07-29.
What's missing
CLAUDE.md's "Documentation sources of truth" table lists six files:create-dev-loop.md,README.md,RESEARCH.md,CONTRIBUTING.md,SECURITY.md,.github/PULL_REQUEST_TEMPLATE.md.It omits the three issue templates added in PR #64, which restate project conventions and can drift from
CLAUDE.mdexactly the way the PR template can — which is why PR #76 added the PR template to that table:.github/ISSUE_TEMPLATE/feature_request.mdrestates the doc-sync rule ("those need to stay in sync withREADME.mdperCLAUDE.md's doc-sync rule") and the research-grounding rule..github/ISSUE_TEMPLATE/template_rule.mdrestates the retrofit rule fromCLAUDE.md's "Promoting a ruleinto the template" section.
.github/ISSUE_TEMPLATE/bug_report.mdenumerates Steps by name ("Step 2 (explore), Step 3 (write skill),Step 4 (fill placeholders)"), which drifts if a Step is renamed or renumbered.
All three are accurate as of
c1ac200— this is about the table being incomplete, not about current drift.Proposed change
Add a row to the table:
Note
CLAUDE.mdis agent-loaded config, which the dev-loop classifies as requiring explicit human authorizationto edit — hence an issue rather than a PR. Found during a Stage A documentation-accuracy sweep on 2026-07-29.