Design Source of Truth — canonical set + Paper↔repo contract
:::note Contenido en inglés Esta página del wiki se sincroniza desde la base de conocimiento en inglés y todavía no está traducida. :::
canonical· designer · updated 2026-06-28 · source
The design source spans the Paper file (01KS9HJRSXFAP5FART7R5Y07CM, "TUEMPRESA.DIGITAL")
and the knowledge/ docs. This doc is the map: which Paper page is canonical per concern,
where the written spec lives, and the contract that keeps them in sync. It exists because the
file had accumulated stale/duplicate versions (v1, NOT_UPDATED) that made "which is current?"
tribal knowledge.
Governance (applies to Paper too, #340)
Same rule as the knowledge base: if it's the canonical page, it's current; superseded versions
are deleted — git/Paper history is the archive. A page name states its concern, never its
version. No v1 beside a current page; no "NOT_UPDATED" labels — delete instead.
Canonical Paper page set
| Page | id | Concern | Written SoT (knowledge/) |
|---|---|---|---|
| Cover | 1-0 | File entry / brand cover | — |
| Aurea Brand | 4-0 | Brand kit (cover, genesis, wordmark, usage, colors) | brand.md, brand-tone.md, brand/icons/, brand/avatars/ |
| Brand · Avatars | 7-1 | Avatar export assets | brand/avatars/avatar-style.md |
| Grid System v2 | 9-0 | Grid foundation (13-slide deck → G1–G20) | grid-system.md + .claude/rules/grid-system.md |
| Admin · Design System & Screens | 3-0 | Admin design system + all screen artboards (the hub) | admin-design-system.md, admin-tone.md |
| Admin · Widgets (Grid v2) | A-0 | Widget-interior gallery for grid cells | (fold into admin-ui-conventions.md) |
| Admin · Data Tables | B-0 | Data-table spec + states | admin-ui-conventions.md (component inventory) |
| IA · Screen Map | D-0 | Screen catalog — 3 surfaces, 6 roles, access matrix | tedos-portal-screen-map.md |
| IA · Sitemap | E-0 | Navigation/flow diagram | tedos-portal-screen-map.md |
| Landing Page (Marketing) | 6-0 | Marketing surface (separate palette/voice) | sources/marketing-site-reference-benaios.md |
Frozen (paused, keep, do not treat as current): Desktop App 2-0 (apps/desktop paused
2026-06-09) — paired written specs tedos-design-system.md + tedos-screens.md are now
historical (they describe this paused desktop surface, not the web admin).
The Paper↔repo contract
handoffs/screen-map.json is the load-bearing bridge: it pins pageId: 3-0 and maps every admin
screen → Paper node id → repo route → content-sync status. 3-0 is the screen hub by contract —
any consolidation that moves or regenerates 3-0 artboards must keep node ids stable or update
screen-map.json in lockstep, or the Paper-as-source-of-truth handoff breaks. The
kit-design-validate.mjs gate enforces taxonomy integrity over this file.
Superseded — removed / to remove
| Item | id | Why | Action |
|---|---|---|---|
| Design System (NOT_UPDATED) | page 5-0 | Old admin style guide, self-flagged; superseded by 3-0 | delete (manual, Paper) |
| MVP Screens v1 | page C-0 | Old single-surface CRM screens; superseded by D-0 + 3-0 | delete (manual, Paper) |
| Sidebars por rol | page F-0 | Empty stub (0 artboards); concern covered by 3-0 Nav + E-0 | delete (manual, Paper) |
| C-Uso 2 · Agente (detalle) | artboard OIH-0 on E-0 | Stray gen-C leftover | delete |
Paper MCP can delete artboards/nodes and screenshot, but cannot delete or rename whole pages — page deletes/renames (5-0, C-0, F-0, plus the clarity renames: 3-0 → "Admin · Design System & Screens", 2-0 → "Desktop App (PAUSED)", A-0/B-0/D-0/E-0) are a manual step in Paper.
File-wide cleanup (pending)
- Font purge: every page still lists
Space Grotesk+JetBrains Monoalongside Geist. Geist is the official font (2026-06-17) — purge the old families file-wide (start with the 9-0 Typography slide + the A-0 handoff note).grid-system.mdG20 corrected to Geist in the critique PR. - Widget demo copy (A-0) still uses CRM framing (Leads/Deals/HubSpot) — refresh to the 3-surface framing; cosmetic, low priority.
Written homes (the design cluster)
This doc is the design hub — the written SoT per concern lives in:
- System + screens: admin-design-system.md · admin-tone.md
- Grid + principles: grid-system.md · design-principles.md
- Brand: brand.md · brand-tone.md · brand/icons/icon-style.md · brand/avatars/avatar-style.md
- IA / screen map: tedos-portal-screen-map.md
- Operator console: console-design.md
- Marketing surface: marketing-site-reference-benaios.md
- Paused desktop (historical): tedos-design-system.md · tedos-screens.md