{% milestone %}

Attributes

Parameter	Type	Required	Description
id	string	✓	Unqualified milestone id (e.g., 'mvp')
release	string	—	Target release date in ISO 8601 format (e.g., '2026-06-01')
status	enum	—	planned | in-progress | done
scope	string	—	Visibility scope (defaults to 'public agent')

Valid Children

Tag	Multiplicity
{% tldr %}	[1]
{% explanation %}	[*]
{% includes %}	[*]
{% example %}	[*]

The milestone tag defines a planned release, its target date, its current status, and the set of features and flows it includes.

Child tags

Tag	Attributes	Description
tldr	—	One-paragraph summary of the milestone goals. Required.
includes	ref (required)	References a feature or flow included in the milestone. ref is the qualified id (e.g., feature/add-bookmark).

Public rendering

The public pass renders the milestone as a documentation page with metadata tags at the top.

Metadata tags

The release date and status are rendered as visual tags:

• Release: Prepended with a calendar icon.
• Status: Rendered as a colored pill based on the status value.

Sections

1. TLDR: Rendered as a lead paragraph.
2. Description: The prose body of the milestone tag.
3. Includes: A list of links to the included features and flows.

Agent bundle shape

{
  "type": "milestone",
  "id": "milestone/mvp",
  "title": "MVP",
  "release": "2026-06-01",
  "milestoneStatus": "planned",
  "includes": ["feature/add-bookmark", "feature/remove-bookmark"]
}

Milestone with release date, status, and includes

tagmilestoneincludes milestone-tag-full

{% milestone id="mvp" release="2026-06-01" status="planned" %}

  {% tldr %}
  The first shippable version of the application.
  {% /tldr %}

  The MVP focus is on the core bookmarking loop.

  {% includes ref="feature/add-bookmark" /%}
  {% includes ref="feature/remove-bookmark" /%}

{% /milestone %}

Tag Tree

{% tldr %}[1]One-sentence summary rendered as a lead paragraph and used as the document's short description throughout the site.{% explanation %}[*]Provides targeted advice or collapsible detail for a specific audience. Renders as a callout () or a disclosure element (). Supports full Markdown in the body.{% includes %}[*]References a feature or flow included in a milestone.{% example %}[*]Embeds a named, filterable example inline in a document and collects it in the global Examples Gallery.