wsg/docs/rules/fragments/04_ConceptDocuments.md

type, title, sources, generated, verified, status, stale_after

type	title	sources	generated	verified	status	stale_after
Section	Concept Documents	SPEC.md	true	false	current	2026-12-31

Concept Documents

A knowledge concept is a document containing metadata and content. It consists of two parts: frontmatter and body. The body is the main content.

Frontmatter

Frontmatter is YAML enclosed between --- delimiters at the start of the document, before any other text. All frontmatter keys MUST be lowercase.

Required Fields

Field	Type	Description
type	string	Must be one of: Rule, Section, Example, Template
title	string	Human-readable title of the concept

Optional Fields

Provenance Family (sources)

List of URIs or paths identifying sources used to produce this document. Values may reference files, URLs, or external resources.

Trust Family (generated, verified)

• generated: boolean — whether the document was produced by an automated system
• verified: boolean — whether a human has reviewed the document's correctness

Lifecycle Family (status, stale_after)

• status: string — lifecycle status: draft, current, deprecated
• stale_after: date-string — after which this document should no longer be relied upon

Conventions

• Unknown additional frontmatter entries MAY be included
• New conventional section headings can be added to bodies