← Commit history

publish skill: delete-not-deprecate (pre-launch), skills-live-in-repo, full-rename checklist

John Lauer ·7c8a298465 ·3mo ago ·parent 81b7f94
1 file changed +26−8
publish-skills/adom-tts-publish/SKILL.md+26−8
@@ -80,14 +80,32 @@ description: >-    # must print: ✓ CONFIRMED    ``` -## If a bad version ships--Fix → bump → `adom-wiki pkg publish --org adom` → then:-```bash-adom-wiki page deprecate adom/[email protected] --reason "superseded by X.Y.Z+1 (<why>)"-```-(verify the exact deprecate verb with `adom-wiki --help`; never delete the page-— soft-deleted pages block re-creation).+## Stale things get DELETED, not deprecated (user rule, pre-launch)++We have not launched: leaving "[DEPRECATED]" garbage around is worse than+removing it. A bad package VERSION: fix, bump, republish (registry versions are+immutable; the new version supersedes). A stale PAGE, hero, or file: delete it+outright — `adom-wiki repo rm <ref> <path>` for files, `adom-wiki repo delete+<ref> --hard --confirm` for whole pages. Only reach for deprecation notices+after we launch and third parties depend on things.++## Skills live IN this repo (user rule)++Never create a standalone wiki skill page that just points at adom-tts — all+skills associated with the app belong in THIS repo's tiers (skills/,+dev-skills/, publish-skills/) so they version and ship with the app. Example:+tts-pronunciation was a scattered standalone page and is now+skills/tts-pronunciation/ here. The one sanctioned standalone is+adom/hands-free — a cross-cutting trigger router, kept deliberately thin.++## A rename is not just a slug change++Renaming a page = slug + title + brief/description + SKILL.md name ++install paths + discovery triggers + THE HERO (the old pixels carry the old+name — regenerate it with the adom-wiki-hero skill) + deleting old-name art+and directories everywhere (wiki files, ~/.claude/skills, installers). The+im-driving → hands-free rename missed the hero on the first pass; don't+repeat that.  ## Distribution notes