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
claude/composition-usage-rune-pages-c87ar6 View source

Criteria completion

Criteria completion: 5 of 5 (100%) checked; history from Nov 3 to Nov 40%25%50%75%100%Nov 3Nov 4

Relationships

Implements 1
Related 3
Branches 2
claude/composition-usage-rune-pages-c87ar6 current done
main donechangeset-release/main ready
History 2
  1. 643af43
    • ☑ 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
    by bjornolofandersson
  2. f91f637
    Created (ready)by bjornolofandersson

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.