amadan
Correct the dsgen claim: it renders rastrillo's vocabulary, not ours
Both files said cmd/dsgen "generates a gallery for any module's own vocabulary". It does not. Its public surface is -out/-mount, and internal/designsystem.Render hardcodes imports of rastrillo's own ui package, so pointed at estilo it would reproduce rastrillo.org's gallery. I put that claim here on good authority and did not check it. The implementer starting estilo checked it, which is why it is being corrected before anything was built on it rather than after. Recorded rather than quietly deleted, because the claim is in circulation and the next person will hear it too. Estilo's gallery is now an open question, and the note says to ask rastrillo for the seam rather than fork the tool — a second generator is the outcome this repo's own rules exist to prevent.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01APtNStXDZ5H2fAc1ZuGqtS
2 files changed,
+19
−12
AGENTS.md+13 −6README.md+6 −6
Intent
diff --git a/AGENTS.md b/AGENTS.md| index 9ceaac3..6422345 100644 |
| --- a/AGENTS.md |
| +++ b/AGENTS.md |
| @@ -141,12 +141,19 @@ Inherited from rastrillo's gates, and not negotiable downward: |
| ## The gallery |
| -**`rastrillo/cmd/dsgen` is public and generates a gallery for any module's |
| -own vocabulary.** Read it before writing anything gallery-shaped. It exists |
| -because 20 MB of generated HTML left the framework repo, and it happens to |
| -be exactly what a variant needs. |
| - |
| -Do not write a second one. |
| +**`rastrillo/cmd/dsgen` does NOT generate a gallery for an arbitrary |
| +module — verified 2026-08-31.** Its public surface is `-out`/`-mount`, and |
| +`internal/designsystem.Render` hardcodes imports of |
| +`github.com/carlosframework/rastrillo/ui`. It renders *rastrillo's own* |
| +vocabulary. Pointed at estilo it would reproduce rastrillo.org's gallery. |
| + |
| +An earlier version of this file claimed the opposite, on good authority |
| +that turned out to be wrong. Recorded rather than quietly deleted, because |
| +the next person will hear the same claim. |
| + |
| +So estilo's gallery is an open question, not a solved one. **Do not build a |
| +second generator on the strength of that** — the right move is probably to |
| +ask rastrillo for the seam rather than to fork the tool. |
| --- |
diff --git a/README.md b/README.md| index adbddb7..a617fef 100644 |
| --- a/README.md |
| +++ b/README.md |
| @@ -42,12 +42,12 @@ two. |
| is a *home* for it, not a contract. See `AGENTS.md`. |
| - **Not a place for app shells.** A spreadsheet's menu bar and formula bar |
| are Sheets'. What lives here is what two apps genuinely share. |
| -- **Not a second gallery generator.** `rastrillo/cmd/dsgen` is public and |
| - generates a gallery for any module's own vocabulary. Use it. |
| -- **Not written in the class vocabulary.** Estilo's components use the |
| - bare-attribute grammar and estilo ships their styling — see `AGENTS.md`. |
| - The "write classes" rule is for apps leaning on rastrillo's CSS, and does |
| - not apply to a library shipping its own. |
| +- **No gallery yet, and `dsgen` will not give us one as it stands.** |
| + `rastrillo/cmd/dsgen` renders rastrillo's own vocabulary — its |
| + `internal/designsystem.Render` hardcodes imports of rastrillo's `ui`, so |
| + it cannot be pointed at another module (verified 2026-08-31; an earlier |
| + claim here said otherwise and was wrong). Ask rastrillo for the seam |
| + before considering anything else. |
| ## Ownership of the first primitives |