Web Tanstackstart Design Direction

Archived: 2026-11-07 · roadmap-id: web-design-system

Why

No human ever set the direction. TheFoolAI's lean-flowkit Web has no PRODUCT.md, and the impeccable skill's init never ran, so brand, style, and color were improvised in code. The owner's ruling (thefoolai PRD dp-web-design-system W4): after initialization and before any real requirement, the agent must hold a design discussion with the owner — product brand, UI, UX, color system — and settle the Web's design norms.
The shared rules were overwritten. The template's DESIGN.md held both the shared design rules and the project's own contract; an agent rewrote it wholesale for its product and every shared rule disappeared without any check noticing.
The environment premise is obsolete. DESIGN.md, AGENTS.md, and LLM.md still say the Web is "embedded in the App's right-hand panel (~380px)" with touch "rare" and an "enterprise internal" feel. The owner corrected this (W5): these Webs have a mobile App, mobile is a primary surface, and the package Web is the main surface of the desktop App.
Skills are not discovered. Codex discovers <dir>/.agents/skills from the repository root to the working directory; Claude Code discovers .claude/skills. Neither reads apps/web/.github/skills or the domain-packages template's .agent/skills (spike Q2, from the Codex skills documentation and source and the Claude Code skills documentation).

Running the discussion for any existing project (thefoolai PRD rows 5–6 do it for lean-flowkit).
The build-domain-package-skill stage in thefoolai (its row 4).
The web-tanstackstart-kids template.
Custom Astryx themes beyond the one brand theme each project creates.