The reusable skeleton for every register guide and house profile. Copy the nine headings below and fill each in for the specific artifact type. Every guide is "set up the same way" so a writer who knows one knows them all. Keep the whole document scannable — it must itself obey the craft it teaches. Do not restate [[house-core]]; reference it and add only the specialization.
Exception on record:
guide-journal.mdcarries a tenth numbered section ("Wiki render contract") between "Worked examples" and "Pre-publish checklist" — a JOURNAL-specific addition (the register's publish-gate mechanics have no equivalent in the other four register guides), not a drift from this skeleton. Added 2026-07-15 during the linguistic- tokens/style-guide consolidation audit that found this note was missing.
1. Purpose and audience
One or two paragraphs. Who reads this artifact type, what decision or task they bring to it, and what they must leave with. Name the register this guide inherits and any second audience that reads over the primary reader's shoulder.
2. The shape
The section skeleton for this artifact type, in order, one line each. This is the structural scaffold — the part of the writing machine that constrains form before a word is written. If the artifact has required sections, list them; if it has a canonical order, fix it here.
3. Opening
How this artifact type leads, as a specialization of the house lead rule. Give the exact shape of the first paragraph and what the lead must accomplish for this reader. State the isolation test in this artifact's terms.
4. Paragraph and sentence rhythm
Only the deltas from [[house-core]]: the sentence-length target and ceiling for this register, and any rhythm note specific to the type (a runbook is terser than an explanation; a legal clause is more measured). If there is no delta, say so in one line and move on.
5. Headings and scannability
Heading density and any fixed heading names for this artifact type. Note whether tables, lists, or callouts are the right structure for this type's recurring content.
6. Voice and tone
The register in positive, exemplary terms. Show the move this artifact type turns on — the consequence-first sentence, the imperative step, the neutral clause — with a one-line model of it. No forbidden-word tables; teach the positive alternative.
7. Code and examples
The code policy for this artifact type, stated positively. Where code belongs, how it is introduced, and what is pulled out to a linked reference instead of embedded. Apply the reference-versus-how-to distinction: an explanation links to the rationale; a how-to carries the steps.
8. Worked examples
Two or three short pairs — a weaker version and a stronger one — each with a single line of annotation naming what changed and why. This is the part that teaches the drafting machine and the copy editor the register by demonstration. Keep each example a few sentences at most.
9. Pre-publish checklist
Five to eight positive checks, each a question a writer answers yes to. "Does the lead survive in isolation?" "Does every term of art link to its definition?" "Does each step name its verification?" Checks, not prohibitions.
Frontmatter every guide carries
---
schema: foundry-doc-v1
title: "<Register or house> guide — <one line>"
slug: <kebab-slug>
category: internal
type: reference
content_type: reference
quality: complete
status: active
audience: contributor
bcsc_class: public-disclosure-safe
governs: [<ARTIFACT-TYPE>, <ARTIFACT-TYPE>] # the artifact types this guide covers
last_edited: <YYYY-MM-DD>
editor: pointsav-engineering
---
The governs: list is what the coverage matrix reads to prove every prose artifact type maps
to exactly one guide. A white-label register guide names artifact types generically; a house
profile names the wikis it specializes and points to the register guide it layers on. House
profiles differ in two frontmatter values only: audience: contributor-internal and
bcsc_class: internal-only, because a profile describes the writing machine, not the wiki's
readers.
Important Information
Design System disclosure
This site provides open-source design tokens, documentation, and self-hostable software published by Woodfine Capital Projects Inc. Information here is for general reference only and does not constitute an offer, warranty, or a guarantee of fitness for any particular purpose. Statements regarding planned, intended, or targeted future features are forward-looking and subject to change without notice; they are not undertaken to be updated except as required by law.