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.
npx agentmods add instructions/tsubotax/melta-ui/agents-mdgit clone --depth 1 https://github.com/tsubotax/melta-uiWrote 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.
[](https://agentmods.dev/instructions/tsubotax/melta-ui/agents-md)<a href="https://agentmods.dev/instructions/tsubotax/melta-ui/agents-md"><img src="https://agentmods.dev/badge/instructions/tsubotax/melta-ui/agents-md.svg" alt="Measured on agentmods" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.02481 | $0.02481 |
| Opus 5 | $0.01241 | $0.01241 |
| Sonnet 5 | $0.00496 | $0.00496 |
| Haiku 4.5 | $0.00248 | $0.00248 |
Grade A, and why
melta-ui AGENTS.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 6d 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.
How it starts
The opening of the file, as written. The whole thing — 144 lines — stays where its author put it; the contents beside it link to each section on GitHub.
melta UI — AI エージェント作業ガイド
AI coding agents(Claude Code / Codex / Cursor / Gemini CLI 等)共通の作業指示 SSOT。 デザイン仕様は
DESIGN.md、exact value はdesign/contracts/を参照。 Claude Code 固有の挙動(PostToolUse hook / MCP 自動接続 / skills)はCLAUDE.md。
アーキテクチャ概要
この DS は 3 層構造(AI-Ready 2.0)で運用されている。
- Layer 1: 憲法 —
DESIGN.mdが AI 向け入口。原則 + Quick Reference。これだけで基本 UI を生成可能 - Layer 2: 仕様 —
design/contracts/に 40 contract(web 28 + app 先行 12)+ 106 禁止ルール + 101 トークンの JSON 仕様。これが SSOT - Layer 3: 検証 —
scripts/design/の harness が Schema 整合・drift・a11y を自動検証。CI + hook で守る
詳細:
design/authority.md(SSOT 宣言・値競合時の優先順位)、README.md(全体構造)
最初に読むファイル
| 目的 | ファイル |
|---|---|
| デザイン仕様(Quick Ref 含む) | DESIGN.md |
| 作業手順 | AGENTS.md(本ファイル) |
| SSOT 宣言 | design/authority.md |
| loop / pipeline 自動化の統治原則 | docs/melta-loop-playbook.md |
読み込みモード
| モード | 読むファイル | 概算トークン | 用途 |
|---|---|---|---|
| クイック | DESIGN.md のみ |
~4k | 単体UIの生成(ボタン、カード等) |
| 標準 | + foundations/theme.md + 関連 component md or contract |
~10k | ページ単位の生成 |
| MCP | MCP ツール(get_token / get_component / check_rule / check_html / get_rules / search) |
必要分のみ | AI ツール統合。生成後は check_html で自己検証 |
| フル | 全ファイル(下記の読み順に従う) | ~150k | 新規プロジェクト構築・DS変更 |
フル読み順: DESIGN.md → foundations/design_philosophy.md → foundations/theme.md → foundations/ → components/ or design/contracts/components/ → patterns/ → design/contracts/rules.json
作業ルール
- UI タスク開始時に
DESIGN.mdを読む - exact value が必要なら
design/contracts/を参照する - コンポーネント仕様は
*.contract.jsonを優先(なければcomponents/*.md→metadata/components.json) - 禁止ルールの SSOT は
design/contracts/rules.json(106 ルール) - finish 前に
npm run design:checkとnpm run design:lint-generated -- <生成ファイル>を走らせる - generated file(
metadata/components.json、llms.txt/llms-full.txt、design/contracts/recipes/web/)を直接編集しない →npm run design:buildで再生成 - 新しい component を作る場合、まず
design/contracts/components/に contract を書く - loop / pipeline / CI 自動修復を扱う場合は
docs/melta-loop-playbook.mdを読む。SSOT write、baseline 緩和、test 弱体化、publish/deploy は human gate - recipes の2層規約:
recipes/web/= 契約から生成される導出ミラー(編集禁止)/recipes/app/= RN styleRefs の手書き authoring source。app recipe の値は{"token": "<tokens.json ノードパス>"}か literal(色の hex 直書き禁止)。variants / sizes / states のキーは契約の部分集合(語彙の発明はdesign:checkが error)。契約を変えたらdesign:compat(npm 公開版との互換ゲート)が semver bump を要求する
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.
- 6d ago First seen · 144 lines · 2,481 tokens per session scan A dc922b1fac6e
melta-ui AGENTS.md is an instructions file published in the GitHub repository tsubotax/melta-ui (196 stars, last pushed today), licensed MIT. It adds 2,481 tokens to every session, about $0.0124 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.
Other instructions, from other repositories
spark-web AGENTS.md
AGENTS.md instructions for leboncoin/spark-web, covering agents.md, general guidelines for working with nx, scaffolding & generators and when to use nxdocs.
balsa-ui AGENTS.md
Instructions for pedrobalsa/balsa-ui, a project described as: Agent-native, open-code Vue/React components with independent palettes, themes, and gradient backgrounds.
decantr CLAUDE.md
Instructions for decantr-ai/decantr, covering claude.md -- decantr, project, packages, apps and terminology.
vibe-to-ui AGENTS.md
Instructions for MonkeyUI-dev/vibe-to-ui, covering agents.md, cursor cloud specific instructions, user design context vs skill package, validating changes (the closest analog to test/lint here) and reuse must not append another decision entry.
ui-ux-design-pro-skill CLAUDE.md
Instructions for saifyxpro/ui-ux-design-pro-skill, covering project overview, cli commands, full design system generation (markdown output), search across all databases (sub-50ms) and audit ui code quality.
sdd-starter CLAUDE.md
Claude Code instructions for KazukiShinomiya/sdd-starter, covering claude.md, 共有文脈(全エージェント共通), このプロジェクトの核(変更時に守る) and claude 固有の運用指針.