Sherpa
ReferenceFrontmatter Schemas

Initiative Frontmatter

YAML frontmatter schema for initiative proposal files.

Every initiative lives at docs/initiatives/<slug>/proposal.md with YAML frontmatter defining its metadata.

Prop

Type

Status Values

StatusMeaning
pendingProposed, awaiting review
approvedReviewed and accepted, ready for planning
in-progressActively being worked on
integratedCompleted and merged into shared artifacts
declinedReviewed and rejected
archivedNo longer relevant

Risk Levels

RiskMeaning
additiveNew files only, no existing behavior changes
evolutionaryImproves existing code, backwards-compatible
structuralChanges foundations, may break consumers

See Guide: Creating Conventions for how conventions use frontmatter.

Configuration

Complete reference for sherpa.json — paths, vocabulary, dispatch, governance, and plugins.

Agent Role Frontmatter

YAML frontmatter schema for behavioral agent role definitions.

On this page

Status ValuesRisk Levels