@hegemonart/get-design-done 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/.claude-plugin/marketplace.json +63 -0
  2. package/.claude-plugin/plugin.json +54 -0
  3. package/CHANGELOG.md +221 -0
  4. package/LICENSE +21 -0
  5. package/README.md +724 -0
  6. package/SKILL.md +232 -0
  7. package/agents/README.md +226 -0
  8. package/agents/a11y-mapper.md +118 -0
  9. package/agents/component-taxonomy-mapper.md +88 -0
  10. package/agents/design-advisor.md +139 -0
  11. package/agents/design-assumptions-analyzer.md +171 -0
  12. package/agents/design-auditor.md +383 -0
  13. package/agents/design-context-builder.md +544 -0
  14. package/agents/design-context-checker-gate.md +90 -0
  15. package/agents/design-context-checker.md +260 -0
  16. package/agents/design-discussant.md +98 -0
  17. package/agents/design-doc-writer.md +229 -0
  18. package/agents/design-executor.md +452 -0
  19. package/agents/design-figma-writer.md +302 -0
  20. package/agents/design-fixer.md +180 -0
  21. package/agents/design-integration-checker-gate.md +93 -0
  22. package/agents/design-integration-checker.md +326 -0
  23. package/agents/design-pattern-mapper.md +206 -0
  24. package/agents/design-phase-researcher.md +229 -0
  25. package/agents/design-plan-checker.md +164 -0
  26. package/agents/design-planner.md +352 -0
  27. package/agents/design-reflector.md +175 -0
  28. package/agents/design-research-synthesizer.md +127 -0
  29. package/agents/design-verifier-gate.md +97 -0
  30. package/agents/design-verifier.md +605 -0
  31. package/agents/gdd-graphify-sync.md +100 -0
  32. package/agents/gdd-intel-updater.md +88 -0
  33. package/agents/gdd-learnings-extractor.md +85 -0
  34. package/agents/motion-mapper.md +103 -0
  35. package/agents/token-mapper.md +103 -0
  36. package/agents/visual-hierarchy-mapper.md +95 -0
  37. package/connections/chromatic.md +247 -0
  38. package/connections/claude-design.md +190 -0
  39. package/connections/connections.md +218 -0
  40. package/connections/figma-writer.md +139 -0
  41. package/connections/figma.md +146 -0
  42. package/connections/graphify.md +197 -0
  43. package/connections/pinterest.md +153 -0
  44. package/connections/preview.md +173 -0
  45. package/connections/refero.md +189 -0
  46. package/connections/storybook.md +280 -0
  47. package/hooks/budget-enforcer.js +318 -0
  48. package/hooks/context-exhaustion.js +127 -0
  49. package/hooks/gdd-read-injection-scanner.js +44 -0
  50. package/hooks/hooks.json +44 -0
  51. package/package.json +60 -0
  52. package/reference/BRANCH-PROTECTION.md +65 -0
  53. package/reference/DEPRECATIONS.md +41 -0
  54. package/reference/STATE-TEMPLATE.md +200 -0
  55. package/reference/accessibility.md +190 -0
  56. package/reference/anti-patterns.md +336 -0
  57. package/reference/audit-scoring.md +205 -0
  58. package/reference/checklists.md +137 -0
  59. package/reference/config-schema.md +319 -0
  60. package/reference/debugger-philosophy.md +32 -0
  61. package/reference/heuristics.md +201 -0
  62. package/reference/intel-schema.md +266 -0
  63. package/reference/model-prices.md +37 -0
  64. package/reference/model-tiers.md +118 -0
  65. package/reference/motion.md +285 -0
  66. package/reference/parallelism-rules.md +108 -0
  67. package/reference/priority-matrix.md +31 -0
  68. package/reference/project-skills-guide.md +42 -0
  69. package/reference/review-format.md +107 -0
  70. package/reference/schemas/config.schema.json +41 -0
  71. package/reference/schemas/hooks.schema.json +55 -0
  72. package/reference/schemas/intel.schema.json +191 -0
  73. package/reference/schemas/marketplace.schema.json +72 -0
  74. package/reference/schemas/plugin.schema.json +59 -0
  75. package/reference/shared-preamble.md +82 -0
  76. package/reference/typography.md +229 -0
  77. package/scripts/aggregate-agent-metrics.js +144 -0
  78. package/scripts/apply-branch-protection.sh +75 -0
  79. package/scripts/bootstrap-manifest.txt +3 -0
  80. package/scripts/bootstrap.sh +80 -0
  81. package/scripts/build-intel.cjs +458 -0
  82. package/scripts/detect-stale-refs.cjs +101 -0
  83. package/scripts/extract-changelog-section.cjs +57 -0
  84. package/scripts/release-smoke-test.cjs +169 -0
  85. package/scripts/rollback-release.sh +42 -0
  86. package/scripts/run-injection-scanner-ci.cjs +92 -0
  87. package/scripts/validate-frontmatter.cjs +68 -0
  88. package/scripts/validate-schemas.cjs +225 -0
  89. package/scripts/verify-version-sync.cjs +30 -0
  90. package/skills/add-backlog/SKILL.md +47 -0
  91. package/skills/analyze-dependencies/SKILL.md +184 -0
  92. package/skills/apply-reflections/SKILL.md +112 -0
  93. package/skills/audit/SKILL.md +54 -0
  94. package/skills/brief/SKILL.md +75 -0
  95. package/skills/cache-manager/SKILL.md +120 -0
  96. package/skills/compare/SKILL.md +322 -0
  97. package/skills/complete-cycle/SKILL.md +33 -0
  98. package/skills/darkmode/SKILL.md +331 -0
  99. package/skills/debug/SKILL.md +38 -0
  100. package/skills/design/SKILL.md +281 -0
  101. package/skills/discover/SKILL.md +172 -0
  102. package/skills/discuss/SKILL.md +67 -0
  103. package/skills/do/SKILL.md +45 -0
  104. package/skills/explore/SKILL.md +109 -0
  105. package/skills/extract-learnings/SKILL.md +98 -0
  106. package/skills/fast/SKILL.md +44 -0
  107. package/skills/figma-write/SKILL.md +40 -0
  108. package/skills/graphify/SKILL.md +48 -0
  109. package/skills/health/SKILL.md +48 -0
  110. package/skills/help/SKILL.md +76 -0
  111. package/skills/list-assumptions/SKILL.md +60 -0
  112. package/skills/map/SKILL.md +112 -0
  113. package/skills/new-cycle/SKILL.md +35 -0
  114. package/skills/new-project/SKILL.md +53 -0
  115. package/skills/next/SKILL.md +42 -0
  116. package/skills/note/SKILL.md +47 -0
  117. package/skills/optimize/SKILL.md +120 -0
  118. package/skills/pause/SKILL.md +41 -0
  119. package/skills/plan/SKILL.md +251 -0
  120. package/skills/plant-seed/SKILL.md +47 -0
  121. package/skills/pr-branch/SKILL.md +31 -0
  122. package/skills/progress/SKILL.md +60 -0
  123. package/skills/quick/SKILL.md +43 -0
  124. package/skills/reapply-patches/SKILL.md +31 -0
  125. package/skills/reflect/SKILL.md +73 -0
  126. package/skills/resume/SKILL.md +37 -0
  127. package/skills/review-backlog/SKILL.md +45 -0
  128. package/skills/router/SKILL.md +67 -0
  129. package/skills/scan/SKILL.md +721 -0
  130. package/skills/settings/SKILL.md +78 -0
  131. package/skills/ship/SKILL.md +31 -0
  132. package/skills/sketch/SKILL.md +78 -0
  133. package/skills/sketch-wrap-up/SKILL.md +88 -0
  134. package/skills/skill-manifest/SKILL.md +79 -0
  135. package/skills/spike/SKILL.md +67 -0
  136. package/skills/spike-wrap-up/SKILL.md +81 -0
  137. package/skills/stats/SKILL.md +50 -0
  138. package/skills/style/SKILL.md +193 -0
  139. package/skills/synthesize/SKILL.md +93 -0
  140. package/skills/todo/SKILL.md +54 -0
  141. package/skills/undo/SKILL.md +30 -0
  142. package/skills/update/SKILL.md +36 -0
  143. package/skills/verify/SKILL.md +452 -0
  144. package/skills/warm-cache/SKILL.md +113 -0
@@ -0,0 +1,63 @@
1
+ {
2
+ "name": "get-design-done",
3
+ "owner": {
4
+ "name": "hegemonart"
5
+ },
6
+ "metadata": {
7
+ "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). Ships with a full CI/CD pipeline (Node 22/24 × Linux/macOS/Windows) and release automation (auto-tag + GitHub Release + release-time smoke test).",
8
+ "version": "1.0.7"
9
+ },
10
+ "plugins": [
11
+ {
12
+ "name": "get-design-done",
13
+ "source": "./",
14
+ "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.",
15
+ "version": "1.0.7",
16
+ "author": {
17
+ "name": "hegemonart"
18
+ },
19
+ "homepage": "https://github.com/hegemonart/get-design-done",
20
+ "repository": "https://github.com/hegemonart/get-design-done",
21
+ "license": "MIT",
22
+ "category": "design",
23
+ "keywords": [
24
+ "design",
25
+ "ui",
26
+ "ux",
27
+ "frontend",
28
+ "pipeline",
29
+ "orchestration",
30
+ "skill",
31
+ "design-system",
32
+ "accessibility",
33
+ "wcag",
34
+ "nng",
35
+ "typography",
36
+ "motion",
37
+ "anti-patterns",
38
+ "audit",
39
+ "visual-regression",
40
+ "storybook",
41
+ "graphify",
42
+ "playwright",
43
+ "figma-write",
44
+ "handoff",
45
+ "claude-design",
46
+ "pinterest",
47
+ "bidirectional",
48
+ "knowledge-graph",
49
+ "intel-store",
50
+ "tested",
51
+ "ci",
52
+ "cicd",
53
+ "release-automation",
54
+ "gitleaks",
55
+ "shellcheck",
56
+ "schema-validation",
57
+ "cost-optimization",
58
+ "cache-aware",
59
+ "budget"
60
+ ]
61
+ }
62
+ ]
63
+ }
@@ -0,0 +1,54 @@
1
+ {
2
+ "name": "get-design-done",
3
+ "short_name": "gdd",
4
+ "version": "1.0.7",
5
+ "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.",
6
+ "author": {
7
+ "name": "hegemonart",
8
+ "url": "https://github.com/hegemonart"
9
+ },
10
+ "homepage": "https://github.com/hegemonart/get-design-done",
11
+ "repository": "https://github.com/hegemonart/get-design-done",
12
+ "license": "MIT",
13
+ "keywords": [
14
+ "design",
15
+ "ui",
16
+ "ux",
17
+ "frontend",
18
+ "pipeline",
19
+ "skill",
20
+ "design-system",
21
+ "accessibility",
22
+ "wcag",
23
+ "nng",
24
+ "typography",
25
+ "motion",
26
+ "anti-patterns",
27
+ "audit",
28
+ "visual-regression",
29
+ "storybook",
30
+ "graphify",
31
+ "playwright",
32
+ "figma-write",
33
+ "handoff",
34
+ "claude-design",
35
+ "pinterest",
36
+ "bidirectional",
37
+ "knowledge-graph",
38
+ "intel-store",
39
+ "self-improvement",
40
+ "reflection",
41
+ "tested",
42
+ "ci",
43
+ "cicd",
44
+ "release-automation",
45
+ "gitleaks",
46
+ "shellcheck",
47
+ "schema-validation",
48
+ "cost-optimization",
49
+ "cache-aware",
50
+ "budget"
51
+ ],
52
+ "skills": ["./", "./skills/"],
53
+ "hooks": "./hooks/hooks.json"
54
+ }
package/CHANGELOG.md ADDED
@@ -0,0 +1,221 @@
1
+ # Changelog
2
+
3
+ All notable changes to get-design-done are documented here. Versions follow [semantic versioning](https://semver.org/).
4
+
5
+ ---
6
+
7
+ ## [1.0.7] — 2026-04-18
8
+
9
+ ### Added — Phase 13: CI/CD
10
+ - `.github/workflows/ci.yml` expanded from single-job test runner to five-job pipeline: `lint` → `validate` → `test` (matrix) → `security` + `size-budget`
11
+ - Markdown lint via `markdownlint-cli2@0.13.0` (pinned); link checker via `lycheeverse/lychee-action@v2` (blocking)
12
+ - JSON schemas at `reference/schemas/`: `plugin.schema.json`, `marketplace.schema.json`, `hooks.schema.json`, `config.schema.json`, `intel.schema.json`
13
+ - `scripts/validate-schemas.cjs` — ajv-cli wrapper with structural-parse fallback for all schemas
14
+ - `scripts/validate-frontmatter.cjs` — CLI-friendly agent-frontmatter validator reusing `tests/helpers.cjs`
15
+ - `scripts/detect-stale-refs.cjs` — fails on any `/design:*` legacy namespace or deprecated agent/stage names; authoritative list in `reference/DEPRECATIONS.md`
16
+ - `claude plugin validate .` in CI with schema-only fallback (per D-09)
17
+ - `ludeeus/action-shellcheck@master` at severity=error on `scripts/`
18
+ - Hardcoded-absolute-path grep across `scripts/`, `reference/`, `agents/`, `skills/` (flags `/Users/`, `/home/<user>/`, `C:\`)
19
+ - `gitleaks/gitleaks-action@v2` secrets scan with `.gitleaks.toml` allowlist
20
+ - `scripts/run-injection-scanner-ci.cjs` — CI-mode scanner over Phase 7 injection patterns against all shipped `reference/`, `skills/**/SKILL.md`, `agents/*.md`
21
+ - `tests/agent-size-budget.test.cjs` wired as its own blocking `size-budget` CI job with actionable override guidance
22
+ - `.github/pull_request_template.md` — phase / version-bump / CHANGELOG / baseline / tests checklist
23
+ - `.github/CODEOWNERS` — solo-maintainer default (`* @hegemonart`)
24
+ - `reference/BRANCH-PROTECTION.md` + `scripts/apply-branch-protection.sh` — two-phase rollout (advisory → enforcing)
25
+ - `.github/workflows/release.yml` — auto-tag + GitHub Release on `.claude-plugin/plugin.json` version change; softprops/action-gh-release@v2
26
+ - `scripts/extract-changelog-section.cjs` — parses CHANGELOG for release body
27
+ - `scripts/rollback-release.sh` — documented manual rollback (not CI-automated, per D-22)
28
+ - `scripts/release-smoke-test.cjs` — fresh-checkout deterministic smoke test against `test-fixture/src/`, diffs against `test-fixture/baselines/phase-13/`
29
+ - `CONTRIBUTING.md` — branch strategy, PR checklist, required checks list, version-bump workflow, baseline relock how-to
30
+ - README badges: CI build status, Node versions (22, 24), plugin version, license (MIT)
31
+ - `test-fixture/baselines/phase-13/` — regression baseline locked at v1.0.7
32
+
33
+ ### Changed
34
+ - Plugin version: 1.0.5 → 1.0.7 (skipping 1.0.6 — Phase 12 did not ship a manifest bump in this worktree)
35
+ - `package.json` gains CI-focused scripts: `lint:md`, `lint:links`, `validate:schemas`, `validate:frontmatter`, `detect:stale-refs`, `scan:injection`, `test:size-budget`, `release:extract-changelog`
36
+ - `ci.yml` matrix preserved exactly: Node 22/24 × ubuntu/macos/windows
37
+
38
+ ---
39
+
40
+ ## [1.0.6] — 2026-04-18
41
+
42
+ ### Added — Phase 12: Test Coverage
43
+ - Test runner wired (`node --test "tests/**/*.cjs"` via `npm test`) — zero third-party test dependencies
44
+ - `tests/helpers.cjs` — shared fixtures: `scaffoldDesignDir`, `readFrontmatter`, `countLines`, `mockMCP`
45
+ - GitHub Actions CI matrix: Node 22/24 × Linux/macOS/Windows, fail-fast disabled
46
+ - Regression baseline harness: `test-fixture/baselines/phase-<N>/` snapshots of agent/skill/connection manifests and agent frontmatter snapshots; drift detector per phase
47
+ - **Agent hygiene tests** — `tests/agent-frontmatter.test.cjs`, `tests/agent-size-budget.test.cjs`, `tests/agent-required-reading-consistency.test.cjs`, `tests/stale-colon-refs.test.cjs`
48
+ - **System contract tests** — `tests/config.test.cjs`, `tests/commands.test.cjs`, `tests/command-count-sync.test.cjs`, `tests/hook-validation.test.cjs`, `tests/atomic-write.test.cjs`, `tests/frontmatter.test.cjs`, `tests/model-profiles.test.cjs`, `tests/verify-health.test.cjs`, `tests/worktree-safety.test.cjs`, `tests/semver-compare.test.cjs`, `tests/schema-drift.test.cjs`
49
+ - **Pipeline + data tests** — `tests/pipeline-smoke.test.cjs`, `tests/mapper-schema.test.cjs`, `tests/parallelism-engine.test.cjs`, `tests/touches-analysis.test.cjs`, `tests/cycle-lifecycle.test.cjs`, `tests/intel-consistency.test.cjs`, `tests/regression-baseline-drift.test.cjs`
50
+ - **Feature correctness tests** — `tests/sketch-determinism.test.cjs`, `tests/connection-probe.test.cjs`, `tests/figma-writer-dry-run.test.cjs`, `tests/reflection-proposal.test.cjs`, `tests/deprecation-redirect.test.cjs`, `tests/nng-coverage.test.cjs`, `tests/read-injection-scanner.test.cjs`, `tests/optimization-layer.test.cjs`
51
+ - `reference/DEPRECATIONS.md` — registry of renamed/split/removed concepts (seeded by deprecation-redirect test)
52
+ - `test-fixture/mapper-outputs/*.json` — locked schema-shape fixtures for the 5 domain mappers
53
+ - Added `XXL` tier (700 lines) to `agent-size-budget.test.cjs` for legitimately long agents (`design-verifier`, `design-context-builder`)
54
+
55
+ ### Changed
56
+ - `package.json` keywords add `"tested"`, `"ci"`; `.claude-plugin/plugin.json` + `marketplace.json` versions bumped to 1.0.6 with matching keyword + description additions
57
+ - `README.md` gains a `## Testing` section describing the suite + CI contract
58
+ - Root `SKILL.md` surfaces `analyze-dependencies`, `extract-learnings`, `skill-manifest` in the command table so `command-count-sync` passes
59
+ - `test-fixture/baselines/phase-6/` manifests re-locked to reflect post-Phase-11 inventory (documented in `phase-6/README.md`)
60
+ - Plugin version: 1.0.5 → 1.0.6
61
+
62
+ ### Policy change
63
+ - **From v1.0.6 forward, every PR MUST pass `npm test` before merging to `main`.** See `CONTRIBUTING.md` for the testing contract.
64
+
65
+ ## [1.0.5] — 2026-04-18
66
+
67
+ ### Added — Phase 11: Self-Improvement
68
+ - `design-reflector` agent — post-cycle reflection from learnings + telemetry + agent-metrics
69
+ - `/gdd:reflect` command — on-demand reflection with `--dry-run` and `--cycle` flags
70
+ - `/gdd:apply-reflections` command — user-review + selective apply for all proposal types
71
+ - Frontmatter feedback loop — reflector proposes `typical-duration-seconds`, `default-tier`, `parallel-safe`, `reads-only` updates from measured data
72
+ - Budget-config feedback loop — reflector proposes `.design/budget.json` cap adjustments from telemetry
73
+ - Reference-update proposer — N≥3 pattern detection across learnings files → `reference/` additions
74
+ - Discussant question-quality logging — answer quality recorded to `.design/learnings/question-quality.jsonl`
75
+ - Discussant question-quality analysis — low-value questions flagged and pruning proposed after ≥3 cycles
76
+ - Global skills layer — `~/.claude/gdd/global-skills/` for cross-project conventions
77
+ - Global skills auto-loading in explore, plan, design stages
78
+ - Phase 11 regression baseline locked in `test-fixture/baselines/phase-11/`
79
+
80
+ ### Changed
81
+ - `/gdd:audit` now spawns `design-reflector` at cycle end when learnings data exists
82
+ - `agents/design-discussant.md` logs answer quality after each Q&A exchange
83
+ - Plugin version: 1.0.4.1 → 1.0.5
84
+
85
+ ## [1.0.4.1] — 2026-04-18 (off-cadence patch, retroactive)
86
+
87
+ **Phase 10.1: Optimization Layer + Cost Governance.** Off-cadence decimal phase — does NOT shift the v1.0.5 / v1.0.6 / v1.0.7 sequence of Phases 11/12/13. `package.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json` remain at their post-Phase-11 versions; the v1.0.4.1 identity lives in this entry, the plugin description, and the baseline directory name.
88
+
89
+ ### Added
90
+ - `gdd-router` skill — intent → `{path: fast|quick|full, model_tier_overrides, estimated_cost_usd, cache_hits}`. First step of every `/gdd:*` command.
91
+ - `gdd-cache-manager` skill + `/gdd:warm-cache` command — maintains `.design/cache-manifest.json`, pre-warms common agent prompts for Anthropic's 5-min prompt cache.
92
+ - `skills/synthesize/` streaming-synthesizer skill — Haiku-collapses N parallel-agent outputs for map / discover / plan orchestrators.
93
+ - `/gdd:optimize` advisory command — reads telemetry + metrics, emits `.design/OPTIMIZE-RECOMMENDATIONS.md`. No auto-apply.
94
+ - `hooks/budget-enforcer.js` — PreToolUse hook on `Agent` spawns. Hard-blocks on cap breach, auto-downgrades at 80% soft-threshold, short-circuits on cache hit. Writes telemetry on every decision.
95
+ - `.design/budget.json` config — `per_task_cap_usd`, `per_phase_cap_usd`, `tier_overrides`, `auto_downgrade_on_cap`, `cache_ttl_seconds`, `enforcement_mode`.
96
+ - `.design/cache-manifest.json` — SHA-256-keyed answer store with TTL.
97
+ - `.design/telemetry/costs.jsonl` — append-only ledger per spawn decision: `{ts, agent, tier, tokens_in, tokens_out, cache_hit, est_cost_usd, cycle, phase}`.
98
+ - `.design/agent-metrics.json` — incremental per-agent aggregator (total_spawns, total_cost_usd, cache_hit_rate, etc). Consumed by Phase 11 reflector.
99
+ - `reference/model-prices.md` — static Anthropic pricing table + `size_budget` → token-range mapping.
100
+ - `reference/model-tiers.md` — tier-selection guide, per-agent tier map, override precedence rules.
101
+ - `reference/shared-preamble.md` — extracted common agent framework preamble. Every agent imports it first.
102
+ - Three lazy gate agents: `design-verifier-gate`, `design-integration-checker-gate`, `design-context-checker-gate`. Cheap Haiku heuristic decides whether to spawn the full expensive checker.
103
+ - `scripts/aggregate-agent-metrics.js` — incremental telemetry aggregator invoked by the hook.
104
+ - Regression baseline at `test-fixture/baselines/phase-10.1/` — methodology README + `pre-baseline-cost-report.md` + `cost-report.md`.
105
+
106
+ ### Changed
107
+ - All 26 agents in `agents/` now carry `default-tier: haiku|sonnet|opus` + `tier-rationale` frontmatter.
108
+ - All 26 agents now open with `@reference/shared-preamble.md` import (cache-aligned ordering per agents/README.md convention).
109
+ - `scripts/bootstrap.sh` writes `.design/budget.json` defaults on first run if missing.
110
+ - `hooks/hooks.json` adds `PreToolUse` matcher `Agent` → `hooks/budget-enforcer.js`.
111
+ - `skills/map/`, `skills/discover/`, `skills/plan/` — parallel-agent outputs now funnel through `skills/synthesize/` before main-context merge.
112
+ - `skills/verify/` — spawns `design-*-gate` agents before their full checker counterparts; skips the full spawn when the gate returns `spawn: false`.
113
+ - `agents/README.md` — documents the `default-tier` + `tier-rationale` frontmatter fields and the cache-aligned agent-prompt ordering convention.
114
+ - `reference/config-schema.md` — new sections for `.design/budget.json`, `.design/cache-manifest.json`, `.design/telemetry/costs.jsonl`, `.design/agent-metrics.json`.
115
+
116
+ ### Performance
117
+ - Target: 50–70% per-task token-cost reduction vs the pre-10.1 baseline on `test-fixture/`.
118
+ - Evidence: `test-fixture/baselines/phase-10.1/pre-baseline-cost-report.md` (pre-layer run) + `cost-report.md` (post-layer run).
119
+ - Gap-count regression check: DESIGN-VERIFICATION.md gap count on the post-layer run must be ≤ pre-layer.
120
+
121
+ ### Notes
122
+ - Requirements OPT-01 through OPT-10 + MAN-10a/b were formally added to `.planning/REQUIREMENTS.md` by plan 01.
123
+ - Phase 11's `design-reflector` (already shipped in v1.0.5) now has the `.design/telemetry/costs.jsonl` + `.design/agent-metrics.json` it was originally designed to read.
124
+
125
+ ---
126
+
127
+ ## [1.0.4] — 2026-04-18
128
+
129
+ ### Added — Phase 10: Knowledge Layer
130
+
131
+ - **Intel store** (`.design/intel/`): queryable JSON slices indexing all files, exports, symbols, tokens, components, patterns, dependencies, decisions, debt, and a cross-reference graph
132
+ - `scripts/build-intel.cjs` — full initial index builder with mtime + git-hash incremental updates
133
+ - `agents/gdd-intel-updater` — incremental intel store updater agent
134
+ - `/gdd:analyze-dependencies` — token fan-out, component call-graph, decision traceability, circular dependency detection (all O(1) from intel store)
135
+ - `/gdd:skill-manifest` — browse all skills and agents from intel store; fallback to directory scan
136
+ - `/gdd:extract-learnings` — extract project-specific patterns from `.design/` artifacts; propose reference/ additions with user review flow
137
+ - `agents/gdd-learnings-extractor` — structured learning entry extractor; writes `.design/learnings/LEARNINGS.md`
138
+ - `agents/gdd-graphify-sync` — feeds Graphify knowledge graph from intel store `graph.json`
139
+ - `hooks/context-exhaustion.js` — PostToolUse hook: auto-records `<paused>` STATE.md block at 85% context
140
+ - `reference/intel-schema.md` — authoritative schema reference for all ten intel slices
141
+ - `design-phase-researcher` — now produces `## Architectural Responsibility Map` and `## Flow Diagram` (Mermaid) in every DESIGN-CONTEXT.md
142
+ - Five core agents (design-context-builder, design-executor, design-verifier, design-phase-researcher, design-planner) now include conditional `@.design/intel/` required-reading blocks
143
+
144
+ ### Changed
145
+
146
+ - Plugin version: 1.0.3 → 1.0.4
147
+ - `hooks/hooks.json`: added context-exhaustion PostToolUse entry (fires on all tools)
148
+
149
+ ---
150
+
151
+ ## [1.0.3] — 2026-04-18
152
+
153
+ ### Added — Phase 9: Claude Design Integration + Pinterest Connection
154
+ - Claude Design handoff bundle adapter: HTML export → D-XX decisions in STATE.md (`connections/claude-design.md`)
155
+ - `/gdd:handoff <path>` standalone command — skips Scan→Discover→Plan, routes direct to verify with Handoff Faithfulness scoring
156
+ - Handoff Faithfulness Phase in design-verifier: color, typography, spacing, component structure scoring with PASS/WARN/FAIL thresholds
157
+ - `--post-handoff` flag for `verify` stage — relaxes DESIGN-PLAN.md prerequisite, activates HF section
158
+ - `--from-handoff` mode for design-discussant — confirms tentative D-XX decisions, fills gaps only
159
+ - Handoff mode for design-research-synthesizer — parses bundle HTML, writes `<handoff_context>` to DESIGN-CONTEXT.md
160
+ - Pinterest MCP connection spec (`connections/pinterest.md`): ToolSearch-only probe, `mcp__mcp-pinterest__pinterest_search`, fallback chain Pinterest → Refero → awesome-design-md
161
+ - Pinterest as visual reference source in design-research-synthesizer (up to 2–3 queries per synthesis)
162
+ - Pinterest probe (block C) in `discover` stage
163
+ - `implementation-status` mode for design-figma-writer — annotates Figma frames with build status + registers Code Connect mappings from Handoff Faithfulness results
164
+ - `pinterest:` and `claude_design:` fields in STATE-TEMPLATE.md `<connections>` block
165
+ - `handoff_source`, `handoff_path`, `skipped_stages` fields in STATE-TEMPLATE.md `<position>` block
166
+
167
+ ### Changed
168
+ - Plugin version: 1.0.2 → 1.0.3
169
+ - connections/connections.md: added Pinterest and Claude Design rows to Active Connections table and Capability Matrix
170
+ - README: updated agent count (14 → 22), added handoff command, Pinterest and Claude Design connection docs
171
+
172
+ ---
173
+
174
+ ## [1.0.2] — Phase 8: Visual + Design-Side Connections + Knowledge Graph
175
+
176
+ ### Added
177
+
178
+ - **Preview (Playwright) connection** — `connections/preview.md`; live page screenshots for `? VISUAL` verification gaps via `mcp__Claude_Preview__*` tools
179
+ - **Storybook connection** — `connections/storybook.md`; HTTP probe for component inventory, a11y per story, `.stories.tsx` stub generation during design stage
180
+ - **Chromatic connection** — `connections/chromatic.md`; CLI-based visual regression delta narration and change-risk scoping using `--trace-changed=expanded`
181
+ - **Figma Writer agent** — `agents/design-figma-writer.md`; write design decisions back to Figma (annotate, tokenize, Code Connect mappings) via remote MCP `use_figma`; proposal→confirm UX with `--dry-run` and `--confirm-shared` guards
182
+ - **Graphify knowledge graph connection** — `connections/graphify.md`; queryable component↔token↔decision graph via `gsd-tools graphify`
183
+ - **`/gdd:figma-write` command** — `skills/figma-write/SKILL.md`; standalone Figma write command
184
+ - **`/gdd:graphify` command** — `skills/graphify/SKILL.md`; build/query/status/diff subcommands
185
+ - **Connections capability matrix expanded** — `connections/connections.md` updated to 7 active connections
186
+ - **Agent pre-search consultation** — `design-integration-checker` and `design-planner` consult the knowledge graph before grep searches when Graphify is available
187
+
188
+ ### Changed
189
+
190
+ - `connections/connections.md` — Active Connections table expanded from 2 to 7; Capability Matrix updated; placeholder rows removed
191
+ - `agents/design-verifier.md` — Phase 4B visual evidence block added; Chromatic delta narration block added
192
+ - `agents/design-planner.md` — Chromatic change-risk scoping block added; Graphify component-count annotation block added
193
+ - `agents/design-context-builder.md` — Storybook component inventory block added
194
+ - `SKILL.md` — argument-hint and Command Reference updated with `figma-write` and `graphify`
195
+ - Root `SKILL.md` — `figma-write` and `graphify` entries added
196
+
197
+ ---
198
+
199
+ ## [1.0.1] — 2026-04-18
200
+
201
+ ### Added — Phase 7: GSD Parity + Exploration
202
+ - Reshaped pipeline to 5-stage canonical shape (brief → explore → plan → design → verify)
203
+ - `/gdd:` namespace for all commands
204
+ - design-discussant agent + `/gdd:discuss` + `/gdd:list-assumptions`
205
+ - 5 specialist mapper agents (token, component-taxonomy, visual-hierarchy, a11y, motion)
206
+ - Wave-native parallelism decision engine
207
+ - Sketch (multi-variant HTML) and Spike (feasibility) explorations — `/gdd:sketch`, `/gdd:sketch-wrap-up`, `/gdd:spike`, `/gdd:spike-wrap-up`
208
+ - Project-local skills layer (`./.claude/skills/design-*-conventions.md`) auto-loaded by explore/plan/design
209
+ - Lifecycle commands: `new-project`, `new-cycle`, `complete-cycle`
210
+ - Ergonomics: `progress`, `health`, `todo`, `stats`, `next`, `help`
211
+ - Capture layer: `note`, `plant-seed`, `add-backlog`, `review-backlog`
212
+ - Safety: `pause`/`resume`, `undo`, `pr-branch`, `ship`
213
+ - Settings + maintenance (`update`, `reapply-patches`)
214
+ - Debug workflow + debugger philosophy
215
+ - Agent hygiene: frontmatter extensions, size budgets, injection scanner
216
+
217
+ ### Changed
218
+ - Plugin version: 1.0.0 → 1.0.1
219
+
220
+ ## [1.0.0] — 2026-04-17
221
+ - Initial release as `get-design-done`.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 hegemonart
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.