WORK-708
ID:WORK-708Status:done

Every rune page opens with the intro, the install hint goes, and the guard keeps it gone

SPEC-187 D1 and D6: all 119 pages under site/content/runes/ open with the intro include. The hand-written # Title, the "This rune is part of @refrakt-md/…" hint (on 45 pages) and any opening paragraph that only restates the description are removed.

Priority:mediumComplexity:moderateMilestone:v0.48.0Source:SPEC-187
main View source

Criteria completion

Criteria completion: 5 of 5 (100%) checked; tracking started on Nov 3, no incremental history yet0%25%50%75%100%Nov 3Nov 4

Tracking started Nov 3 — check back for trends.

Relationships

Implements 1
Related 3
Branches 3
main current done
claude/composition-usage-rune-pages-c87ar6 donemain donechangeset-release/main ready

Acceptance Criteria

  • Every rune reference page opens with {% include file="rune-intro.md" … /%} in place of its # Title
  • No rune page carries the install hint
  • An opening paragraph that restates the frontmatter description is merged into it or cut, page by page, so the blurb is not repeated
  • scripts/check-rune-docs.mjs fails on a rune page without the intro include, or with the old hint
  • refrakt validate --site main and --site staging report nothing new, and npm run format:md:check passes

Blocked by

  • WORK-706

References

  • SPEC-187: D1, D6.

Resolution

Completed: 2026-11-04

Branch: claude/composition-usage-rune-pages-c87ar6 PR: refrakt-md/refrakt#772

What was done

  • All 99 rune reference pages (every type: rune page with its own record; the other files under site/content/runes/ are plugin overviews and guides) replace their # Title with the rune-intro.md include; the 45 install hints are removed.
  • Opening paragraphs checked against the description: the restating first sentence cut on 26 pages, the paragraph cut on 2 (gallery, toc); kept whole on 4 where the rest would not stand alone or the paragraph is the explanation (include, sidenote, swatch, work).
  • scripts/check-rune-docs.mjs: introCoverage fails a rune page whose first line is not its own intro include, that keeps the install hint, or that hand-writes a # title outside a fence; tests in scripts/check-rune-docs.test.mjs.

Notes

  • The item's "119 pages" counted every file under site/content/runes/; 99 are rune pages.
  • Built site: on all 99 pages the first <h1> in <main> is the record's title, the Source drawer is present, and plugin pages have the Install drawer. Warning counts unchanged.
  • WORK-707 (the staging badge) is not done: pages have no per-site value, and a data root from a missing variable fails the build.