@adres/ai-dls-blueprint

Overlay Adresx DLS-aware AI skills and the dls-mcp server onto any project, so AI coding assistants generate UI that uses the real Design Language System — real components, tokens, and brand themes — instead of inventing lookalikes.

This is a workflow layer, not an app skeleton. Scaffold your app first (create-next-app, Vite, etc.), then run the installer on top.

Run it

# from a clone
npm install
npm start          # interactive installer (tsx index.ts)

# or, once published
npx @adres/ai-dls-blueprint

The installer asks four things: which AI clients, how to reach the MCP server (hosted HTTP or local stdio), a default brand/theme, and whether to commit the blueprint files or gitignore them.

What it installs

• Skills (single source in templates/skills/) stamped into each selected client:
  • Claude Code → .claude/skills/ (invoke /dls-screen), plus CLAUDE.md
  • Cursor → .cursor/skills/ (invoke by name), plus .cursor/mcp.json
  • Codex / Copilot → .agents/skills/ (invoke $dls-screen), plus AGENTS.md
• Rules — .dls/dls-rules.md, the five non-negotiable DLS rules every UI change follows.
• MCP config — the adresx-dls server wired into each client's config format.

Skills

• dls-setup — pick the default brand/theme and confirm MCP connectivity
• dls-screen — build a screen/feature from real DLS components
• dls-component — add or replace one component with its correct contract
• dls-prototype — Figma link, brief, or PRD/use-case bundle → real DLS project scaffold (with a review gate before commit)
• dls-review — read-only check of code for DLS drift
• dls-doctor — read-only blueprint health check

Architecture

Each skill is authored once under templates/skills/<name>/SKILL.md. The installer copies that single source into whichever client folders you pick, so the adapters never drift. To add or change a skill, edit the template and re-run the installer.

Security

The HTTP transport authenticates with a Bearer token read from $DLS_MCP_TOKEN. The installer never writes the token into config — set it in your environment. Do not commit tokens.