What is aontu AGENTS.md?

A repository guide for Aontu, a JSON structure unifier with matching TypeScript and Go implementations. It explains the code layout, shared tests, and rules for keeping both versions consistent.

Use it when modifying Aontu, especially its TypeScript or Go code, shared test cases, build setup, or documentation. It helps with building, testing, checking coverage, and adding new behavior.

It helps coding agents avoid changing only one implementation or adding behavior without tests. It also points to the decisions and commands that define how the project is maintained.

How aontu-lang/aontu configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to aontu-lang/aontu. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/aontu-lang/aontu/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/aontu-lang/aontu

Made for: Codex, OpenCode.

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/aontu-lang/aontu/agents-md/github.svg)](https://agentmods.dev/instructions/aontu-lang/aontu/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/aontu-lang/aontu/agents-md"><img src="https://agentmods.dev/badge/instructions/aontu-lang/aontu/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/aontu-lang/aontu/agents-md"><img src="https://agentmods.dev/badge/instructions/aontu-lang/aontu/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 2,231 This file is loaded in full into every session.

When invoked 2,231 The same file — it is already loaded in full.

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.

Model	Per session	Once invoked
Fable 5.1	$0.02231	$0.02231
Opus 5.5	$0.00892	$0.00892
Sonnet 5.5	$0.00446	$0.00446
Haiku 4.5	$0.00223	$0.00223

Measured 4d ago against content hash 14756184bd3d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

aontu 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 4d 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.md · 159 lines

How it starts

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

aontu — agent & contributor guide

aontu is a JSON structure unifier (a purpose-specific dialect inspired by CUE). This repository ships two implementations kept in parity: TypeScript in ts/ — the canonical one — and Go in go/, a port that mirrors its semantics.

Three decisions govern everything below and are recorded in ADR.md: ADR-001 (the two implementations stay at full parity, proved by the shared spec), ADR-002 (coverage stays at 100 % in both, with every exclusion justified in the source), and ADR-003 (where a host subsystem supplies semantics, aontu defines the meaning and rewrites the input rather than trusting the host). Read those before proposing a change that touches one implementation only, that adds code no test reaches, or that hands a value to a host library to interpret.

This file is an index, capped at 1200 words and gated by ts/test/agents-guide.test.ts. Detail belongs in the pages below; add it there, not here.

Where the detail lives

Page	What it carries
DEV-PROCESS.md	how work is done: the prompt log, testing, docs, comments, `sketch/`, `admin/` — read first
contributing/testing.md	the shared `test/spec/*.tsv` suite and its modes, the generated-copy generators (`sig`, `helpdoc`, `aontu`), adding a behaviour, the parity probe, the vet ≡ eval differential, the JSON Schema suite, the divergence ledger
contributing/parity.md	what the Go port covers, why the `@tabnas` pins are exact, the numeric tower
contributing/conventions.md	comments, what a document is for, module vs package, site attribution, provenance, colour, the mutation caveat
contributing/capability-review.md	the progress register and its same-commit rule
STYLE-GUIDE.md	how documentation is written — normative, read before editing any page
docs/shared-spec.md	the shared TSV format
docs/release-and-tag.md	releasing and tagging, including without `gh`
DIVERGENCE.md	permanent TS/Go non-parity
docs/trust.md · docs/lsp.md · docs/index.md	the trust contract · the language server · the documentation set

Read the full file on GitHub · 159 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.

4d ago Changed · +2 lines · +13 tokens per session 14756184bd3d
17d ago Changed · +5 lines · +108 tokens per session 46c39b537551
18d ago Changed · +2 lines · +97 tokens per session 4ba8436056fb
27d ago Changed · +5 tokens per session c9985ae493ca
1mo ago Changed 1264a84e0a85
1mo ago Changed · +1 lines · +9 tokens per session 8802bdd439c7
1mo ago Changed · +6 lines · +97 tokens per session 52e3f595f5b8
1mo ago Changed · +5 lines · +81 tokens per session d0fcb7367e9d
1mo ago Changed · -618 lines · -8,513 tokens per session d1ed4c90c988
1mo ago First seen · 756 lines · 10,334 tokens per session scan A adf43d09f589

Subscribe to this mod's changes

aontu AGENTS.md is an instructions file published in the GitHub repository aontu-lang/aontu (11 stars, last pushed yesterday), licensed MIT. It adds 2,231 tokens to every session, about $0.0089 per session on Opus 5.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.

aontu AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
aontu AGENTS.mdaontu-lang/aontu	Instructions file	11	yesterday	MIT	A	2,231	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

aontu: Instructions file for Codex