editions

Installation
SKILL.md

Editions (Date-Anchored Defaults)

Source of truth: docs/prd/editions.md. This skill is the contributor-facing decision tree for "does my change need edition handling", not a restatement of the architecture — read docs/prd/editions.md for the four-layer model, pkg/edition/journal.go's Entry schema, and the guardrail tests before touching anything. This skill exists because the deciding question ("does this default change supersede prior behavior?") is easy to answer wrong by only checking the literal rule ("new keys are never journal-gated") without checking what the rule is for.

The decision tree

Ask these in order. Stop at the first "yes."

1. Does this change a previously-shipped key's literal default value? (e.g. flipping settings.terminal.pager's struct default from "true" to "false".)

Installs
2
GitHub Stars
1.4K
First Seen
Oct 20, 2026