Skip to content

CLAUDE.md's documentation sources-of-truth table omits .github/ISSUE_TEMPLATE/*.md #81

Description

@dmccoystephenson

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions