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/dsswift/ion/agents-mdgit clone --depth 1 https://github.com/dsswift/ionWhat 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.21531 | $0.21531 |
| Opus 5 | $0.10766 | $0.10766 |
| Sonnet 5 | $0.04306 | $0.04306 |
| Haiku 4.5 | $0.02153 | $0.02153 |
Grade C, and why
ion AGENTS.md scanned grade C with 1 finding 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.
Recursive force deletehighDestructive command
rm -rf with a variable or a broad path is one typo away from removing the wrong tree.
**To rebuild from scratch, run `make graph`.** It moves the existing graph aside, re-extracts, and restores the old one if extraction fails — no manual `rm -rf` needed, and a failed rebuild never leaves the clone with no How it starts
The opening of the file, as written. The whole thing — 895 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Ion
Layout
| Component | Path | Language |
|---|---|---|
| Engine | engine/ |
Go |
| Desktop | desktop/ |
TypeScript (Electron + React) |
| Relay | relay/ |
Go |
| iOS | ios/IonRemote/ |
Swift |
Engine, desktop, and iOS each have their own AGENTS.md with subsystem-specific rules.
SDK edits have a source-of-truth split (repo source vs. build-overwritten installed copy) — moved to engine/AGENTS.md § "Extension SDK source location". Read it before changing any file under engine/extensions/sdk/ion-sdk/ or touching ~/.ion/extensions/sdk/.
File-size caps (CI hard-fails above)
| Language | Cap |
|---|---|
| TypeScript / TSX | 600 |
Go (*.go) |
800 |
Go (*_test.go) |
1500 |
| Swift | 600 |
Override: // @file-size-exception: <reason> (# for shell/yaml/python) on line 1. Existing god files allowlisted in .file-size-allowlist.yml — do not extend them; extract new code to a new file.
When a file exceeds the cap
Split the file — find the natural seams (logical groupings, hook boundaries, helper clusters) and extract to a new file. Never remove or collapse comments, collapse whitespace, or shorten code to hit the line limit. Comments are load-bearing documentation. If the choice is between a well-commented file that is 10 lines over cap and a stripped file that is under cap, the stripped version is worse. Split instead.
Cohesion of change: a feature lives in one folder. Full reference: docs/architecture/file-organization.md.
Context files
AGENTS.mdis canonical and committed.CLAUDE.mdis a local-only symlink to siblingAGENTS.md. Gitignored. Created bymake bootstrap(or directly viamake claude-symlinks).- Do not seed per-bounded-context
AGENTS.md. Defer until traces show confusion. - Before any work that touches
engine/, readdocs/engine-grounding.md. It is the non-negotiable framing for engine changes — contract stability, snapshot semantics, engine-vs-harness boundaries, and the "modifying the engine is restricted" default. Engine work without this grounding is a defect.
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.
- 2d ago First seen · 895 lines · 21,531 tokens per session scan C 1726b6e357ab
ion AGENTS.md is an instructions file published in the GitHub repository dsswift/ion (4 stars, last pushed 2d ago), licensed MIT. It adds 21,531 tokens to every session, about $0.1077 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
DashClaw CLAUDE.md
Instructions for ucsandman/DashClaw, covering dashclaw (v2 governance runtime), commands, verify before you commit, gotchas (what you can't infer from the code) and governance boundary.
DashClaw AGENTS.md
Instructions for ucsandman/DashClaw, covering tooling note, design context, gitnexus — code intelligence, always do and never do.
DashClaw copilot-instructions.md
Instructions for ucsandman/DashClaw, covering dashclaw — github copilot instructions, design context, users, brand personality and aesthetic direction.
DashClaw GEMINI.md
Instructions for ucsandman/DashClaw, covering dashclaw development context, project overview, core product primitives, guard and action records.
Jixu AGENTS.md
Instructions for joe960913/Jixu, covering jixu repository instructions, 1. read order, 2. sources of truth, 3. canonical concepts and 4. architecture invariants.
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).