gdd-update

name	gdd-update
description	Update get-design-done to the latest release. Preserves .design/config.json and ./.claude/skills/.
argument-hint	[--dry-run] [--version <tag>] [--show-privacy-diff]
tools	Read, Write, Bash
disable-model-invocation	true

gdd-update

Updates the get-design-done plugin to the latest release (or a specific tag), preserving user-local state.

Steps

1. Pre-flight check - read current version from .claude-plugin/plugin.json (fallback: plugin.json at project root). Print current version and, when available, the latest release tag from GitHub.

2. Dry-run - if --dry-run is passed, print the planned steps and exit without making changes.

3. Backup - read .design/config.json into memory. Snapshot the file list under ./.claude/skills/ so we can detect collisions later. Additionally, snapshot the text contents of scripts/lib/pseudonymize.cjs, scripts/lib/issue-reporter/payload-assembly.cjs, and scripts/lib/issue-reporter/destination.cjs to a tempdir (mirroring the same relative paths under that tempdir's root). This is the OLD tree used by the privacy-diff step below. Also read the previous-version string from .design/privacy-diff-last-version.txt if it exists, into a variable prevVersion (null if the file is absent). (Plan 30-07 D-09)

4. Pull update - run claude plugin install hegemonart/get-design-done (or claude plugin install hegemonart/get-design-done@<tag> when --version <tag> is passed). This re-syncs all plugin files from the release.

5. Restore config - write .design/config.json back from the in-memory backup. The installer may reset the config to defaults; this step guarantees user settings survive. 5.5. Privacy diff - const pd = require('./scripts/lib/issue-reporter/privacy-diff.cjs'); Compute showDiff = pd.shouldAutoShow(prevVersion, currentVersion, oldTreeTempdir, repoRoot) || flags.showPrivacyDiff. If showDiff is true: call pd.computePrivacyDiff(oldTreeTempdir, repoRoot), pass the result to pd.renderPrivacyDiff, and print the returned markdown to stdout under a clear "## Privacy-critical changes" banner. If --show-privacy-diff was passed but prevVersion === null (first-ever upgrade), print: "Privacy diff requested but no previous version is recorded. Snapshot file .design/privacy-diff-last-version.txt will be written now; the next upgrade will be able to diff against this version." After printing (or skipping), write currentVersion to .design/privacy-diff-last-version.txt so the next upgrade compares against THIS version. (Plan 30-07 D-09)

6. Preserve local skills - ./.claude/skills/ is project-local and outside the plugin tree. Re-list the directory and confirm none of the pre-update files disappeared. Warn loudly if any did.

7. Post-update advisory - print:

   Run /gdd:reapply-patches if you have customized any reference/ files to restore your modifications.

7.5. Deprecation advisory (Phase 39.5) - load the path-migration registry and report anything that crossed into deprecated or removed over the [prevVersion → currentVersion] window:

node -e '
  const fs = require("fs");
  const dr = require("./scripts/lib/deprecation-registry.cjs");
  const entries = dr.parseDeprecations(fs.readFileSync("reference/DEPRECATIONS.md","utf8"));
  const crossed = entries.filter(e =>
    dr.classify(e, currentVersion) !== "pending" &&
    (prevVersion == null || dr.classify(e, prevVersion) !== dr.classify(e, currentVersion)));
  console.log(JSON.stringify(crossed));
'

If any entry crossed, print a ## Deprecations in this update list (old → new + status) and point the user at /gdd:migrate to rewrite their local references. If none crossed, say nothing.

8. Print the new version and the changelog URL (https://github.com/hegemonart/get-design-done/releases).

Output

End every invocation with:

## UPDATE COMPLETE

Implementation note

The actual update mechanism is the standard claude plugin install re-install path. This skill only orchestrates the pre-/post-preservation steps around it.