Skip to content

docs: correct stale status and layout claims in CLAUDE.md, the rules, and the README#488

Merged
drmrd merged 1 commit into
mainfrom
docs/refresh-stale-doc-claims
Jul 6, 2026
Merged

docs: correct stale status and layout claims in CLAUDE.md, the rules, and the README#488
drmrd merged 1 commit into
mainfrom
docs/refresh-stale-doc-claims

Conversation

@drmrd

@drmrd drmrd commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Corrects five statements that no longer match the repository, and refreshes the agent skills that had been warning about them.

In the committed docs:

  • CLAUDE.md said the source-layer directories are placeholders. All six layers carry substantial production code and tests, and src/ holds real Vite entry points rather than a placeholder App component.
  • README.md line 8 said "Status: early development (Phase 0). Not yet usable as a floor planner." The status is now stated as early alpha with the 0.x instability caveat, phrased to match the CHANGELOG's SemVer-from-1.0 policy. The Phase 0 label was also an internal shorthand the naming policy forbids.
  • README.md required Node.js 20+; engines requires >=22.18.0.
  • Rule 6 in .claude/rules.md described ADRs as a gitignored Claude-side cache. The decisions tree is committed and authoritative alongside the design spec; only the generated indices stay gitignored.
  • Rule 9 listed seven commit types; commitlint enforces ten. This one-line fix rode along because it is the same class of staleness in the same file.

In the skills under .claude/skills/: every note that flagged one of the above lines as stale is removed or narrowed, since the warnings would otherwise become false the moment this merges. The remaining staleness warnings all point at CONTRIBUTING.md (Node 20, the single-smoke-test claim, the 0.0.0 version note, seven commit types), which this PR does not touch; fixing CONTRIBUTING.md is a natural follow-up.

Doc-only change: no source or test files.

… and the README

CLAUDE.md no longer calls the source layers placeholders; all six are
live. The README status line replaces the internal Phase 0 label with an
accurate early-alpha statement, and the Node prerequisite now matches
the engines field. Rule 6 describes the committed ADR tree instead of a
gitignored cache, and rule 9 lists all ten commitlint types. Skill files
that flagged these lines as stale are refreshed, leaving CONTRIBUTING.md
as the one file still carrying known stale claims.
@drmrd drmrd force-pushed the docs/refresh-stale-doc-claims branch from 6e87d2d to d31f352 Compare July 6, 2026 00:33
@drmrd drmrd merged commit 3c5d9d6 into main Jul 6, 2026
8 checks passed
@drmrd drmrd deleted the docs/refresh-stale-doc-claims branch July 6, 2026 00:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant