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/avinava/document-design-system/agents-mdgit clone --depth 1 https://github.com/Avinava/document-design-systemWhat 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 | $0.00347 | $0.00347 |
| Opus 5 | $0.00173 | $0.00173 |
| Sonnet 5 | $0.00069 | $0.00069 |
| Haiku 4.5 | $0.00035 | $0.00035 |
Grade A, and why
document-design-system 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 yesterday.
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.
What it actually says
Repository guidance
This repository treats document design as two independent axes:
- Document pattern controls reading structure and is declared with
data-pattern. - Theme controls visual voice through semantic tokens and is declared with
data-theme.
Do not reduce the writing examples to one generic longform layout. Select one
of the eight patterns in core/document-patterns.md, then use the modules that
support that reader movement. Keep prose readable at 62–72 characters while
allowing maps, tables, comparisons, timelines, and registers to use the wider
shell.
Markdown in examples/<slug>.md is the canonical repository-friendly form.
Designed HTML is generated from templates/types/<slug>.html; both must use
the same title and factual anchors from examples/WORLD.md.
When changing a writing-document type:
- Keep its
patternanddefault-themefields aligned withscripts/build_examples.py. - Update both Markdown and HTML examples.
- Rebuild with
python3 scripts/build_examples.py. - Regenerate relevant screenshots with
python3 scripts/shoot_examples.py. - Run
python3 -m unittest discover -s tests -v,python3 scripts/validate_repository.py ., andpython3 scripts/build_site.py --check.
GitHub Pages is source-built. Do not hand-edit site/; the workflow rebuilds
examples before assembling the deployable site.
Do not add source-provenance, copied product naming, or private reference links to repository documents, examples, screenshots, commit messages, or release notes. Express the design principle in this repository's own vocabulary.
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.
- yesterday First seen · 37 lines · 347 tokens per session scan A d1bb68cd6800
document-design-system AGENTS.md is an instructions file published in the GitHub repository Avinava/document-design-system (2 stars, last pushed 7d ago), licensed MIT. It adds 347 tokens to every session, about $0.0017 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.
Other instructions, from other repositories
semiotic CLAUDE.md
Instructions for nteract/semiotic, covering semiotic claude code instructions and claude code notes.
starwind-ui AGENTS.md
Instructions for starwind-ui/starwind-ui, covering agents.md, project shape, useful commands and contribution conventions.
Codex-Skills AGENTS.md
Instructions for TheGoat395/Codex-Skills, covering repository operating notes, required checks, evidence rules and change hygiene.
ACCESSIBILITY.md AGENTS.md
Instructions for mgifford/ACCESSIBILITY.md, covering repository instructions for ai coding agents, scope, when each instruction file is useful, project mission and status and required project context.
barkeep AGENTS.md
Instructions for iannuttall/barkeep, covering agent notes, product rules, repo map, commands and app structure.
SidewalkWebpage css.instructions.md
Instructions for ProjectSidewalk/SidewalkWebpage: --text- font shorthands (font: var(--text-body-regular);) — not raw --font- plus hand-picked size/weight. Flag hardcoded hex colors or hand-assembled font stacks where a token fits.