Back to Plate

registry-changelog pack

docs/plans/templates/packs/registry-changelog.md

53.2.02.4 KB
Original Source

registry-changelog pack

Use this pack when work touches user-visible Plate registry output under apps/www/src/registry/**: UI components, node renderers, kits, examples, registry metadata, style dependencies, install behavior, or generated registry changelog artifacts.

This pack owns the registry changelog contract only. Package release notes stay with changeset / package-api. Release page topology stays with docs-creator.

Start Gates:

GateAppliesEvidence
Registry changelog pack selectedpendingpending
User-visible registry impact classifiedpendingChoose yes or N/A: <reason>
Source entry path selectedpendingapps/www/src/registry/changelog/entries/<id>.mdx, existing entry, or N/A: <reason>
Generator command selectedpending--new, manual source edit, --write, and --check plan

Work Checklist:

  • Registry changelog pack: user-visible registry impact is recorded.
  • Registry changelog pack: source entry exists under apps/www/src/registry/changelog/entries/*.mdx or N/A reason is recorded.
  • Registry changelog pack: entry frontmatter follows the contract in .agents/skills/registry-changelog/SKILL.md.
  • Registry changelog pack: row bullets name real registry item ids in backticks.
  • Registry changelog pack: generated /registry/changelog/*.json, index.json, and components.json are updated by the generator, not by hand.
  • Registry changelog pack: package changeset decision is separate when package code also changed.

Completion Gates:

GateAppliesRequired actionEvidence
Registry impact classificationpendingRecord user-visible registry delta or N/A reasonpending
Registry changelog sourcependingAdd/update apps/www/src/registry/changelog/entries/*.mdx or record N/Apending
Registry changelog generationpendingRun node tooling/scripts/generate-ui-changelog-entries.mjs --write when a source entry is requiredpending
Registry changelog checkpendingRun node tooling/scripts/generate-ui-changelog-entries.mjs --checkpending
Registry generator testpendingIf generator/schema/source layout changed, run bun test tooling/scripts/generate-ui-changelog-entries.test.mjs; otherwise N/Apending
Registry package release splitpendingRecord .changeset, registry changelog, both, or N/A with reasonpending