{% marker %}

Attributes

Parameter	Type	Required	Description
type	enum: todo|fixme|question|review|note	✓	Marker category — determines badge color
text	string	✓	The annotation message displayed on hover/click
priority	enum: low|normal|high	—	Urgency level — defaults to 'normal'. 'high' adds a visual accent
scope	string	—	Visibility scope — inherits from parent; may narrow to 'agent' or 'public'

Valid Parent Contexts

This tag is valid inside: {% domain %}, {% feature %}, {% flow %}, {% role %}, {% manifest %}, {% blueprint %}, {% story %}, {% milestone %}, {% changeset %}, {% tour %}, {% surface %}, {% article %}

Rules

Rule	Force	Realm	Reference	Description
marker-self-closing	must	global	—	Markers are self-closing tags — use syntax with no body content. syntax
marker-id-auto	must	global	—	The is auto-generated as . Authors must not provide an explicit . convention
marker-scope-inherited	must	global	—	Scope is inherited from the parent tag. Use for engineering-only markers invisible on the public site. scope

Markers flag work-in-progress locations in the spec. They render inline as small colored badges and are collected globally into a Markers table at /markers with backlinks to the exact location via anchor ids.

Usage

{% marker type="todo" text="This section needs to be rewritten" /%}
{% marker type="fixme" text="Edge case not handled" priority="high" /%}
{% marker type="question" text="Should this be async?" /%}
{% marker type="review" text="Needs sign-off from product" /%}
{% marker type="note" text="Implementation detail for reference" /%}

Type Reference

Type	Color	Use for
todo	Amber	Work that needs to be done
fixme	Red	Known bugs or broken logic
question	Blue	Open questions needing answers
review	Purple	Needs review by another person
note	Gray	Neutral annotation, not actionable

Rendered Output

Inline

Renders as a <MarkerBadge> component — a small colored pill with the type label (e.g. “TODO”). Hover or focus reveals the full text in a tooltip. The badge carries an auto-generated id attribute for anchor linking.

Aggregate

The /markers page renders a <MarkerTable> component with columns: Type, Text, Source (backlink), Priority.