wind CLAUDE.md

Project instructions for Wind UI, a Flutter styling system that turns Tailwind-style class strings into Flutter widgets.

In plain words
What is it for?
Use them when changing Wind UI code, documentation, tests, generated inventories, or other linked project surfaces.
Why use it?
They define the checks required before a change is considered finished and explain which project surfaces must be kept in sync.

Instructions file

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.

agentmods
npx agentmods add instructions/fluttersdk/wind/claude-md
Clone the repo
git clone --depth 1 https://github.com/fluttersdk/wind
Per session 2,552 This file is loaded in full into every session.
When invoked 2,552 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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 $0.02552 $0.02552
Opus 5 $0.01276 $0.01276
Sonnet 5 $0.00510 $0.00510
Haiku 4.5 $0.00255 $0.00255

Measured 2d ago against content hash af22bb3fbf39, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

wind CLAUDE.md 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 2d 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.

CLAUDE.md · 102 lines

How it starts

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

Wind UI

Utility-first Flutter styling. Translates Tailwind-syntax className strings into Flutter widget trees through a modular parsing pipeline.

Stack: Flutter >=3.27.0 · Dart >=3.4.0 · Runtime deps: flutter_svg, fluttersdk_wind_diagnostics_contracts. No mockito, no state management library, no router. Branch: master is the active 1.x stable line (formerly v1). The legacy v0 line lives on the v0 branch.

For architecture / internals, see ARCHITECTURE.md. For the user-facing surface, see README.md. For the LLM-agent inventory, see llms.txt.

Definition of done

A code change is not finished until ALL of these hold for the touched scope. The agent self-checks before reporting work complete:

  1. dart analyze reports zero issues, zero warnings on the touched files.
  2. dart format . produces no diff.
  3. flutter test reports zero failures (pre-existing skips noted, never new).
  4. ./tool/coverage.sh 90 exits 0 — total line coverage stays at or above 90%. If the change drops coverage, add tests in the same change set, do not lower the threshold.
  5. Every code change triggers the post-change sync below — skipping any of the four sub-surfaces is not optional.

The PostToolUse hooks in .claude/settings.json auto-run format + analyze after .dart edits, so steps 1-2 are mostly automatic in the edit loop. CI re-runs all four gates on push; they are not negotiable there.

Post-change sync (five surfaces, every code change)

When source under lib/ changes, the agent updates each of these in the same change set, BEFORE reporting the work done. Each surface has its own format and acceptance criterion — comply with all five; skipping is a bug.

1. doc/ — the user-facing markdown reference.

  • New or changed widget / parser / token / theme field: locate the matching file under doc/widgets/, doc/layout/, doc/styling/, etc. Format details live in .claude/rules/docs.md.
  • New widget: create doc/widgets/<w-name>.md mirroring the format of the nearest neighbor file (one # title, ToC, <x-preview> tag, Props table with Required/default/description columns, Constructor signature, Styling Examples, Related Documentation).
  • Removed surface: delete the doc file or mark deprecated; never leave a stale doc pointing at a removed API.
  • Acceptance: python3 tool/check-docs.py exits 0. It enforces the whole doc contract: one H1 per page and it is the opening line, relative .md targets, fragments, ToC-reachable anchors, <x-preview source> matching a real example/lib/pages/ file (sync surface #2 below), and <x-preview path> matching a route registered in example/lib/routes.dart.

Read the full file on GitHub · 102 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. 2d ago First seen · 102 lines · 2,552 tokens per session scan A af22bb3fbf39

Subscribe to this mod's changes

wind CLAUDE.md is an instructions file published in the GitHub repository fluttersdk/wind (33 stars, last pushed 2d ago), licensed MIT. It adds 2,552 tokens to every session, about $0.0128 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-30.

Related

Other instructions, from other repositories

edge AGENTS.md

Instructions for OpenStrap/edge, covering agents.md — openstrap edge, 1. what this is, 3. hard invariants — violating these is a p0 regression, 4. recurring bug patterns — what actually ships broken here and 4.3 sticky boolean latches never reset on the failure path.

OpenStrap/edge · 4,019 tokens

mobile CLAUDE.md

Claude Code instructions for lichess-org/mobile, covering claude.md, project overview, development setup, initial setup and install dependencies.

lichess-org/mobile · 4,362 tokens

dart_agent_core AGENTS.md

Instructions for memex-lab/dart_agent_core, covering agents.md, common commands, transcript viewer cli (reads eval traces), two public libraries and architecture (big picture).

memex-lab/dart_agent_core · 1,450 tokens

sanad-agent AGENTS.md

Instructions for EastStarAI/sanad-agent, covering sanad agent repository contract, 1. documentation hierarchy, rules for ai agents and developers, 1.1. the strict separation pact and 1.2. the living project wiki & incremental documentation.

EastStarAI/sanad-agent · 3,115 tokens

dart-sdk-skills AGENTS.md

Instructions for RandalSchwartz/dart-sdk-skills, covering ai agent developer handbook (agents.md), 🎯 repository purpose, 🔄 runbook 1: updating for new dart sdk releases, 🔄 runbook 2: updating for new flutter framework releases and 📏 quality & style guidelines.

RandalSchwartz/dart-sdk-skills · 736 tokens

dart-expert-skills copilot-instructions.md

Instructions for Poorgramer-Zack/dart-expert-skills, covering flutter skills repository - copilot instructions, repository overview, architecture, directory structure and skill structure.

Poorgramer-Zack/dart-expert-skills · 2,008 tokens