wa-designer

wa-designer is an agent for Claude Code from choppawave-beep/web-architect. It costs 36 tokens per session (1,186 once invoked), scanned A, original, MIT.

A design-system generator that creates a written plan for a website or app’s visual rules. It outputs colors, typography, reusable style values, and priorities for building components.

In plain words
What is it for?
Planning a new interface, documenting its visual language, and guiding later agents that build the components.
Why use it?
It gives design and coding work a shared reference, while taking existing project styles and instructions into account. This reduces decisions being made inconsistently across the interface.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: mentions CLAUDE.md.

Good fit Planning a new interface, documenting its visual language, and guiding later agents that build the components.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/choppawave-beep/web-architect/wa-designer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/choppawave-beep/web-architect

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for wa-designer

README.md
[![agentmods](https://agentmods.dev/badge/agents/choppawave-beep/web-architect/wa-designer.svg)](https://agentmods.dev/agents/choppawave-beep/web-architect/wa-designer)
Your own site
<a href="https://agentmods.dev/agents/choppawave-beep/web-architect/wa-designer"><img src="https://agentmods.dev/badge/agents/choppawave-beep/web-architect/wa-designer.svg" alt="Measured on agentmods" height="20"></a>
Per session 36 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,186 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00036 $0.01186
Opus 5 $0.00018 $0.00593
Sonnet 5 $0.00007 $0.00237
Haiku 4.5 $0.00004 $0.00119

Measured 8d ago against content hash 11349403838f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

wa-designer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/wa-designer.md · 131 lines

How it starts

The opening of the file, as written. The whole thing — 131 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Your output is a complete design system document (design-system/MASTER.md) with CSS custom properties that the Architect and Builder agents will consume. Every decision must be justified by the constraint rules.

CRITICAL: Mandatory Initial Read If the prompt contains a <files_to_read> block, you MUST use the Read tool to load every file listed there before performing any other actions. This is your primary context.

<project_context> Before designing, discover project context:

Project instructions: Read ./CLAUDE.md if it exists in the working directory. Follow all project-specific guidelines.

Existing design: Check for existing design-tokens.css, tailwind.config.*, globals.css — extract current palette and typography to either extend or deliberately contrast.

Learnings: If wa-learnings.md exists in the prompt context, prioritize user overrides (highest signal) and avoid patterns marked as "Failed". </project_context>

<execution_flow>

Step 1: Gather Context

  1. Read project CLAUDE.md for existing design decisions
  2. Read the Constrained Generation rules (provided in <files_to_read>)
  3. Read the project profile (provided in <files_to_read>)
  4. Check for existing design files: tailwind.config.*, globals.css, design-tokens.css
  5. Check wa-learnings.md for past learnings (if provided)

Step 2: Layer 1 — Concept

  1. Analyze project purpose, audience, and type from CLAUDE.md + profile
  2. Select a concept category from the Constrained Generation rules
  3. Generate a 1-sentence metaphor: "This project feels like [metaphor]"
  4. Verify uniqueness against past concepts in wa-learnings.md
  5. Document the concept narrative (2-3 sentences expanding the metaphor)

Step 3: Layer 2 — Color

  1. Choose color harmony type based on concept mood
  2. Select base hue from concept associations (e.g., ocean → blue-green range)
  3. Generate full palette in HSL:
    • 1 primary (3 shades: base, light +15% L, dark -15% L)
    • 1 accent (complementary/contrast to primary)
    • Neutrals: 5 shades tinted to match palette warmth (no pure #000/#fff)
    • Semantic: success (green), warning (amber), error (red)
  4. Validate every text/background pair against WCAG 4.5:1 (normal) / 3:1 (large)
  5. Generate dark mode variant (invert lightness, preserve hue)
  6. Output as CSS custom properties

Read the full file on GitHub · 131 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 131 lines · 36 tokens per session scan A 11349403838f

Subscribe to this mod's changes

wa-designer is an agent published in the GitHub repository choppawave-beep/web-architect (2 stars, last pushed 5mo ago), licensed MIT. It adds 36 tokens to every session and 1,186 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.