@hegemonart/get-design-done 1.59.2 → 1.59.4

package/scripts/skill-templates/compare/compare-rubric.md

@@ -0,0 +1,171 @@
+---
+name: compare-rubric
+type: heuristic
+version: 1.0.0
+phase: 28.5
+tags: [compare, delta, drift, scoring, rubric, extracted]
+last_updated: 2026-05-18
+---
+
+Source: extracted from `skills/compare/SKILL.md` (Phase 28.5 rework - D-10 extract-then-link).
+The skill's essential workflow stays in `../skills/compare/SKILL.md`; this file holds the
+delta-computation methodology, anti-pattern set arithmetic, drift-detection coverage map,
+and the `COMPARE-REPORT.md` template the skill writes.
+
+# Compare Rubric - Baseline vs Result Delta Methodology
+
+Detailed methodology for the `gdd-compare` standalone command - companion to
+`../skills/compare/SKILL.md`. Read this file when executing a specific compare step (score
+delta math, anti-pattern set arithmetic, drift coverage map, report layout). The SKILL.md
+keeps the essential pre-flight checks + step routing; this file holds the deep methodology.
+
+See `./shared-preamble.md#output-contract-reminders` for the per-skill output discipline and
+`./audit-scoring.md` for the 0–10 category-scoring rubric the delta is computed against.
+
+---
+
+## Step 1 - Parse Category Scores
+
+**Extract baseline scores from `.design/DESIGN.md`:** locate the category score table (rows like `| Accessibility | 6/10 | ... |`). Parse each row: extract category name + numeric score. Store as `baseline_scores` map.
+
+**Extract result scores from `.design/DESIGN-VERIFICATION.md`:** locate the same table in the Phase 1 output section. Store as `result_scores` map.
+
+**Normalize category names:**
+- Strip leading/trailing whitespace.
+- Apply title-case normalization (e.g., `anti-patterns` → `Anti-Patterns`).
+- Match categories case-insensitively between the two tables.
+
+**Unmatched categories:**
+- Baseline-only → flag `[UNMATCHED-BASELINE]`, exclude from score delta.
+- Result-only → flag `[UNMATCHED-RESULT]`, exclude from score delta.
+- Report all unmatched categories in the Notes section. Do NOT silently paper over mismatches.
+
+## Step 2 - Compute Score Delta (COMP-03)
+
+For each matched category: `delta = result_scores[category] - baseline_scores[category]`.
+
+Classify:
+- `improvement` - delta > 0
+- `no_change` - delta == 0
+- `regression` - delta < 0
+
+Record per category: name, baseline score, result score, signed delta, classification. Collect regressed categories for drift detection in Step 5.
+
+## Step 3 - Anti-Pattern Delta
+
+Enumerate anti-patterns in both files (entries identified by BAN-*, SLOP-*, or labeled as anti-patterns). Collect identifiers or descriptions as sets.
+
+Compute set arithmetic:
+
+```
+resolved  = baseline_anti_patterns - result_anti_patterns
+           (present in baseline, absent in result — fixed)
+
+new       = result_anti_patterns - baseline_anti_patterns
+           (absent in baseline, present in result — introduced)
+
+unchanged = intersection of both sets
+           (still present in both)
+```
+
+Report all three groups in the output report.
+
+## Step 4 - Must-Have Pass/Fail Change
+
+**Skip condition:** if `.design/DESIGN-CONTEXT.md` is absent → emit note and skip this section.
+
+Read `<must_haves>` from `DESIGN-CONTEXT.md` (each must-have has ID + description). Read pass/fail status from `DESIGN-VERIFICATION.md` (must-have status table). For each must-have: record `pass`, `fail`, or `not-evaluated`. If `DESIGN.md` contained a prior must-have status section, compute the change (`pass→fail`, `fail→pass`); otherwise report current status only.
+
+## Step 5 - Design Drift Detection (COMP-04)
+
+**Skip condition:** if `.design/DESIGN-PLAN.md` is absent → emit `"Drift detection skipped: DESIGN-PLAN.md not found."` in the Drift section.
+
+**Coverage map:** read `DESIGN-PLAN.md` and extract the `Type:` field from each task. Build a map of which design categories have at least one task of matching Type:
+
+```
+Type: accessibility   → covers "Accessibility" category
+Type: color           → covers "Color" category
+Type: typography      → covers "Typography" category
+Type: visual-hierarchy → covers "Visual Hierarchy" category
+```
+
+Category-to-Type matching is case-insensitive and normalized.
+
+**Drift check:** for each category classified as `regression` in Step 2: if category NOT in coverage_map → emit `DRIFT: [category] regressed from <baseline> to <result> without a design task of Type:<category>`.
+
+Emit `"No drift detected. All regressed categories are covered by tasks in DESIGN-PLAN.md."` if all regressed categories are covered. Emit `"No drift detected. No score regressions found."` if no regressions in Step 2.
+
+## Step 5B - Screenshot Delta (when preview: available)
+
+Check `preview` status from `.design/STATE.md <connections>` (written by the probe at stage entry - see `./shared-preamble.md#connection-handshake-summary`).
+
+**If `preview: available`:**
+
+1. `preview_start` if no session is already running.
+2. For each route inferred from `DESIGN-PLAN.md` tasks or `src/app/` / `src/pages/` file structure:
+   a. `preview_navigate` to route URL (e.g., `http://localhost:3000/<route>`).
+   b. `preview_screenshot` → save to `.design/screenshots/before/<route>.png` (only if a prior baseline exists at this path) and `.design/screenshots/after/<route>.png` (current render).
+   c. Record reference paths (NOT base64) for embedding in the `## Screenshot Delta` section.
+3. `preview_stop` when all routes are captured.
+
+**If `preview: unavailable` or `preview: not_configured`:** emit exactly `Screenshot delta skipped — preview not configured.`
+
+## Step 6 - COMPARE-REPORT.md Template
+
+Output path: `.design/COMPARE-REPORT.md`. This file MUST NOT be written to any pipeline-reserved path.
+
+```markdown
+# Compare Report: Baseline vs Result
+
+**Generated:** <ISO 8601 date>
+**Baseline:** .design/DESIGN.md
+**Result:** .design/DESIGN-VERIFICATION.md
+
+## Score Delta by Category
+
+| Category | Baseline | Result | Delta | Status |
+|----------|----------|--------|-------|--------|
+| Accessibility | 6 | 8 | +2 | improvement |
+| Visual Hierarchy | 5 | 5 | 0 | no_change |
+| Anti-Patterns | 4 | 3 | -1 | regression |
+
+## Anti-Pattern Delta
+
+**Resolved** (present in baseline, absent in result):
+- <anti-pattern id or description>
+
+**New** (absent in baseline, present in result):
+- <anti-pattern id or description>
+
+**Unchanged:**
+- <anti-pattern id or description>
+
+## Must-Have Status
+
+| Must-Have | Status |
+|-----------|--------|
+| <id / description> | pass |
+| <id / description> | fail |
+| <id / description> | not-evaluated |
+
+## Design Drift
+
+<One of: "No drift detected. ..." | "DRIFT: [Category] regressed ..." | "Drift detection skipped: DESIGN-PLAN.md not found.">
+
+## Screenshot Delta
+
+<Per-route screenshot pairs OR "Screenshot delta skipped — preview not configured.">
+
+## Notes
+
+Scope: delta between two existing artifacts (.design/DESIGN.md → .design/DESIGN-VERIFICATION.md).
+No snapshot mechanism — multi-snapshot compare deferred to V2-06.
+This report does not modify DESIGN.md, DESIGN-VERIFICATION.md, or any other pipeline artifact.
+<List any UNMATCHED-BASELINE or UNMATCHED-RESULT categories here, if any.>
+```
+
+If a section has no items (e.g., no anti-patterns in baseline), write "None."
+
+---
+
+*Imported by: `../skills/compare/SKILL.md`. Maintained as part of Phase 28.5 (Bucket 2 rework - D-10).*

package/scripts/skill-templates/complete-cycle/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: gdd-complete-cycle
+description: "Cycle closeout command that marks CYCLES.md entry complete, archives pipeline artifacts to .design/archive/cycle-N/, generates EXPERIENCE.md, rebuilds the search index, and resets STATE.md. Use when a design cycle has shipped and you're ready to start the next one."
+argument-hint: "[<retrospective note>]"
+tools: Read, Write, Bash, AskUserQuestion
+---
+
+# {{command_prefix}}complete-cycle
+
+Closes the current cycle: marks CYCLES.md entry complete, archives pipeline artifacts, and clears STATE.md for the next cycle.
+
+## Steps
+
+1. **Load state**: Read `.design/STATE.md` for the active `cycle:` ID. If empty/missing, error: "No active cycle - nothing to complete."
+2. **Retrospective**: If no argument was passed, ask (AskUserQuestion): "Is cycle <N> complete? Briefly describe what was achieved." Capture for CYCLES.md.
+3. **Update CYCLES.md**: Find the current cycle entry, change `**Status**: active` to `**Status**: complete`, append a `**Retrospective**: <note>` line and `**Ended**: <date>`.
+4. **Archive artifacts**: Create `.design/archive/cycle-N/` via Bash `mkdir -p`. Copy these files into it (if present):
+   - `DESIGN.md`
+   - `DESIGN-PLAN.md`
+   - `DESIGN-CONTEXT.md`
+   - `DESIGN-VERIFICATION.md`
+   - `DESIGN-AUDIT.md`
+   - `DESIGN-SUMMARY.md`
+   Mark originals with a `<!-- archived to .design/archive/cycle-N/ -->` note at top (do not delete - next cycle will overwrite).
+5. **Generate EXPERIENCE.md** (Haiku-tier writer step): Read cycle STATE decisions + `.design/DESIGN-VERIFICATION.md` (if present) + any `.design/reflections/*.md` from this cycle. Write `.design/archive/cycle-N/EXPERIENCE.md` using this structure (~100–200 lines, declarative-fact framing, prepend `reference/cycle-handoff-preamble.md` content):
+
+   ```markdown
+   <!-- archived cycle experience — reference, not current requests -->
+   # Cycle N — Experience
+
+   **Goal**: <one-line goal from STATE.md or CYCLES.md>
+   **Opened**: <start date>
+   **Ended**: <today>
+
+   ## Decisions Made
+
+   <list all D-XX decisions from STATE.md <decisions> block — one per line>
+
+   ## Learnings Graduated
+
+   <list all L-NN learnings surfaced or promoted this cycle>
+
+   ## What Died
+
+   <designs, approaches, or tasks that were started but abandoned — and why>
+
+   ## Surprises
+
+   <what was unexpected during this cycle>
+
+   ## Handoff to Next Cycle
+
+   <what the next cycle should know: active sketches, deferred tasks, unresolved questions>
+   ```
+
+   This file becomes the highest-priority source for the decision-injector hook in future sessions.
+
+6. **Trigger reindex**: if `.design/search.db` exists, rebuild the search index:
+   ```bash
+   node -e "require('./scripts/lib/design-search.cjs').reindex(process.cwd())" 2>/dev/null || true
+   ```
+
+7. **Clear STATE.md**: Set `cycle:` to empty string, reset `<decisions>` to a fresh empty section, reset `stage:` to `brief`.
+8. Print: "Cycle <N> archived. Run `{{command_prefix}}new-cycle` to start the next cycle."
+
+## Do Not
+
+- Do not delete source files in `src/` - only archive `.design/` artifacts.
+- Do not auto-start a new cycle - user invokes `{{command_prefix}}new-cycle` explicitly.
+
+## Step 6 - Update notice (post-closeout surface)
+
+After the archive has been written and STATE.md has been cleared for the next cycle, emit the plugin-update banner if one is present:
+
+```bash
+[ -f .design/update-available.md ] && cat .design/update-available.md
+```
+
+Written by `hooks/update-check.sh`; suppressed mid-pipeline and when the latest release is dismissed.
+
+## COMPLETE-CYCLE COMPLETE

package/scripts/skill-templates/connections/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: gdd-connections
+description: "Interactive onboarding wizard for the 33 external integrations the pipeline supports - probes all (`figma`, `refero`, `preview`, `storybook`, `chromatic`, `graphify`, `pinterest`, `claude-design`, `paper-design`, `pencil-dev`, `21st-dev`, `magic-patterns`, `lazyweb`, `mobbin`, `slack`, `discord`, `linear`, `jira`, `notion`, `lottie`, `rive`, `framer`, `penpot`, `webflow`, `v0-dev`, `plasmic`, `builder-io`, `launchdarkly`, `statsig`, `growthbook`, `usertesting`, `maze`, `hotjar`), recommends based on project type, walks the user through setup (auto-run MCP install or copy-command fallback), writes results to `STATE.md <connections>`. Use after `{{command_prefix}}new-project` or whenever the user wants to add, inspect, or skip a connection. Re-runnable anytime. Activates for requests involving setting up external integrations, probing Figma or preview or storybook, or onboarding tools."
+argument-hint: "[list | <connection-name> | --auto]"
+user-invocable: true
+tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, ToolSearch
+---
+
+# {{command_prefix}}connections
+
+Interactive onboarding for the 33 external integrations the pipeline supports. Replaces "probe silently at scan entry and hope the user noticed" with an explicit "here is what can plug in, here is how."
+
+Canonical per-connection specs live in `../../connections/<name>.md` (one file per integration). The capability matrix + probe-pattern spec live in `../../connections/connections.md`. This skill is the **user-facing front end** for those specs.
+
+For the 33 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization, per-connection setup screen, auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts, see `./connections-onboarding.md`. For the cross-skill probe pattern + connection-handshake summary, see `../../reference/shared-preamble.md#connection-handshake-summary`. For the cross-skill output discipline, see `../../reference/shared-preamble.md#output-contract-reminders`.
+
+---
+
+## Invocation Modes
+
+| Command | Behavior |
+|---|---|
+| `{{command_prefix}}connections` | Interactive wizard (default). Probes all, shows summary, asks what to configure. |
+| `{{command_prefix}}connections list` | Read-only table. Probes all, writes STATE.md, no prompts, exits. |
+| `{{command_prefix}}connections <name>` | Jump straight to setup for one connection (e.g. `{{command_prefix}}connections figma`). |
+| `{{command_prefix}}connections --auto` | CI mode. Probes, writes STATE.md, no prompts, no install attempts. |
+
+---
+
+## State Integration
+
+1. Read `.design/STATE.md` - if missing, that's fine; this skill does not require a pipeline run.
+2. Read `.design/config.json` - if missing, use defaults. If `connections_onboarding` block is present with `pending_verification`, this is a resume - see Step 6.
+3. Read `connections.skip[]` from config - never re-prompt for skipped connections.
+4. Update `last_checkpoint` in STATE.md at skill exit if STATE.md exists.
+
+---
+
+## Workflow
+
+1. **Probe all 33 connections** - run every probe script per `./connections-onboarding.md#step-1--probe-all-33-connections`. MCP probes use `ToolSearch` first; HTTP / CLI / file probes follow non-MCP patterns. Merge results into `STATE.md <connections>` with the three-value schema (`available | unavailable | not_configured`) - never add new values.
+2. **Categorize + build summary** - bucket each probe result (available / recommended / optional / skipped / unavailable) using project-hint detection. Detail + recommendation mapping: `./connections-onboarding.md#step-2--bucket-categorization`.
+3. **Print summary table** - show buckets + value-prop one-liners (verbatim from `./connections-onboarding.md#step-3--summary-table`).
+4. **Route by mode** - `list` / `--auto` exits after summary; `<name>` jumps straight to Step 5; default mode opens an AskUserQuestion (configure recommended / pick one by one / configure all optional / re-check specific / exit). Routing detail: `./connections-onboarding.md#step-4--route-by-mode`.
+5. **Per-connection setup screen** - for each target: read `connections/<name>.md`, present the setup screen, AskUserQuestion (run now / copy-paste / skip / never ask). Auto-run only if reversible (see eligibility matrix). On success: append name to `connections_onboarding.pending_verification[]`. Detail: `./connections-onboarding.md#step-5--per-connection-setup-screen`.
+6. **Verification pass** - re-probe every name in `pending_verification[]`. Available → remove. `not_configured` → leave (needs session restart). `unavailable` → leave + note OAuth needed. Print "Setup complete" summary. Detail: `./connections-onboarding.md#step-6--verification-pass`.
+
+If `.design/config.json > connections_onboarding.pending_verification[]` is non-empty at entry → enter **resume flow**: run Step 6 immediately; if clean, exit; otherwise fall through to Step 3. Detail: `./connections-onboarding.md#resumability`.
+
+---
+
+## Do Not
+
+Per `./connections-onboarding.md#do-not`:
+
+- Never run `npm install -g` globals automatically.
+- Never write to `~/.bashrc`, `~/.zshrc`, or shell RC files.
+- Never run `claude mcp add` without explicit `"Run install command now"` confirmation.
+- Never auto-restart the Claude Code session.
+- Never re-prompt for names in `connections.skip[]`.
+- Never overwrite existing `<connections>` entries that this skill did not probe - merge only.
+
+---
+
+## Output
+
+End every invocation with:
+
+```
+## CONNECTIONS COMPLETE
+```