@hegemonart/get-design-done 1.28.6 → 1.28.7

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "Get Design Done — 5-stage agent-orchestrated design pipeline with 9 connections, handoff-first workflow, bidirectional Figma write-back, 22+ specialized agents, queryable knowledge layer (intel store, dependency analysis, learnings extraction), and a self-improvement loop (reflector, frontmatter + budget feedback, global-skills layer). v1.20.0 ships the SDK foundation: gdd-state MCP server (11 typed tools), lockfile-safe STATE.md mutations, event stream, and resilience primitives (jittered-backoff, rate-guard, error-classifier, iteration-budget) for rate-limit + 429 + context-overflow recovery. Full CI/CD pipeline (Node 22/24 × Linux/macOS/Windows) and release automation (auto-tag + GitHub Release + release-time smoke test).",
-    "version": "1.28.6"
+    "version": "1.28.7"
   },
   "plugins": [
     {
       "name": "get-design-done",
       "source": "./",
       "description": "Agent-orchestrated 5-stage design pipeline: Brief → Explore → Plan → Design → Verify. 22+ specialized agents, 9 connections (Figma, Refero, Preview, Storybook, Chromatic, Figma Writer, Graphify, Pinterest, Claude Design), Claude Design handoff, bidirectional Figma write-back, and a queryable intel store (.design/intel/) for dependency and learnings queries. Standalone commands: style, darkmode, compare, figma-write, graphify, handoff, analyze-dependencies, skill-manifest, extract-learnings. Embeds NNG heuristics, WCAG thresholds, typographic systems, motion framework, and anti-pattern catalog. Ships with a full CI/CD pipeline (Node 22/24 × Linux/macOS/Windows) and release automation. Optimization layer (v1.0.4.1, retroactive): gdd-router + gdd-cache-manager skills, PreToolUse budget-enforcer hook, tier-aware agent frontmatter, lazy checker gates, streaming synthesizer, /gdd:warm-cache + /gdd:optimize commands, and cost telemetry at .design/telemetry/costs.jsonl — targeting 50-70% per-task token-cost reduction with no quality-floor regression. v1.20.0 SDK foundation: gdd-state MCP server (11 typed tools), lockfile-safe STATE.md mutations, event stream at .design/telemetry/events.jsonl, resilience primitives (jittered-backoff, rate-guard, error-classifier, iteration-budget) with rate-limit + 429 + context-overflow recovery, and TypeScript toolchain.",
-      "version": "1.28.6",
+      "version": "1.28.7",
       "author": {
         "name": "hegemonart"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "get-design-done",
   "short_name": "gdd",
-  "version": "1.28.6",
+  "version": "1.28.7",
   "description": "Agent-orchestrated 5-stage design pipeline: Brief → Explore → Plan → Design → Verify. 22+ specialized agents, 9 connections (Figma, Refero, Preview, Storybook, Chromatic, Figma Writer, Graphify, Pinterest, Claude Design), handoff-first workflow via Claude Design bundles, bidirectional Figma write-back (annotations, Code Connect), queryable intel store (`.design/intel/`) for O(1) design surface lookups, and self-improvement loop (reflector agent, frontmatter + budget feedback, global-skills layer at `~/.claude/gdd/global-skills/`). Standalone commands: style, darkmode, compare, figma-write, graphify, handoff, analyze-dependencies, skill-manifest, extract-learnings, reflect, apply-reflections. Embeds NNG heuristics, WCAG thresholds, typographic systems, motion framework, and anti-pattern catalog. Ships with a full CI/CD pipeline (Node 22/24 × Linux/macOS/Windows, lint + schema + frontmatter + stale-ref + shellcheck + gitleaks + injection-scan + blocking size-budget) and release automation (auto-tag + GitHub Release + release-time smoke test). Optimization layer (v1.0.4.1, retroactive): gdd-router + gdd-cache-manager skills, PreToolUse budget-enforcer hook, tier-aware agent frontmatter, lazy checker gates, streaming synthesizer, /gdd:warm-cache + /gdd:optimize commands, and cost telemetry at .design/telemetry/costs.jsonl — targeting 50-70% per-task token-cost reduction with no quality-floor regression. v1.20.0 SDK foundation: gdd-state MCP server (11 typed tools), lockfile-safe STATE.md mutations, event stream at .design/telemetry/events.jsonl, resilience primitives (jittered-backoff, rate-guard, error-classifier, iteration-budget) with rate-limit + 429 + context-overflow recovery, and TypeScript toolchain. v1.27.7 ships gdd-mcp (Phase 27.7): 12 read-only MCP tools for sub-3s priming. v1.28.0 (Phase 28): Foundational References Tier 2 — 5 new reference files (color-theory, composition, proportion-systems, i18n, contrast-advanced), 2 verifier i18n probes + 1 explore i18n-readiness probe, 12 additive cross-link insertions across 10 existing references, 2 orthogonal audit-scoring lens-tags (composition_alignment + i18n_readiness).",
   "author": {
     "name": "hegemonart",

package/CHANGELOG.md

@@ -4,6 +4,52 @@ All notable changes to get-design-done are documented here. Versions follow [sem
 
 ---
 
+## [1.28.7] — 2026-05-19
+
+### Phase 28.7 — Multi-Runtime Install (Pragmatic Port from gsd-build)
+
+Replaces the Phase 24 `kind: 'agents-md'` placeholder (which dropped a single bare `AGENTS.md` into each non-Claude runtime's config dir — content the runtimes did not actually consume) with proper native install for all 14 claimed runtimes. Architecture ported from `gsd-build/get-shit-done` (MIT) — see `NOTICE` for the rollup attribution. Per Phase 28.7 D-02 we port the architecture rather than byte-copying the upstream `bin/install.js` monolith. Off-cadence decimal sub-phase from v1.28.0 parent — sequence 1.28.0 → 1.28.5 → 1.28.6 → 1.28.7. Re-interpretation of the original ROADMAP Phase 28.7 (verification-gated) per user direction 2026-05-18: skip field-test reports, trust gsd-build's upstream proving of the pattern. 10 plans across Waves A (foundations) / B (converters) / C (wire-up + test + closeout).
+
+#### New install infrastructure (Wave A)
+
+- `scripts/lib/install/runtime-homes.cjs` (28.7-01) — pure per-runtime config-dir resolver for all 14 runtimes. Handles env-var overrides (`CLAUDE_CONFIG_DIR`, `XDG_CONFIG_HOME`, etc.), XDG paths, and special-case nests (Antigravity under `~/.gemini/antigravity`, Windsurf under `~/.codeium/windsurf`). Pure function — no I/O.
+- `scripts/lib/install/runtime-artifact-layout.cjs` (28.7-02) — per-(runtime, scope) layout table mapping each combination to its `kinds[] = [{kind, destSubpath, prefix}]` shape. Claude global → `skills/<name>/`; Claude local → `commands/gsd/` + `agents/`; cursor/codex/copilot/antigravity/windsurf/augment/trae/qwen/codebuddy → `skills/<name>/`; opencode + kilo → `command/<name>` (slash-command dir, not skills); gemini → `commands/gsd/` (commands-only); cline → `kinds: []` (rules-based — embeds in `.clinerules` per D-09).
+- `scripts/lib/install/runtime-slash.cjs` (28.7-03) — per-runtime slash-command surface emitter. Codex uses `$gdd-<name>` shell-var form; all others use `/gdd-<name>`. Reserves a forward-compat seam for downstream slash-aware install behaviors.
+
+#### Per-runtime content converters (Wave B)
+
+- 13 per-runtime converters at `scripts/lib/install/converters/<runtime>.cjs` (28.7-04 through 28.7-07), plus `shared.cjs` (frontmatter pass-through, tool-name rewrite, brand pass-through utilities). Each runtime converter exports `convert(content, skillName, ctx) → { path, content }`. Cross-references the Phase 21 cross-harness tool-name maps (`reference/codex-tools.md`, `reference/gemini-tools.md`) — tool name rewrites only happen for runtimes whose native tool names differ from Claude's defaults.
+  - Wave 1 (28.7-04) — `cursor`, `codex`, `copilot`, `antigravity`.
+  - Wave 2 (28.7-05) — `windsurf`, `augment`, `trae`, `qwen`.
+  - Wave 3 (28.7-06) — `codebuddy`, `cline`. **Cline** (D-09) writes rule-block aggregation to `.clinerules` rather than a skills directory.
+  - Wave 4 (28.7-07) — `opencode`, `kilo`, `gemini`. Opencode + kilo use `command/<name>` (slash-command dir); gemini ships commands-only into `commands/gsd/`.
+- **Hermes is OUT of scope** (D-03 + D-10) — Phase 24 D-02 runtime-list invariant preserved. The Phase 28.6 baseline tests' "no hermes.cjs" guard is mirrored in the new Phase 28.7 baseline test.
+
+#### Installer wire-up (Wave C.1)
+
+- `scripts/lib/install/installer.cjs` (28.7-08) — replaces the broken `kind: 'agents-md'` placeholder with a proper multi-artifact dispatcher. Reads the layout table, invokes the appropriate per-runtime converter for each kind, lands files at the resolved destination per `runtime-homes.cjs`. Backward-compat retained for the existing invocation surface (`--claude`, `--opencode`, …, `--cline`, `--dry-run`, `--global`, `--local`, `--config-dir`). Scope propagation through to converter `ctx` per D-07.
+
+#### Per-runtime simulation suite (Wave C.2)
+
+- `tests/install-per-runtime.test.cjs` (28.7-09) — 14 simulation tests + 11 cross-runtime invariants. Each test creates a temp config dir via `mkdtempSync`, invokes the installer with `--config-dir <tmp> --<runtime>`, and asserts files land at the expected paths with content matching the converter output. macOS symlink discipline applied (`os.tmpdir()` + `fs.realpathSync` for path comparison) per Phase 27.6 lesson.
+
+#### Fixed
+
+- 13 non-Claude runtimes now actually receive their plugin payload. Before Phase 28.7: bare `AGENTS.md` drop with no runtime-side discovery. After: native artifact layout matching what each runtime expects (skills dir / command dir / agents dir / rule-block embedding).
+
+#### Closeout (Wave C.3)
+
+- 4-manifest lockstep at v1.28.7 (`package.json` + `.claude-plugin/plugin.json` + `.claude-plugin/marketplace.json` (metadata.version + plugins[0].version) + `test-fixture/baselines/phase-28/manifests-version.txt` forward-propagation).
+- `OFF_CADENCE_VERSIONS.add('1.28.7')` in `tests/semver-compare.test.cjs`.
+- README install section confirmed claims all 14 runtimes; no Experimental tier (D-04). Translated READMEs deferred (English authoritative for this phase).
+- `NOTICE` extended with Phase 28.7 gsd-build/get-shit-done (MIT) architectural-port attribution (D-02). Phase 27 (cc-multi-cli, Apache 2.0) + Phase 28.5 (mattpocock/skills, MIT) attributions unchanged.
+- Baseline at `test-fixture/baselines/phase-28.7/` (manifests-version, converter-inventory, registry-diff) + `phase-28.6/manifests-version.txt` and `phase-28/manifests-version.txt` forward-propagated to 1.28.7.
+- `phase-20/skill-list.txt` UNCHANGED (no skill add/remove this phase).
+- ROADMAP add + scoped flip (this section + overview entry, 10 inline plan checkboxes pre-flipped).
+- Phase 28.7 ports gsd-build's architecture rather than gating on field-test reports — re-interpretation of the original ROADMAP entry per user direction 2026-05-18 (CONTEXT.md D-01).
+
+---
+
 ## [1.28.6] — 2026-05-18
 
 ### Phase 28.6 — Skill Reference Co-Location (Corrective Follow-Up to Phase 28.5)

package/README.md

@@ -139,6 +139,8 @@ The installer prompts you to choose:
 1. **Runtime** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Qwen Code, CodeBuddy, Cline, or all (interactive multi-select — pick multiple runtimes in a single session)
 2. **Location** — Global (all projects) or local (current project only)
 
+All 14 runtimes receive their native artifact layout (`skills/`, `command/`, `agents/`, or `.clinerules`) via per-runtime content converters — Claude SKILL.md sources are translated to each runtime's expected shape at install time (frontmatter pass-through, path rewrite, tool-name rewrite via the Phase 21 cross-harness maps). Architecture ported from `gsd-build/get-shit-done` (MIT — see `NOTICE`).
+
 Verify with:
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hegemonart/get-design-done",
-  "version": "1.28.6",
+  "version": "1.28.7",
   "description": "A design-quality pipeline for AI coding agents: brief, plan, implement, and verify UI work against your design system.",
   "author": "Hegemon",
   "homepage": "https://github.com/hegemonart/get-design-done",

package/scripts/install.cjs

@@ -167,6 +167,13 @@ async function main() {
     } else if (location === 'local') {
       opts.configDir = resolveLocalConfigDir(runtime);
     }
+    // Phase 28.7 D-07 — pass scope through to the installer. The new
+    // `multi-artifact` kind branches on `local` vs `global` in
+    // `runtime-artifact-layout.cjs` (claude local writes commands/+agents/;
+    // claude global writes skills/), so the installer needs to know the
+    // user's chosen scope, not just the resolved configDir. Default is
+    // `global` per D-07.
+    opts.scope = location;
     const result = uninstall
       ? uninstallRuntime(id, opts)
       : installRuntime(id, opts);

package/scripts/lib/install/converters/antigravity.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+/**
+ * scripts/lib/install/converters/antigravity.cjs — Phase 28.7 (Plan 28.7-04).
+ *
+ * Google Antigravity SKILL.md converter. Translates Claude-shape source
+ * into Antigravity's expected shape (which nests under `~/.gemini/antigravity/`
+ * per the runtime-homes resolver):
+ *
+ *   - Frontmatter `name:` normalized to `gdd-<skill>` (no double-prefix).
+ *   - Slash references in prose pass through as `/gdd-<name>` —
+ *     Antigravity accepts the Claude shape. Mixed-shape inputs are
+ *     normalized via the runtime-slash module.
+ *   - Tool names in code fences pass through unchanged — Antigravity
+ *     accepts the Claude vocabulary (Read/Write/Bash/Edit/Grep/Glob).
+ *   - A 1-line HTML adapter header is injected at the top of the body
+ *     to record that this file was auto-generated from Claude source.
+ *
+ * Architecture ported from gsd-build/get-shit-done (MIT) — per Phase
+ * 28.7 D-02 (port architecture, not source). See NOTICE for upstream
+ * attribution. gsd-build's equivalent function is
+ * `convertClaudeCommandToAntigravitySkill` in bin/install.js; our
+ * modular factor delegates the actual rewrites to ./shared.cjs.
+ *
+ * Pure / side-effect-free: no fs, no env, no path. `convert` is a
+ * deterministic string → string transform.
+ */
+
+const shared = require('./shared.cjs');
+
+/**
+ * Convert Claude-source SKILL.md content for the Antigravity runtime.
+ *
+ * @param {string} content        Full source SKILL.md content (frontmatter + body).
+ * @param {string} skillName      The bare skill name (e.g. `'help'`, `'explore'`).
+ * @param {{ runtime?: string }} [opts]  Optional context — `runtime` defaults
+ *   to `'antigravity'`. Currently informational only.
+ * @returns {string}
+ */
+function convert(content, skillName, opts) {
+  const { frontmatter, body } = shared.extractFrontmatterAndBody(content);
+  const fm = shared.buildFrontmatter(frontmatter, skillName, 'gdd-');
+  let out = shared.rewriteSlashRefs(body, 'antigravity');
+  out = shared.ensureAdapterHeader(out, 'Antigravity');
+  return fm + out;
+}
+
+module.exports = { convert };

package/scripts/lib/install/converters/augment.cjs

@@ -0,0 +1,68 @@
+'use strict';
+
+/**
+ * scripts/lib/install/converters/augment.cjs — Phase 28.7 (Plan 28.7-05).
+ *
+ * Augment Code SKILL.md converter. Translates Claude-shape source into
+ * Augment's expected shape:
+ *
+ *   - Frontmatter `name:` normalized to `gdd-<skill>` (no double-prefix).
+ *   - Slash references in prose pass through as `/gdd-<name>` —
+ *     Augment accepts the Claude shape for slash references.
+ *   - Tool names in code fences are rewritten per `AUGMENT_TOOL_MAP`:
+ *       Bash → launch-process
+ *       Edit → str-replace-editor
+ *     Read/Write/Grep/Glob/WebSearch/WebFetch pass through unchanged —
+ *     Augment recognizes the Claude vocabulary for those tools.
+ *   - Prose mentions of tool names (e.g. "use the Bash tool") are NOT
+ *     rewritten — only the parenthesized invocation form inside fenced
+ *     blocks gets rewritten. This matches the codex converter's policy
+ *     (Phase 28.7 D-06).
+ *   - A 1-line HTML adapter header is injected at the top of the body
+ *     to record that this file was auto-generated from Claude source.
+ *
+ * Architecture ported from gsd-build/get-shit-done (MIT) — per Phase
+ * 28.7 D-02 (port architecture, not source). See NOTICE for upstream
+ * attribution. gsd-build's equivalent function is
+ * `convertClaudeCommandToAugmentSkill` in bin/install.js; our modular
+ * factor delegates the actual rewrites to ./shared.cjs.
+ *
+ * Pure / side-effect-free: no fs, no env, no path. `convert` is a
+ * deterministic string → string transform.
+ */
+
+const shared = require('./shared.cjs');
+
+/**
+ * Claude tool name → Augment tool name. Per Augment's documented tool
+ * surface (launch-process for shell execution, str-replace-editor for
+ * file edits). Frozen to prevent accidental mutation.
+ *
+ * Future: extract AUGMENT_TOOL_MAP to reference/augment-tools.md per
+ * the Phase 21 pattern (cf. CODEX_TOOL_MAP in shared.cjs) if scope grows
+ * beyond two entries.
+ */
+const AUGMENT_TOOL_MAP = Object.freeze({
+  Bash: 'launch-process',
+  Edit: 'str-replace-editor',
+});
+
+/**
+ * Convert Claude-source SKILL.md content for the Augment runtime.
+ *
+ * @param {string} content        Full source SKILL.md content (frontmatter + body).
+ * @param {string} skillName      The bare skill name (e.g. `'help'`, `'explore'`).
+ * @param {{ runtime?: string }} [opts]  Optional context — `runtime` defaults
+ *   to `'augment'`. Currently informational only.
+ * @returns {string}
+ */
+function convert(content, skillName, opts) {
+  const { frontmatter, body } = shared.extractFrontmatterAndBody(content);
+  const fm = shared.buildFrontmatter(frontmatter, skillName, 'gdd-');
+  let out = shared.rewriteSlashRefs(body, 'augment');
+  out = shared.rewriteCodeFenceTools(out, AUGMENT_TOOL_MAP);
+  out = shared.ensureAdapterHeader(out, 'Augment');
+  return fm + out;
+}
+
+module.exports = { convert, AUGMENT_TOOL_MAP };

package/scripts/lib/install/converters/cline.cjs

@@ -0,0 +1,206 @@
+'use strict';
+
+/**
+ * scripts/lib/install/converters/cline.cjs — Phase 28.7 (Plan 28.7-06).
+ *
+ * Cline SKILL.md converter — SPECIAL CASE per Phase 28.7 D-09.
+ *
+ * Cline does not have a `skills/<name>/SKILL.md` directory model. Per
+ * `runtime-artifact-layout.cjs#cline`, its `kinds: []` is intentionally
+ * empty and `layout.specialCase = 'clinerules-embed'` routes through
+ * this converter. Instead of one SKILL.md file per skill, all installed
+ * skills are concatenated into a single `.clinerules` file written at
+ * `<cline-config>/.clinerules`. That file contains a stack of markdown
+ * rule-blocks, one per skill, with a `## gdd-<skillName>` heading and
+ * description + body prose.
+ *
+ * This file exports TWO functions:
+ *
+ *   1. `convert(content, skillName, opts) → string`
+ *      Converts ONE Claude-source SKILL.md into a `.clinerules`-format
+ *      rule-block. The block is a markdown fragment — NOT a complete
+ *      file. The installer (Plan 28.7-08) invokes this for each skill,
+ *      accumulates the blocks, then calls `buildClinerulesFile` to
+ *      assemble the final file.
+ *
+ *   2. `buildClinerulesFile(skillBlocks) → string`
+ *      Concatenates an array of `{ name, block }` entries into the
+ *      final `.clinerules` file content. Prepends a 4-line header
+ *      explaining the file's origin (auto-generated from gdd skills).
+ *
+ * Output shape (one block):
+ *
+ *     ## gdd-<skillName>
+ *
+ *     <description from source frontmatter>
+ *
+ *     <body content, slash-rewritten, prose preserved>
+ *
+ * The block contains NO YAML frontmatter (cline rules are pure
+ * markdown), NO `<!-- ... adapter -->` HTML comment (rules-format does
+ * not embed adapter headers), and NO `name:` field — the `## gdd-<name>`
+ * heading IS the skill identifier in cline's rule-block model.
+ *
+ * Architecture ported from gsd-build/get-shit-done (MIT) — per Phase
+ * 28.7 D-02 (port architecture, not source). See NOTICE for upstream
+ * attribution. gsd-build's equivalent path is the `cline: kinds: []` +
+ * `.clinerules` write special-case in their bin/install.js monolith;
+ * our modular factor moves the rule-block emission here and lets the
+ * installer (Plan 28.7-08) handle the disk write.
+ *
+ * Wave-3 scope note: this is the only special-case converter in Wave 3
+ * (Plan 28.7-06). The other Wave 3 converter (codebuddy.cjs) follows
+ * the uniform skills-dir pattern. Per Phase 28.7 D-10, hermes is OUT of
+ * scope — no hermes.cjs is created. Hermes was the other special-case
+ * runtime in gsd-build's full set (nested skills/gsd/<name>/ layout per
+ * upstream #2841), but it is intentionally absent from GDD's 14-runtime
+ * set (Phase 24 D-02 runtime list invariant — see Phase 28.7 D-03).
+ *
+ * Pure / side-effect-free: no fs, no env, no path. Both exports are
+ * deterministic string → string transforms; the installer writes the
+ * assembled file via its own fs surface.
+ */
+
+const shared = require('./shared.cjs');
+
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Extract the `description:` value from a frontmatter block.
+ *
+ * Matches the first `description: <value>` line; tolerates leading
+ * whitespace, surrounding quotes (single or double), and CRLF endings.
+ * Returns the trimmed value string, or `''` if not present.
+ *
+ * Note: we don't parse YAML here — a single regex over the raw
+ * frontmatter is sufficient because SKILL.md descriptions are always
+ * single-line strings (multi-line YAML scalars are not used in the
+ * GDD source set).
+ *
+ * @param {string|null} frontmatter
+ * @returns {string}
+ */
+function extractDescription(frontmatter) {
+  if (!frontmatter || typeof frontmatter !== 'string') return '';
+  const m = frontmatter.match(/^\s*description\s*:\s*(.*)$/m);
+  if (!m) return '';
+  let v = m[1].trim();
+  // Strip surrounding quotes if present.
+  const quoted = v.match(/^["'](.*)["']$/);
+  if (quoted) v = quoted[1];
+  return v;
+}
+
+/**
+ * Normalize the skill name by stripping any prior `gdd-`/`gsd-` prefix
+ * (case-insensitive) so we never emit `gdd-gdd-foo`. Matches
+ * `shared.buildFrontmatter`'s normalization for consistency.
+ *
+ * @param {string} skillName
+ * @returns {string}
+ */
+function normalizeSkillName(skillName) {
+  return String(skillName || '').replace(/^(gdd-|gsd-)/i, '');
+}
+
+// ---------------------------------------------------------------------------
+// convert — produce a single rule-block for one skill
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert ONE Claude-source SKILL.md into a `.clinerules`-format rule
+ * block (a markdown fragment, not a complete file).
+ *
+ * The returned block has this shape:
+ *
+ *     ## gdd-<skillName>
+ *
+ *     <description if present>
+ *
+ *     <body content, slash-rewritten via rewriteSlashRefs(body, 'cline')>
+ *
+ * Trailing newline is included; leading whitespace is stripped from the
+ * body so the heading is the first non-blank line. The installer
+ * (Plan 28.7-08) accumulates these blocks and joins them via
+ * `buildClinerulesFile`.
+ *
+ * @param {string} content        Full source SKILL.md content (frontmatter + body).
+ * @param {string} skillName      The bare skill name (e.g. `'help'`, `'explore'`).
+ *   `gdd-`/`gsd-` prefixes are stripped to prevent double-prefix.
+ * @param {{ runtime?: string }} [opts]  Optional context — `runtime` defaults
+ *   to `'cline'`. Currently informational only.
+ * @returns {string}  The rule-block markdown fragment.
+ */
+function convert(content, skillName, opts) {
+  const { frontmatter, body } = shared.extractFrontmatterAndBody(content);
+  const description = extractDescription(frontmatter);
+  const bareName = normalizeSkillName(skillName);
+
+  // Slash refs rewrite to `/gdd-name` form — cline accepts Claude-shape
+  // slashes (runtime-slash.cjs emits `/gdd-` for every non-codex runtime,
+  // and cline is not codex). Trim leading/trailing whitespace so the
+  // heading directly precedes the body content.
+  const prose = shared.rewriteSlashRefs(body, 'cline').trim();
+
+  const heading = `## gdd-${bareName}`;
+  const descLine = description ? `${description}\n\n` : '';
+
+  return `${heading}\n\n${descLine}${prose}\n`;
+}
+
+// ---------------------------------------------------------------------------
+// buildClinerulesFile — assemble the final .clinerules file content
+// ---------------------------------------------------------------------------
+
+/**
+ * Assemble a final `.clinerules` file from an array of per-skill blocks.
+ *
+ * Prepends a 4-line header citing the gdd origin so anyone reading the
+ * generated `.clinerules` file knows it is auto-generated and the
+ * authoritative source is the upstream SKILL.md files. Blocks are
+ * separated by a blank line (`\n\n`), and the file ends with a single
+ * trailing newline.
+ *
+ * Called by Plan 28.7-08's installer after invoking `convert()` on each
+ * skill. Pure transform — does NOT write to disk.
+ *
+ * Accepts either of two shapes per entry (for installer flexibility):
+ *   - `{ name: string, block: string }` — preferred, name is informational
+ *   - `{ skillName: string, content: string }` — alternative legacy/test shape
+ *
+ * @param {Array<{ name?: string, skillName?: string, block?: string, content?: string }>} skillBlocks
+ * @returns {string}  The full `.clinerules` content (ready to write).
+ */
+function buildClinerulesFile(skillBlocks) {
+  const header = [
+    '# get-design-done rules',
+    '',
+    '<!-- Auto-generated from gdd SKILL.md sources. Edit upstream skills, not this file. -->',
+    '',
+  ].join('\n');
+
+  // Defensive: empty / non-array → header-only file.
+  if (!Array.isArray(skillBlocks) || skillBlocks.length === 0) {
+    return header + '\n';
+  }
+
+  const body = skillBlocks
+    .map((entry) => {
+      // Accept either `block` or `content` keys.
+      if (!entry || typeof entry !== 'object') return '';
+      const text = typeof entry.block === 'string'
+        ? entry.block
+        : typeof entry.content === 'string'
+          ? entry.content
+          : '';
+      return text.trim();
+    })
+    .filter((s) => s.length > 0)
+    .join('\n\n');
+
+  return header + body + '\n';
+}
+
+module.exports = { convert, buildClinerulesFile };

package/scripts/lib/install/converters/codebuddy.cjs

@@ -0,0 +1,55 @@
+'use strict';
+
+/**
+ * scripts/lib/install/converters/codebuddy.cjs — Phase 28.7 (Plan 28.7-06).
+ *
+ * CodeBuddy SKILL.md converter. Translates Claude-shape source into
+ * CodeBuddy's expected shape (uniform skills/<name>/SKILL.md layout —
+ * per `runtime-artifact-layout.cjs#codebuddy` which emits the standard
+ * skillsKind('skills', 'gdd-', ...) entry):
+ *
+ *   - Frontmatter `name:` normalized to `gdd-<skill>` (no double-prefix).
+ *   - Slash references in prose pass through as `/gdd-<name>` —
+ *     CodeBuddy accepts the Claude shape. Mixed-shape inputs are
+ *     normalized via the runtime-slash module.
+ *   - Tool names in code fences pass through unchanged — CodeBuddy
+ *     accepts the Claude vocabulary (Read/Write/Bash/Edit/Grep/Glob).
+ *   - A 1-line HTML adapter header is injected at the top of the body
+ *     to record that this file was auto-generated from Claude source.
+ *
+ * Architecture ported from gsd-build/get-shit-done (MIT) — per Phase
+ * 28.7 D-02 (port architecture, not source). See NOTICE for upstream
+ * attribution. gsd-build's equivalent function is
+ * `convertClaudeCommandToCodeBuddySkill` in bin/install.js; our modular
+ * factor delegates the actual rewrites to ./shared.cjs.
+ *
+ * This converter follows the same uniform pattern as cursor / windsurf /
+ * trae / qwen / copilot / antigravity — it is NOT a special-case
+ * runtime. The only special-case converter in Wave 3 is cline.cjs (per
+ * D-09: rule-block embedding into `.clinerules`); hermes is OUT of
+ * scope per D-10 and intentionally has no converter file.
+ *
+ * Pure / side-effect-free: no fs, no env, no path. `convert` is a
+ * deterministic string → string transform.
+ */
+
+const shared = require('./shared.cjs');
+
+/**
+ * Convert Claude-source SKILL.md content for the CodeBuddy runtime.
+ *
+ * @param {string} content        Full source SKILL.md content (frontmatter + body).
+ * @param {string} skillName      The bare skill name (e.g. `'help'`, `'explore'`).
+ * @param {{ runtime?: string }} [opts]  Optional context — `runtime` defaults
+ *   to `'codebuddy'`. Currently informational only.
+ * @returns {string}
+ */
+function convert(content, skillName, opts) {
+  const { frontmatter, body } = shared.extractFrontmatterAndBody(content);
+  const fm = shared.buildFrontmatter(frontmatter, skillName, 'gdd-');
+  let out = shared.rewriteSlashRefs(body, 'codebuddy');
+  out = shared.ensureAdapterHeader(out, 'CodeBuddy');
+  return fm + out;
+}
+
+module.exports = { convert };

package/scripts/lib/install/converters/codex.cjs

@@ -0,0 +1,61 @@
+'use strict';
+
+/**
+ * scripts/lib/install/converters/codex.cjs — Phase 28.7 (Plan 28.7-04).
+ *
+ * Codex SKILL.md converter. Translates Claude-shape source into Codex's
+ * expected shape:
+ *
+ *   - Frontmatter `name:` normalized to `gdd-<skill>` (no double-prefix).
+ *   - Slash references in prose rewritten from `/gdd-<name>` to
+ *     `$gdd-<name>` (Codex's shell-variable form) via
+ *     `../runtime-slash.cjs#formatGddSlash`. Skill names are lowercased
+ *     on emission per Codex shell-var convention.
+ *   - Tool names in code fences rewritten via `CODEX_TOOL_MAP` from
+ *     `reference/codex-tools.md` (Phase 21 D-06 reuse):
+ *       Read       → read_file
+ *       Write/Edit → apply_patch
+ *       Bash/Grep  → shell
+ *       Glob       → shell
+ *       WebSearch  → web_search
+ *       WebFetch   → shell
+ *     Task is left untouched (Phase 21 codex-tools.md "Known gaps").
+ *   - A 1-line HTML adapter header is injected at the top of the body
+ *     to record that this file was auto-generated from Claude source.
+ *
+ * Architecture ported from gsd-build/get-shit-done (MIT) — per Phase
+ * 28.7 D-02 (port architecture, not source). See NOTICE for upstream
+ * attribution. gsd-build's equivalent is `convertClaudeCommandToCodexSkill`
+ * in bin/install.js; our modular factor delegates rewrites to ./shared.cjs
+ * and pulls the tool map from the same module's CODEX_TOOL_MAP export.
+ *
+ * Pure / side-effect-free: no fs, no env, no path. `convert` is a
+ * deterministic string → string transform.
+ *
+ * Per Phase 21 codex-tools.md: tool-name rewrites are operative on the
+ * code-fenced INVOCATION form (`Bash(command=...)`) only. Prose mentions
+ * of the Claude vocabulary ("Use the Bash tool to...") round-trip
+ * unchanged — they're documentation, not invocations.
+ */
+
+const shared = require('./shared.cjs');
+
+/**
+ * Convert Claude-source SKILL.md content for the Codex runtime.
+ *
+ * @param {string} content        Full source SKILL.md content (frontmatter + body).
+ * @param {string} skillName      The bare skill name (e.g. `'help'`, `'explore'`).
+ * @param {{ runtime?: string }} [opts]  Optional context — `runtime` defaults
+ *   to `'codex'`. Currently informational only.
+ * @returns {string}
+ */
+function convert(content, skillName, opts) {
+  const { frontmatter, body } = shared.extractFrontmatterAndBody(content);
+  const fm = shared.buildFrontmatter(frontmatter, skillName, 'gdd-');
+  let out = shared.rewriteSlashRefs(body, 'codex');
+  out = shared.rewriteCodeFenceTools(out, shared.CODEX_TOOL_MAP);
+  out = shared.ensureAdapterHeader(out, 'Codex');
+  return fm + out;
+}
+
+module.exports = { convert };

package/scripts/lib/install/converters/copilot.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+/**
+ * scripts/lib/install/converters/copilot.cjs — Phase 28.7 (Plan 28.7-04).
+ *
+ * GitHub Copilot SKILL.md converter. Translates Claude-shape source
+ * into Copilot's expected shape:
+ *
+ *   - Frontmatter `name:` normalized to `gdd-<skill>` (no double-prefix).
+ *   - Slash references in prose pass through as `/gdd-<name>` —
+ *     Copilot accepts the Claude shape. Mixed-shape inputs are
+ *     normalized via the runtime-slash module.
+ *   - Tool names in code fences pass through unchanged — Copilot
+ *     accepts the Claude vocabulary (Read/Write/Bash/Edit/Grep/Glob).
+ *   - A 1-line HTML adapter header is injected at the top of the body
+ *     to record that this file was auto-generated from Claude source.
+ *
+ * Architecture ported from gsd-build/get-shit-done (MIT) — per Phase
+ * 28.7 D-02 (port architecture, not source). See NOTICE for upstream
+ * attribution. gsd-build's equivalent function is
+ * `convertClaudeCommandToCopilotSkill` in bin/install.js; our modular
+ * factor delegates the actual rewrites to ./shared.cjs.
+ *
+ * Pure / side-effect-free: no fs, no env, no path. `convert` is a
+ * deterministic string → string transform.
+ */
+
+const shared = require('./shared.cjs');
+
+/**
+ * Convert Claude-source SKILL.md content for the Copilot runtime.
+ *
+ * @param {string} content        Full source SKILL.md content (frontmatter + body).
+ * @param {string} skillName      The bare skill name (e.g. `'help'`, `'explore'`).
+ * @param {{ runtime?: string }} [opts]  Optional context — `runtime` defaults
+ *   to `'copilot'`. Currently informational only.
+ * @returns {string}
+ */
+function convert(content, skillName, opts) {
+  const { frontmatter, body } = shared.extractFrontmatterAndBody(content);
+  const fm = shared.buildFrontmatter(frontmatter, skillName, 'gdd-');
+  let out = shared.rewriteSlashRefs(body, 'copilot');
+  out = shared.ensureAdapterHeader(out, 'Copilot');
+  return fm + out;
+}
+
+module.exports = { convert };