geneseed 4.28.0 → 4.30.0

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 (145) hide show
  1. package/CHANGELOG.md +58 -0
  2. package/README.md +4 -2
  3. package/SHIPPED.md +2 -2
  4. package/adapters/bob/README.md +1 -1
  5. package/adapters/claude-code/README.md +4 -2
  6. package/adapters/opencode/HOW-OPENCODE-LOADS.md +2 -2
  7. package/adapters/opencode/README.md +18 -2
  8. package/adapters/opencode/plugins/geneseed-activity.js +22 -20
  9. package/adapters/opencode/plugins/geneseed-context.js +155 -18
  10. package/adapters/opencode/plugins/geneseed-guard.js +59 -8
  11. package/adapters/opencode/plugins/geneseed-workflow.js +18 -1
  12. package/adapters/opencode/workflows/_runtime.js +14 -3
  13. package/docs/concepts/enforcement-table.md +5 -4
  14. package/docs/concepts/exclusions.md +3 -3
  15. package/docs/concepts/hooks.md +12 -4
  16. package/docs/concepts/ownership.md +9 -8
  17. package/docs/concepts/skills.md +1 -0
  18. package/docs/guides/set-up-ownership.md +22 -6
  19. package/docs/reference/environment.md +1 -0
  20. package/docs/reference/plugin-activity.md +1 -1
  21. package/docs/reference/plugin-context.md +3 -1
  22. package/docs/reference/plugin-guard.md +1 -1
  23. package/docs/understand/enforced-vs-asked.md +3 -3
  24. package/docs/understand/machine-bob.md +1 -1
  25. package/docs/understand/machine-claude.md +1 -1
  26. package/docs/understand/machine-opencode.md +1 -1
  27. package/harness.config.json +1 -1
  28. package/js/README.md +3 -1
  29. package/js/build/driver.mjs +29 -9
  30. package/js/build/emit-opencode.mjs +12 -10
  31. package/js/build/render.mjs +9 -0
  32. package/js/hosts/done-checks.mjs +134 -0
  33. package/js/hosts/geneseed-dir.mjs +116 -0
  34. package/js/hosts/hooks-context.mjs +19 -0
  35. package/js/hosts/hooks-done.mjs +82 -38
  36. package/js/hosts/hooks-learn.mjs +9 -2
  37. package/js/hosts/hooks-prims.mjs +4 -0
  38. package/js/hosts/hooks.mjs +139 -6
  39. package/js/hosts/hosts.mjs +6 -0
  40. package/js/hosts/native.mjs +1 -1
  41. package/js/hosts/owned.mjs +19 -0
  42. package/js/hosts/ownership-gate.mjs +64 -10
  43. package/js/hosts/settings.mjs +115 -74
  44. package/js/inspect/checks-constitution.mjs +5 -1
  45. package/js/inspect/cost.mjs +1 -1
  46. package/js/inspect/doctor.mjs +2 -1
  47. package/js/inspect/inventory.mjs +1 -1
  48. package/js/inspect/status.mjs +2 -1
  49. package/js/inspect/validate.mjs +2 -1
  50. package/js/lib/json.mjs +70 -0
  51. package/js/maintain/uninstall.mjs +18 -5
  52. package/js/web/gates-api.mjs +2 -2
  53. package/package.json +1 -1
  54. package/registry.json +14 -0
  55. package/src/AGENT.md.tmpl +2 -2
  56. package/src/licenses/i-have-adhd.txt +21 -0
  57. package/src/skills/_checkpoints.md +28 -5
  58. package/src/skills/adhd.md +40 -0
  59. package/src/skills/diagram-design/LICENSE +21 -0
  60. package/src/skills/diagram-design/SKILL.md +392 -0
  61. package/src/skills/diagram-design/THIRD_PARTY_LICENSES.md +134 -0
  62. package/src/skills/diagram-design/VENDOR.md +81 -0
  63. package/src/skills/diagram-design/assets/example-architecture.html +183 -0
  64. package/src/skills/diagram-design/assets/example-venn.html +110 -0
  65. package/src/skills/diagram-design/assets/template-dark.html +99 -0
  66. package/src/skills/diagram-design/assets/template-full.html +421 -0
  67. package/src/skills/diagram-design/assets/template-motion.html +448 -0
  68. package/src/skills/diagram-design/assets/template-terminal.html +188 -0
  69. package/src/skills/diagram-design/assets/template.html +100 -0
  70. package/src/skills/diagram-design/references/animation.md +135 -0
  71. package/src/skills/diagram-design/references/layout-budget.md +97 -0
  72. package/src/skills/diagram-design/references/onboarding.md +368 -0
  73. package/src/skills/diagram-design/references/output-spec.md +277 -0
  74. package/src/skills/diagram-design/references/primitive-annotation.md +36 -0
  75. package/src/skills/diagram-design/references/primitive-icons.md +782 -0
  76. package/src/skills/diagram-design/references/primitive-sketchy.md +43 -0
  77. package/src/skills/diagram-design/references/primitive-terminal.md +76 -0
  78. package/src/skills/diagram-design/references/primitives-core.md +144 -0
  79. package/src/skills/diagram-design/references/profiles.md +183 -0
  80. package/src/skills/diagram-design/references/semantic-patterns.md +154 -0
  81. package/src/skills/diagram-design/references/style-guide.md +232 -0
  82. package/src/skills/diagram-design/references/type-architecture-delta.md +143 -0
  83. package/src/skills/diagram-design/references/type-architecture.md +117 -0
  84. package/src/skills/diagram-design/references/type-axonometric-plan.md +83 -0
  85. package/src/skills/diagram-design/references/type-bar.md +108 -0
  86. package/src/skills/diagram-design/references/type-data-flow.md +371 -0
  87. package/src/skills/diagram-design/references/type-db-schema.md +48 -0
  88. package/src/skills/diagram-design/references/type-dependency.md +44 -0
  89. package/src/skills/diagram-design/references/type-deployment.md +45 -0
  90. package/src/skills/diagram-design/references/type-dp-integration.md +407 -0
  91. package/src/skills/diagram-design/references/type-dp-security-matrix.md +379 -0
  92. package/src/skills/diagram-design/references/type-er.md +25 -0
  93. package/src/skills/diagram-design/references/type-exploded.md +115 -0
  94. package/src/skills/diagram-design/references/type-fishbone.md +75 -0
  95. package/src/skills/diagram-design/references/type-flowchart.md +23 -0
  96. package/src/skills/diagram-design/references/type-gantt.md +45 -0
  97. package/src/skills/diagram-design/references/type-heatmap.md +80 -0
  98. package/src/skills/diagram-design/references/type-high-level.md +470 -0
  99. package/src/skills/diagram-design/references/type-it-state.md +468 -0
  100. package/src/skills/diagram-design/references/type-journey.md +55 -0
  101. package/src/skills/diagram-design/references/type-kanban.md +49 -0
  102. package/src/skills/diagram-design/references/type-layers.md +26 -0
  103. package/src/skills/diagram-design/references/type-line.md +337 -0
  104. package/src/skills/diagram-design/references/type-loop.md +223 -0
  105. package/src/skills/diagram-design/references/type-medallion.md +356 -0
  106. package/src/skills/diagram-design/references/type-nested.md +22 -0
  107. package/src/skills/diagram-design/references/type-org-chart.md +44 -0
  108. package/src/skills/diagram-design/references/type-polar.md +136 -0
  109. package/src/skills/diagram-design/references/type-process.md +490 -0
  110. package/src/skills/diagram-design/references/type-pyramid.md +33 -0
  111. package/src/skills/diagram-design/references/type-quadrant.md +81 -0
  112. package/src/skills/diagram-design/references/type-radar.md +82 -0
  113. package/src/skills/diagram-design/references/type-sankey.md +75 -0
  114. package/src/skills/diagram-design/references/type-scatter.md +276 -0
  115. package/src/skills/diagram-design/references/type-sequence.md +130 -0
  116. package/src/skills/diagram-design/references/type-service-blueprint.md +103 -0
  117. package/src/skills/diagram-design/references/type-state.md +30 -0
  118. package/src/skills/diagram-design/references/type-story-map.md +46 -0
  119. package/src/skills/diagram-design/references/type-swimlane.md +22 -0
  120. package/src/skills/diagram-design/references/type-timeline.md +20 -0
  121. package/src/skills/diagram-design/references/type-tree.md +24 -0
  122. package/src/skills/diagram-design/references/type-treemap.md +137 -0
  123. package/src/skills/diagram-design/references/type-uml-class.md +65 -0
  124. package/src/skills/diagram-design/references/type-venn.md +26 -0
  125. package/src/skills/diagram-design/references/type-wardley.md +39 -0
  126. package/src/skills/diagram-design/references/type-waterfall.md +75 -0
  127. package/src/skills/document-project.md +4 -1
  128. package/src/skills/learn-mode.md +11 -11
  129. package/src/skills/ownership.md +41 -18
  130. package/src/upstreams.json +14 -0
  131. package/themes/_TEMPLATE.json +1 -0
  132. package/themes/biker.json +1 -0
  133. package/themes/commentator.json +1 -0
  134. package/themes/cyberpunk.json +1 -0
  135. package/themes/gamer.json +1 -0
  136. package/themes/imperial.json +1 -0
  137. package/themes/joker.json +1 -0
  138. package/themes/marvin.json +1 -0
  139. package/themes/mean.json +1 -0
  140. package/themes/military.json +1 -0
  141. package/themes/neutral.json +1 -0
  142. package/themes/pirate.json +1 -0
  143. package/themes/sports.json +1 -0
  144. package/themes/verstappen.json +1 -0
  145. package/themes/wizard.json +1 -0
@@ -0,0 +1,81 @@
1
+ # Vendored skill — diagram-design
2
+
3
+ This folder is a third-party skill vendored into Geneseed, not a Geneseed-authored skill. It
4
+ rides along in the rendered bundle and is exempt from Geneseed's authoring gates (token,
5
+ dead-link, hermeticity, skill counts) — it is listed in the generator's `VENDORED_SKILL_DIRS`.
6
+
7
+ - **Upstream key:** diagram-design (repo, pinned commit, author and licence: `src/upstreams.json`)
8
+ - **Credit:** {{CREDIT:diagram-design:skills/diagram-design}}
9
+
10
+ The licence (MIT) is in `LICENSE`, copied from upstream's root `LICENSE` at the pinned commit.
11
+ `THIRD_PARTY_LICENSES.md` is upstream's notice file. `references/primitive-icons.md` embeds Tabler
12
+ (MIT), Simple Icons (CC0), log-z/logos (MIT) and Devicon (MIT: `spss-plain`, `rstudio-plain`)
13
+ artwork, and that file names each source and its licence. Geneseed appended one section to it: the
14
+ full MIT texts, with their copyright lines, of Tabler, log-z/logos and Devicon, fetched from each
15
+ repository's `LICENSE` on its default branch on 2026-10-29 (upstream only linked to them). Some paths
16
+ the notice names (`scripts/vendor/`, `assets/logo.svg`, `assets/icons.html`) are not vendored, and
17
+ its "one-off sourced icons" (SAS, Stata) were removed, see below.
18
+
19
+ The skill follows the [Agent Skills](https://agentskills.io/) format (`SKILL.md` + `references/`
20
+ + `assets/`). The first-run style-guide gate (SKILL.md §0) is upstream's and is kept as is.
21
+
22
+ ## What was trimmed
23
+
24
+ Upstream's `skills/diagram-design/` is about 5.9 MB. This copy keeps about 0.8 MB:
25
+
26
+ - **Kept:** `SKILL.md`; every `references/*.md` except the six below; the five
27
+ `assets/template*.html` files (§10 tells the agent to copy them); two examples,
28
+ `assets/example-venn.html` and `assets/example-architecture.html`.
29
+ - **Dropped:** `scripts/` (six Python helpers — Geneseed carries no Python at runtime); the other
30
+ ~218 `assets/example-*.html` files and `assets/icons.html` (a gallery of the icons
31
+ `references/primitive-icons.md` already holds); `references/export.md` and
32
+ `references/export-registry.md` (the Python/Playwright export helpers); `references/doctor.md`
33
+ (Python and host-plugin diagnostics); `references/import-drawio.md`,
34
+ `references/import-mermaid.md` and `references/import-excalidraw.md` (built around the
35
+ Python extractors). Upstream's repository files (plugin manifests, `commands/`, `prompts/`,
36
+ `docs/`, the repository-level `scripts/verify-*.py`) were never part of the skill folder.
37
+
38
+ SKILL.md §10 and some references still name `example-<type>.html` files and `assets/icons.html` in
39
+ code spans; those files are not shipped. Many type references name upstream's repository-level
40
+ verifiers (`scripts/verify-*.py`) in prose; those are not shipped either.
41
+
42
+ ## Modifications
43
+
44
+ Each one removes a dependency on a dropped file. Re-apply them on update.
45
+
46
+ - `SKILL.md` §6: the icon bullet no longer links the `assets/icons.html` gallery; rule 6 no longer
47
+ tells the agent to run the geometry verifier.
48
+ - `SKILL.md` §9: the geometry-verifier and motion-verifier runs are cut; the `self_check.py` item
49
+ is now a check by hand of the same five properties.
50
+ - `SKILL.md` §11: the route-by-source links to the three import references are replaced by the
51
+ list of source formats, and step 1 reads the source file as text instead of running an extractor.
52
+ - `SKILL.md` §12: the "Exporting to PNG / SVG" body is replaced by one paragraph: this copy ships no
53
+ export helpers, so an `.svg` is the `<svg>` node copied out of the `.html`, and a `.png` cannot be
54
+ made.
55
+ - `SKILL.md` frontmatter: the description says "HTML/SVG" where upstream says "HTML/SVG/PNG".
56
+ - `SKILL.md` §10: the Consultant-special row points at `type-quadrant.md` instead of the dropped
57
+ `example-quadrant-consultant.html`.
58
+ - `SKILL.md` §11: the Format dial marks `png` and `html+png` as not available.
59
+ - `references/primitive-icons.md`: five marks are removed — `hop`, `pentaho`, `dagster`, `sas`,
60
+ `stata`. Upstream sourced them by direct fetch and marked each "verify license before use".
61
+ - `references/output-spec.md`: the format table, the destination table and the checklist mark
62
+ `png` / `html+png` as not available; the label-width check measures in the browser instead of
63
+ running upstream's geometry verifier.
64
+ - `references/onboarding.md`: the `/regenerate-examples` flow is marked as not shipped.
65
+ - `THIRD_PARTY_LICENSES.md`: the licence-text section is appended (see above).
66
+ - `references/animation.md`: the three-command verifier block is replaced by "check these by hand".
67
+ - `references/output-spec.md`: two links to `export.md` are removed; the render-linter
68
+ command is named as upstream's and not shipped.
69
+ - `references/primitives-core.md`: three geometry-verifier commands are cut.
70
+ - `references/style-guide.md`: the export/self-check commands become "check that the Google Fonts
71
+ link is no longer present".
72
+ - `references/type-architecture-delta.md`: the verifier commands are named as upstream's and not
73
+ shipped.
74
+ - `references/type-treemap.md`: the render-linter command is named as upstream's and not shipped.
75
+
76
+ Every Markdown link left in the folder resolves inside it. No Python invocation remains (the
77
+ repository's no-Python gates scan `src/`).
78
+
79
+ To update, re-copy the kept files from upstream's `skills/diagram-design/`, re-apply the
80
+ modifications above, check that no new file needs a script, and bump the entry's `commit` in
81
+ `src/upstreams.json`.
@@ -0,0 +1,183 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Content site · Architecture</title>
7
+ <link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet">
8
+ <style>
9
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
10
+ :root {
11
+ --color-paper: #f5f5f5;
12
+ --color-ink: #2d3142;
13
+ --color-muted: #4f5d75;
14
+ --color-accent: #bf4520;
15
+ --font-sans: 'Geist', system-ui, sans-serif;
16
+ --font-serif: 'Instrument Serif', serif;
17
+ --font-mono: 'Geist Mono', ui-monospace, monospace;
18
+ }
19
+
20
+ body {
21
+ font-family: var(--font-sans);
22
+ background: var(--color-paper);
23
+ color: var(--color-ink);
24
+ min-height: 100vh;
25
+ display: flex;
26
+ align-items: center;
27
+ justify-content: center;
28
+ padding: 3rem 2rem;
29
+ }
30
+
31
+ .frame { max-width: 1200px; width: 100%; }
32
+
33
+ .eyebrow {
34
+ font-family: var(--font-mono);
35
+ font-size: 0.66rem;
36
+ font-weight: 500;
37
+ letter-spacing: 0.18em;
38
+ text-transform: uppercase;
39
+ color: var(--color-muted);
40
+ margin-bottom: 0.5rem;
41
+ }
42
+
43
+ h1 {
44
+ font-family: var(--font-serif);
45
+ font-size: clamp(1.5rem, 2.4vw + 0.75rem, 2rem);
46
+ font-weight: 400;
47
+ letter-spacing: -0.02em;
48
+ line-height: 1.15;
49
+ color: var(--color-ink);
50
+ margin-bottom: 1.5rem;
51
+ }
52
+
53
+ svg { width: 100%; min-width: 900px; display: block; }
54
+ </style>
55
+ </head>
56
+ <body>
57
+ <div class="frame">
58
+ <p class="eyebrow">Architecture · Diagram Design</p>
59
+ <h1>Content site in production</h1>
60
+
61
+ <svg viewBox="0 0 1000 480" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="architecture-title architecture-desc">
62
+ <title id="architecture-title">Content site in production</title>
63
+ <desc id="architecture-desc">Architecture diagram showing reader requests moving through Cloudflare to an Astro origin, MDX bundle, and content CMS.</desc>
64
+ <defs>
65
+ <pattern id="dots" width="22" height="22" patternUnits="userSpaceOnUse">
66
+ <circle cx="1" cy="1" r="0.9" fill="rgba(45,49,66,0.10)"/>
67
+ </pattern>
68
+ <marker id="arrow" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto"><polygon points="0 0, 8 3, 0 6" fill="#4f5d75"/></marker>
69
+ <marker id="arrow-accent" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto"><polygon points="0 0, 8 3, 0 6" fill="#bf4520"/></marker>
70
+ <marker id="arrow-link" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto"><polygon points="0 0, 8 3, 0 6" fill="#2e5aa8"/></marker>
71
+ </defs>
72
+
73
+ <rect width="100%" height="100%" fill="#f5f5f5"/>
74
+ <rect width="100%" height="100%" fill="url(#dots)" opacity="0.55"/>
75
+
76
+ <!-- Zone: Content services (drawn before arrows and nodes) -->
77
+ <rect x="616" y="128" width="164" height="272" rx="8"
78
+ fill="rgba(45,49,66,0.02)" stroke="rgba(45,49,66,0.10)" stroke-width="0.8"/>
79
+ <rect x="672" y="132" width="52" height="12" rx="2" fill="#f5f5f5"/>
80
+ <text x="698" y="141" fill="rgba(45,49,66,0.40)" font-size="7" font-family="'Geist Mono', monospace"
81
+ text-anchor="middle" letter-spacing="0.14em">CONTENT</text>
82
+
83
+ <!-- Arrows first (behind boxes) -->
84
+ <line x1="168" y1="272" x2="220" y2="272" stroke="#2e5aa8" stroke-width="1.2" marker-end="url(#arrow-link)"/>
85
+ <line x1="364" y1="272" x2="416" y2="272" stroke="#bf4520" stroke-width="1.4" marker-end="url(#arrow-accent)"/>
86
+ <!-- Two fanned ports on Astro's right edge, each turning once into MDX bottom / CMS top -->
87
+ <path d="M 576,260 H 692 Q 700,260 700,252 V 224"
88
+ fill="none" stroke="#4f5d75" stroke-width="1.2" marker-end="url(#arrow)"/>
89
+ <path d="M 576,284 H 692 Q 700,284 700,292 V 320"
90
+ fill="none" stroke="#4f5d75" stroke-width="1.2" marker-end="url(#arrow)"/>
91
+
92
+ <!-- Dashed return: Cloudflare→Reader (cached HTML — same orthogonal rules as solid) -->
93
+ <path d="M 220,288 H 168" fill="none" stroke="#4f5d75" stroke-width="1" stroke-dasharray="4,3" marker-end="url(#arrow)"/>
94
+
95
+ <!-- Arrow labels -->
96
+ <rect x="172" y="252" width="48" height="12" rx="2" fill="#f5f5f5"/>
97
+ <text x="196" y="262" fill="#2e5aa8" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">HTTPS</text>
98
+
99
+ <rect x="172" y="278" width="32" height="12" rx="2" fill="#f5f5f5"/>
100
+ <text x="188" y="287" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">RESP</text>
101
+
102
+ <rect x="368" y="252" width="48" height="12" rx="2" fill="#f5f5f5"/>
103
+ <text x="392" y="262" fill="#bf4520" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">SSR</text>
104
+
105
+ <rect x="632" y="240" width="60" height="12" rx="2" fill="#f5f5f5"/>
106
+ <text x="662" y="249" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">READ MDX</text>
107
+
108
+ <rect x="632" y="292" width="44" height="12" rx="2" fill="#f5f5f5"/>
109
+ <text x="654" y="301" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">QUERY</text>
110
+
111
+ <!-- Node: Reader -->
112
+ <rect x="40" y="240" width="128" height="64" rx="6" fill="#f5f5f5"/>
113
+ <rect x="40" y="240" width="128" height="64" rx="6" fill="rgba(79,93,117,0.10)" stroke="#5a6580" stroke-width="1"/>
114
+ <rect x="48" y="248" width="28" height="12" rx="2" fill="transparent" stroke="rgba(90,101,128,0.40)" stroke-width="0.8"/>
115
+ <text x="62" y="257" fill="#5a6580" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EXT</text>
116
+ <text x="104" y="276" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Reader</text>
117
+ <text x="104" y="292" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Browser</text>
118
+
119
+ <!-- Node: Cloudflare -->
120
+ <rect x="220" y="240" width="144" height="64" rx="6" fill="#f5f5f5"/>
121
+ <rect x="220" y="240" width="144" height="64" rx="6" fill="rgba(45,49,66,0.03)" stroke="rgba(45,49,66,0.30)" stroke-width="1"/>
122
+ <rect x="228" y="248" width="32" height="12" rx="2" fill="transparent" stroke="rgba(45,49,66,0.22)" stroke-width="0.8"/>
123
+ <text x="244" y="257" fill="#5a6580" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EDGE</text>
124
+ <text x="356" y="300" fill="rgba(45,49,66,0.06)" font-size="32" font-weight="600" font-family="'Geist Mono', monospace" text-anchor="end">01</text>
125
+ <text x="292" y="276" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Cloudflare</text>
126
+ <text x="292" y="292" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Pages · cache</text>
127
+
128
+ <!-- Node: Astro (focal coral) -->
129
+ <rect x="416" y="240" width="160" height="64" rx="6" fill="#f5f5f5"/>
130
+ <rect x="416" y="240" width="160" height="64" rx="6" fill="rgba(191,69,32,0.08)" stroke="#bf4520" stroke-width="1"/>
131
+ <rect x="424" y="248" width="32" height="12" rx="2" fill="transparent" stroke="rgba(191,69,32,0.50)" stroke-width="0.8"/>
132
+ <text x="440" y="257" fill="#bf4520" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">ORIG</text>
133
+ <text x="568" y="300" fill="rgba(191,69,32,0.10)" font-size="32" font-weight="600" font-family="'Geist Mono', monospace" text-anchor="end">02</text>
134
+ <text x="496" y="276" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Astro Origin</text>
135
+ <text x="496" y="292" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">SSR + MDX</text>
136
+
137
+ <!-- Node: MDX Bundle -->
138
+ <rect x="628" y="160" width="144" height="64" rx="6" fill="#f5f5f5"/>
139
+ <rect x="628" y="160" width="144" height="64" rx="6" fill="#ffffff" stroke="#2d3142" stroke-width="1"/>
140
+ <rect x="636" y="168" width="32" height="12" rx="2" fill="transparent" stroke="rgba(45,49,66,0.40)" stroke-width="0.8"/>
141
+ <text x="652" y="177" fill="#2d3142" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">BUN</text>
142
+ <text x="700" y="196" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">MDX Bundle</text>
143
+ <text x="700" y="212" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">src/content/*.mdx</text>
144
+
145
+ <!-- Node: Content CMS -->
146
+ <rect x="628" y="320" width="144" height="64" rx="6" fill="#f5f5f5"/>
147
+ <rect x="628" y="320" width="144" height="64" rx="6" fill="rgba(45,49,66,0.05)" stroke="#4f5d75" stroke-width="1"/>
148
+ <rect x="636" y="328" width="28" height="12" rx="2" fill="transparent" stroke="rgba(79,93,117,0.50)" stroke-width="0.8"/>
149
+ <text x="650" y="337" fill="#4f5d75" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">CMS</text>
150
+ <text x="700" y="356" fill="#2d3142" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Content CMS</text>
151
+ <text x="700" y="372" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">assets · og images</text>
152
+
153
+ <!-- Legend strip -->
154
+ <line x1="40" y1="404" x2="960" y2="404" stroke="rgba(45,49,66,0.10)" stroke-width="0.8"/>
155
+ <text x="40" y="420" fill="#4f5d75" font-size="8" font-family="'Geist Mono', monospace" letter-spacing="0.18em">LEGEND</text>
156
+
157
+ <rect x="40" y="436" width="14" height="10" rx="2" fill="rgba(191,69,32,0.08)" stroke="#bf4520" stroke-width="1"/>
158
+ <text x="60" y="444" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Focal / origin</text>
159
+
160
+ <rect x="180" y="436" width="14" height="10" rx="2" fill="#ffffff" stroke="#2d3142" stroke-width="1"/>
161
+ <text x="200" y="444" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Backend / bundle</text>
162
+
163
+ <rect x="340" y="436" width="14" height="10" rx="2" fill="rgba(45,49,66,0.05)" stroke="#4f5d75" stroke-width="1"/>
164
+ <text x="360" y="444" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Store</text>
165
+
166
+ <rect x="436" y="436" width="14" height="10" rx="2" fill="rgba(45,49,66,0.03)" stroke="rgba(45,49,66,0.30)" stroke-width="1"/>
167
+ <text x="456" y="444" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Cloud</text>
168
+
169
+ <rect x="528" y="436" width="14" height="10" rx="2" fill="rgba(79,93,117,0.10)" stroke="#5a6580" stroke-width="1"/>
170
+ <text x="548" y="444" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">External</text>
171
+
172
+ <line x1="636" y1="442" x2="664" y2="442" stroke="#2e5aa8" stroke-width="1.2" marker-end="url(#arrow-link)"/>
173
+ <text x="672" y="444" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">HTTP request</text>
174
+
175
+ <line x1="784" y1="442" x2="812" y2="442" stroke="#bf4520" stroke-width="1.4" marker-end="url(#arrow-accent)"/>
176
+ <text x="820" y="444" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Primary flow</text>
177
+
178
+ <line x1="900" y1="442" x2="928" y2="442" stroke="#4f5d75" stroke-width="1" stroke-dasharray="4,3" marker-end="url(#arrow)"/>
179
+ <text x="936" y="444" fill="#4f5d75" font-size="8.5" font-family="'Geist', sans-serif">Return / async</text>
180
+ </svg>
181
+ </div>
182
+ </body>
183
+ </html>
@@ -0,0 +1,110 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Good design · Desirable × Feasible × Viable</title>
7
+ <link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet">
8
+ <style>
9
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
10
+ :root {
11
+ --color-paper: #f5f5f5;
12
+ --color-ink: #2d3142;
13
+ --color-muted: #4f5d75;
14
+ --color-accent: #bf4520;
15
+ --font-sans: 'Geist', system-ui, sans-serif;
16
+ --font-serif: 'Instrument Serif', serif;
17
+ --font-mono: 'Geist Mono', ui-monospace, monospace;
18
+ }
19
+
20
+ body {
21
+ font-family: var(--font-sans);
22
+ background: var(--color-paper);
23
+ color: var(--color-ink);
24
+ min-height: 100vh;
25
+ display: flex;
26
+ align-items: center;
27
+ justify-content: center;
28
+ padding: 3rem 2rem;
29
+ }
30
+
31
+ .frame { max-width: 1200px; width: 100%; }
32
+
33
+ .eyebrow {
34
+ font-family: var(--font-mono);
35
+ font-size: 0.66rem;
36
+ font-weight: 500;
37
+ letter-spacing: 0.18em;
38
+ text-transform: uppercase;
39
+ color: var(--color-muted);
40
+ margin-bottom: 0.5rem;
41
+ }
42
+
43
+ h1 {
44
+ font-family: var(--font-serif);
45
+ font-size: clamp(1.5rem, 2.4vw + 0.75rem, 2rem);
46
+ font-weight: 400;
47
+ letter-spacing: -0.02em;
48
+ line-height: 1.15;
49
+ color: var(--color-ink);
50
+ margin-bottom: 1.5rem;
51
+ }
52
+
53
+ svg { width: 100%; min-width: 900px; display: block; }
54
+ </style>
55
+ </head>
56
+ <body>
57
+ <div class="frame">
58
+ <p class="eyebrow">Venn · Diagram Design</p>
59
+ <h1>Good design · Desirable × Feasible × Viable</h1>
60
+
61
+ <svg viewBox="0 0 1000 480" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="venn-title venn-desc">
62
+ <title id="venn-title">Good design · Desirable × Feasible × Viable</title>
63
+ <desc id="venn-desc">Venn diagram showing desirable, feasible, and viable product qualities intersecting at shippable.</desc>
64
+ <defs>
65
+ <!-- Chained clips isolate the all-three intersection: clip to Desirable, then to Feasible, then fill via the third circle. -->
66
+ <clipPath id="clip-desirable">
67
+ <circle cx="500" cy="180" r="140"/>
68
+ </clipPath>
69
+ <clipPath id="clip-feasible">
70
+ <circle cx="428" cy="320" r="140"/>
71
+ </clipPath>
72
+ </defs>
73
+
74
+ <rect width="100%" height="100%" fill="#f5f5f5"/>
75
+
76
+ <!-- Three set circles (stroke + very-low-opacity tint; tints compound in overlaps) -->
77
+ <!-- Desirable — top, ink -->
78
+ <circle cx="500" cy="180" r="140" fill="rgba(45,49,66,0.04)" stroke="#2d3142" stroke-width="1"/>
79
+ <!-- Feasible — bottom-left, muted -->
80
+ <circle cx="428" cy="320" r="140" fill="rgba(79,93,117,0.05)" stroke="#4f5d75" stroke-width="1"/>
81
+ <!-- Viable — bottom-right, soft -->
82
+ <circle cx="572" cy="320" r="140" fill="rgba(90,101,128,0.05)" stroke="#5a6580" stroke-width="1"/>
83
+
84
+ <!-- Focal: solid-ink triple intersection (dark fill for white text to read against) -->
85
+ <g clip-path="url(#clip-desirable)">
86
+ <g clip-path="url(#clip-feasible)">
87
+ <circle cx="572" cy="320" r="140" fill="#2d3142"/>
88
+ </g>
89
+ </g>
90
+
91
+ <!-- Set labels — positioned INSIDE each circle's non-overlapping lobe, so the diagram reads like a classic Venn -->
92
+ <!-- Desirable — top lobe (centered inside top of Desirable circle) -->
93
+ <text x="500" y="96" fill="#2d3142" font-size="14" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Desirable</text>
94
+ <text x="500" y="112" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.14em">PEOPLE WANT IT</text>
95
+
96
+ <!-- Feasible — bottom-left lobe -->
97
+ <text x="340" y="386" fill="#2d3142" font-size="14" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Feasible</text>
98
+ <text x="340" y="402" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.14em">WE CAN BUILD IT</text>
99
+
100
+ <!-- Viable — bottom-right lobe -->
101
+ <text x="660" y="386" fill="#2d3142" font-size="14" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Viable</text>
102
+ <text x="660" y="402" fill="#4f5d75" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.14em">BUSINESS SUSTAINS</text>
103
+
104
+ <!-- Focal label: white text on the dark intersection -->
105
+ <text x="500" y="268" fill="#ffffff" font-size="14" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Shippable</text>
106
+ <text x="500" y="284" fill="rgba(245,245,245,0.75)" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.14em">THE SWEET SPOT</text>
107
+ </svg>
108
+ </div>
109
+ </body>
110
+ </html>
@@ -0,0 +1,99 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Diagram</title>
7
+ <link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&family=Noto+Serif:ital@0;1&family=Noto+Sans+KR:wght@400;500;600&family=Noto+Serif+KR:wght@400&family=Noto+Sans+TC:wght@400;500;600&family=Noto+Serif+TC:wght@400&display=swap" rel="stylesheet">
8
+ <style>
9
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
10
+ :root {
11
+ --color-paper: #2d3142; /* deep warm charcoal */
12
+ --color-ink: #f5f5f5; /* warm off-white */
13
+ --color-muted: #bfc0c0;
14
+ --color-accent: #f08a59;
15
+ --font-sans: 'Geist', system-ui, sans-serif;
16
+ --font-serif: 'Instrument Serif', 'Noto Serif', 'Noto Serif KR', serif;
17
+ --font-mono: 'Geist Mono', ui-monospace, monospace;
18
+ }
19
+
20
+ body {
21
+ font-family: var(--font-sans);
22
+ background: var(--color-paper);
23
+ color: var(--color-ink);
24
+ min-height: 100vh;
25
+ display: flex;
26
+ align-items: center;
27
+ justify-content: center;
28
+ padding: 3rem 2rem;
29
+ }
30
+
31
+ .frame { max-width: 1200px; width: 100%; }
32
+ /* The SVG holds its readable width (min-width == the viewBox width, so the
33
+ type ramp is never silently scaled down). This wrapper lets a narrow
34
+ screen scroll the diagram instead of the whole page. */
35
+ .diagram-container { width: 100%; overflow-x: auto; }
36
+
37
+ .eyebrow {
38
+ font-family: var(--font-mono);
39
+ font-size: 0.66rem;
40
+ font-weight: 500;
41
+ letter-spacing: 0.18em;
42
+ text-transform: uppercase;
43
+ color: var(--color-muted);
44
+ margin-bottom: 0.5rem;
45
+ }
46
+
47
+ h1 {
48
+ font-family: var(--font-serif);
49
+ font-size: clamp(1.5rem, 2.4vw + 0.75rem, 2rem);
50
+ font-weight: 400;
51
+ letter-spacing: -0.02em;
52
+ line-height: 1.15;
53
+ color: var(--color-ink);
54
+ margin-bottom: 1.5rem;
55
+ }
56
+
57
+ svg { width: 100%; min-width: 1000px; display: block; }
58
+ /* Paper has no scrollbar, so the local scroller would clip instead of
59
+ scroll. Let the diagram scale down to the sheet: smaller but whole
60
+ beats sharp but cut off. Must come after the svg rule above - a media
61
+ query adds no specificity, so a later plain rule would win. */
62
+ @media print {
63
+ .diagram-container { overflow-x: visible; }
64
+ svg { min-width: 0; }
65
+ }
66
+ </style>
67
+ </head>
68
+ <body>
69
+ <div class="frame">
70
+ <p class="eyebrow">[Type] · Diagram Design</p>
71
+ <h1>[Diagram title]</h1>
72
+
73
+ <!-- Replace [diagram-slug] with a unique slug for this diagram before export. -->
74
+ <div class="diagram-container">
75
+ <svg viewBox="0 0 1000 600" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="[diagram-slug]-title [diagram-slug]-desc">
76
+ <title id="[diagram-slug]-title">[Diagram title]</title>
77
+ <desc id="[diagram-slug]-desc">[One sentence describing what the diagram shows]</desc>
78
+ <defs>
79
+ <marker id="arrow" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto"><polygon points="0 0, 8 3, 0 6" fill="#bfc0c0"/></marker>
80
+ <marker id="arrow-accent" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto"><polygon points="0 0, 8 3, 0 6" fill="#f08a59"/></marker>
81
+ <marker id="arrow-link" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto"><polygon points="0 0, 8 3, 0 6" fill="#739fdf"/></marker>
82
+
83
+ <!-- OPTIONAL: dot-pattern background. Uncomment and add <rect fill="url(#dots)"/> after the paper rect to enable. -->
84
+ <!--
85
+ <pattern id="dots" width="22" height="22" patternUnits="userSpaceOnUse">
86
+ <circle cx="1" cy="1" r="0.9" fill="rgba(245,245,245,0.08)"/>
87
+ </pattern>
88
+ -->
89
+ </defs>
90
+
91
+ <rect width="100%" height="100%" fill="#2d3142"/>
92
+
93
+ <!-- Draw arrows first, then nodes. Replace with your content. -->
94
+
95
+ </svg>
96
+ </div>
97
+ </div>
98
+ </body>
99
+ </html>