Skip to content

How We Use This Wiki

Governance rules. Required fields, review cadence, what goes where.

Governance rules so this wiki doesn’t rot into a junk drawer the way most do.

Every page must show, at the bottom (or in frontmatter for MDX):

Last reviewed: YYYY-MM-DD · Owner: @Name · Status: active / draft / archived
FieldMeaning
Last reviewedDate someone confirmed this is still accurate. Updated even if nothing changed.
OwnerA named human responsible for this page. Not “team X” — a person.
Statusactive / draft / archived / scaffold / superseded
Audienceengineering / product / gtm / people-and-ops
TypeReview every
ADRsWhen superseded; never delete
StandardsQuarterly
RunbooksAfter every use + quarterly
Apps (catalog)Monthly + when shipped
PostmortemsNever — they’re historical record
RFCsAt spec → implement transition
Meeting notesArchive after 90 days unless still load-bearing
ContentGoes in
A choice that constrains the futureADR
A proposed new featureRFC (in product space)
A “how to fix when X breaks”Runbook
A bug post-fixPostmortem
A reference docApps catalog, standards, references
Long-lived knowledgeWiki (this site)
Ephemeral stateSidekick threads, PR descriptions, Slack
  • Don’t create pages without an owner
  • Don’t write “X (TBD)” — write the page or don’t write the page
  • Don’t keep three different versions of a doc — supersede and link, never branch
  • Don’t paste raw meeting notes — write decisions only, not transcripts
  • Don’t write a page that duplicates something in the codebase (CLAUDE.md, .claude/rules/, README) — link instead

Use the standard templates in Templates (when migrated) to avoid reinventing structure.