docs: fix the three accuracy gaps blocking a clean release

[interacsean]

Three fixes in files that steer other agents or land in published release notes. Found while auditing how docs and skills stay current ahead of the pending release.

1. CLAUDE.md — restore the Documentation Index

.github/workflows/docs-update.md tells the Documentation Updater to use a "Documentation Index" in CLAUDE.md to route a changeset to the right doc file, and to register new pages there — at lines 55, 99 and 105. That section was removed in #128 when docs/ was split from six files into seventy, so the agent has been routing blind ever since.

Restored as a convention table rather than the old hand-written file list. docs/ is organised by kind (components/, api/, concepts/), so the table stays correct as pages are added and needs no edit per page — the old enumerated list is exactly what rotted last time.

No gh-aw lock recompile needed: the prompt body is runtime-imported from the .md (GH_AW_PROMPT_CONTENT_0005), not baked into docs-update.lock.yml.

2. quality-check skill — align with what CI actually runs

The skill listed type-check, lint, test and fmt. .github/actions/ci also runs check-dts and gates on fmt:check. Both are now in the procedure, with a note to keep the two lists in step — a task that runs in CI but not in the skill passes locally and fails on the PR.

check-dts is the one that matters: type-check sets skipLibCheck: true and never inspects the emitted declarations, so a .d.ts that only breaks for consumers fails there and nowhere else.

3. green-suns-sing changeset — drop astw: from the Spinner example

The example used className="astw:size-3", which contradicts calm-wolves-rest.md in the same release and is rejected by the no-astw-prefix rule shipping alongside it in @tailor-platform/eslint-plugin-app-shell.

Spinner has a real size prop and xs resolves to 12px — the same result astw:size-3 was producing — so the example now reads size="xs", through the supported API.

This one is time-sensitive. The text is already rendered into the CHANGELOG on the open Version Packages PR (#524) and freezes on publish. This PR needs to land before #524 merges; changesets will regenerate #524 once it does.

Not in this PR

• The astw: prose across docs/ is already covered by fix(core): correct astw: prefix order in shipped components, and the prefix advice in docs/ #515.
• Missing docs pages (Spinner, plus nine exports with no mention anywhere in docs/) are the Documentation Updater's job once it is poked — it has been failing since Sep 11 and last produced a PR on Sep 8, which is why the gap went unflagged.

Verification

• pnpm fmt:check — clean
• pnpm exec turbo run lint test type-check check-dts — 25 tasks, 97 test files, 1800 tests, all passing
• .github/workflows/scripts/check-catalogue-links.sh — 28 pages OK
• Bundled skill regenerated from catalogue/ — no drift

🤖 Generated with Claude Code

[github-actions]

Code Metrics Report

	main (956d728)	#540 (037ff56)	+/-
Coverage	87.4%	87.4%	0.0%
Test Execution Time	2m6s	1m43s	-23s

Details

  |                     | main (956d728) | #540 (037ff56) | +/-  |
  |---------------------|----------------|----------------|------|
  | Coverage            |          87.4% |          87.4% | 0.0% |
  |   Files             |            204 |            204 |    0 |
  |   Lines             |           6014 |           6014 |    0 |
  |   Covered           |           5257 |           5257 |    0 |
+ | Test Execution Time |           2m6s |          1m43s | -23s |

---

Reported by octocov