The component & design-token baseline for human and agentic developers (spacing, typography, theme, etc)
Les mainteneurs répondent en général sous 2 jours
@IanoNjuguna y travaille déjà.
Depuis le 15/9/2026.
Évaluation
Cette issue n'a pas encore été évaluée.
Description
Discussed in https://github.com/IntersectMBO/developer-experience/discussions/299
Originally posted by IanoNjuguna September 14, 2026
A design-token baseline translates human visual decisions into machine-readable data structures (such as JSON or W3C format). Human developers visually interpret design specs, whereas agentic AI developers require programmatic constraints to prevent hardcoding arbitrary values and pixel padding, or fragmented font hierarchies.
Implementation Guideline
This entails shipping design skills for AI agents, and a brand assets page for human developers. Context:
-
CSS Variable Export: Transform tokens into CSS Custom Properties (e.g., --space-md, --color-text-primary) using tools like Style Dictionary so both human and agentic developers consume a single source of truth. -
Agent Context Injection: Provide the token taxonomy as a system prompt, MCP tool, or skill file. Instruct AI agents to fail generation if arbitrary values are output instead of semantic variables.
Why a Shared Baseline Matters
-
Eliminates AI Hallucinations: Agentic developers evaluate hard constraints better than open-ended style guidelines. Named tokens enforce guardrails (e.g., forcing the agent to use space.md instead of guessing padding is 13px). -
Enforces Deterministic UI Rules: Enables automated programmatic checks (e.g., CI/CD linters, AST checks, Model Context Protocol servers) to validate generated code against a token schema. -
Simplifies Multi-Theme Architecture: Decouples raw values (primitives) from intent (semantics), allowing humans and agents to update light/dark/brand themes without modifying component code.
Three-Tier Token Architecture
-
Primitive Tokens (Option Layer): Raw visual values. Never referenced directly inside UI code. -
Semantic Tokens (Intent Layer): Defines the meaning or purpose of a value. Used by human and agentic coders. -
Component Tokens (Scope Layer): Specific overrides for single-purpose components (e.g.,button.primary.bg).
- Langage dominant
- TypeScript
- Étoiles
- 13
- Forks
- 24
- Merge moyen
- 1 j 19 h
- PR mergées (30 j)
- 18
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de IntersectMBO/developer-experience
-
documentation
Difficulté 2/5 1-3 heures Accessibilité débutants 90/100
IntersectMBO/developer-experience#363 ·
Les mainteneurs répondent en général sous 2 jours
-
documentation
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
IntersectMBO/developer-experience#362 ·
Les mainteneurs répondent en général sous 2 jours
-
documentation
Difficulté 2/5 1-3 heures Accessibilité débutants 90/100
IntersectMBO/developer-experience#360 ·
Les mainteneurs répondent en général sous 2 jours
-
Verify session: UI and Smart Contract Interaction (Q2 2026, 16-ui-smart-contract-interaction)Ouvertedocumentation
Difficulté 2/5 1-3 heures Accessibilité débutants 92/100
IntersectMBO/developer-experience#359 ·
Les mainteneurs répondent en général sous 2 jours
-
Verify session: dApp Architecture from Wallet to Backend (Q2 2026, 15-dapp-architecture-demo)Ouvertedocumentation
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
IntersectMBO/developer-experience#358 ·
Les mainteneurs répondent en général sous 2 jours
Toutes les issues de IntersectMBO/developer-experience
Issues similaires
-
area: infrastructure bug priority: low
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
snapotter-hq/SnapOtter#4575 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
Les mainteneurs répondent en général sous 1 jour
-
documentation server-memory v2
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
modelcontextprotocol/servers#5457 ·
Les mainteneurs répondent en général sous 1 jour
-
comp: ssr comp: zones type: feature version: current (v17+)
Difficulté 2/5 1-3 heures Accessibilité débutants 84/100
angular/angularfire#3836 ·
Les mainteneurs répondent en général sous 3 jours
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
Les mainteneurs répondent en général sous 1 jour