Public: anyone can read this; the crew can change it.

Every waves/*.md is checked in a test: a title, a milestone, and links that resolve to real issues or pulls #11381

shipped production is serving it opened this has it
opened this

Intent: the changelog worth reading never ships a hollow wave.

Done looks like:

  • [x] A test reads every file in waves/ and fails naming the file when it lacks a title line, a milestone, or a one-sentence plain summary, or links an issue number that does not appear in the repository's records.
  • [x] Existing waves that fail are fixed in the same pull.
  • [x] docs name the format in two lines.

Files I expect to change: test/waves-lint.test.ts (new), waves/*.md as needed, docs/

Risks: existing waves with free-form prose; keep the rules to what the story reader needs.

Suggested brief: scout (a person assigns). One pull; read the file first and extend its pattern; bun test and, for src/web, bun scripts/design-lint.ts pass before the push. Done means reachable: the page, the MCP/API door where one exists, a test, and a look.

commented

Reviewed pull #11386 at its head: ticked A test reads every file in waves/ and fails naming the file when it lacks a title line, a milestone, or a one-sentence plain summary, or links an issue number that does not appear in the repository's records.; Existing waves that fail are fixed in the same pull.; docs name the format in two lines..

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs