so-crates: Instructions file for Codex

AGENTS.md

so-crates AGENTS.md is an instructions file for Codex, OpenCode from dougburks/so-crates. It costs 13,057 tokens per session, scanned A, original, MIT.

Repository instructions for SO-CRATES, including how to update its bundled D3 chart libraries and organize backend code into domain modules.

In plain words
What is it for?
Use them to update vendored D3 dependencies, run the test suite, handle licensing updates, and choose the correct backend module for new logic.
Why use it?
They keep offline builds reproducible and prevent new backend logic from being placed in the wrong file.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md.

This is dougburks/so-crates's own configuration. It tells Codex and OpenCode how to work on so-crates itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything so-crates configures →

Reuse

Borrowing it

Nothing to install: this file belongs to dougburks/so-crates. 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/dougburks/so-crates/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/dougburks/so-crates

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.

agentmods badge for so-crates AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/dougburks/so-crates/agents-md/github.svg)](https://agentmods.dev/instructions/dougburks/so-crates/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/dougburks/so-crates/agents-md"><img src="https://agentmods.dev/badge/instructions/dougburks/so-crates/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.

agentmods 80×15 button for so-crates AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/dougburks/so-crates/agents-md"><img src="https://agentmods.dev/badge/instructions/dougburks/so-crates/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 13,057 This file is loaded in full into every session.
When invoked 13,057 The same file — it is already loaded in full.
Security scan A 1 finding. 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.13057 $0.13057
Opus 5.5 $0.05223 $0.05223
Sonnet 5.5 $0.02611 $0.02611
Haiku 4.5 $0.01306 $0.01306

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

Security

Grade A, and why

so-crates AGENTS.md scanned grade A 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 3d 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sL "https://unpkg.com/d3@7/dist/d3.min.js" -o static/d3.min.js
AGENTS.md · 406 lines

How it starts

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

AGENTS.md

This file contains agent-focused guidance for maintaining SO-CRATES.

Updating Vendored Dependencies

SO-CRATES bundles D3, d3-sankey, topojson-client and the Traffic Map's world map in static/ so the application works offline and builds remain deterministic.

D3

To update to the latest version:

curl -sL "https://unpkg.com/d3@7/dist/d3.min.js" -o static/d3.min.js
curl -sL "https://unpkg.com/[email protected]/dist/d3-sankey.min.js" -o static/d3-sankey.min.js

After updating, verify the files load correctly and run the test suite:

python3 -m unittest discover -v

If the copyright year changed, update static/LICENSE accordingly.

Check for D3 releases at https://github.com/d3/d3/releases. Recommended cadence: every 6–12 months, or immediately if a security CVE is announced.

World map and topojson-client

The Traffic Map's world is static/world-110m.json, built by scripts/build_world_map.py from world-atlas's Natural Earth 1:110m countries and i18n-iso-countries' English names, and decoded in the browser by the vendored static/topojson-client.min.js. To rebuild it (the shapes rarely change; a new country code from DB-IP with no shape needs a point added to the script's PLACES):

curl -sL "https://cdn.jsdelivr.net/npm/world-atlas@2/countries-110m.json" -o /tmp/countries-110m.json
curl -sL "https://cdn.jsdelivr.net/npm/i18n-iso-countries@7/langs/en.json" -o /tmp/en.json
python3 scripts/build_world_map.py /tmp/countries-110m.json /tmp/en.json static/world-110m.json
curl -sL "https://cdn.jsdelivr.net/npm/topojson-client@3/dist/topojson-client.min.js" -o static/topojson-client.min.js

Keep static/LICENSE's notices for both in step. The IP-to-country data itself isn't vendored: the Dockerfile's resources-builder stage downloads DB-IP's IP to Country Lite (the current month's, or last month's) and converts it with scripts/build_geoip.py, so every image build has the latest. DB-IP's CC BY 4.0 license asks for the "IP location data by DB-IP" link the map shows - keep it.

Read the full file on GitHub · 406 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. 3d ago Changed · +19 lines · +908 tokens per session 57f5f13dc155
  2. 7d ago Changed · +234 tokens per session 905959e27b35
  3. 10d ago Changed · +6 lines · +127 tokens per session 6d658d268592
  4. 13d ago Changed · +8 lines · +1,705 tokens per session 32e16096afb3
  5. 1mo ago Changed · +4 lines · +230 tokens per session 10c71351dcd1
  6. 1mo ago Changed · +39 lines · +1,378 tokens per session f9d8b92dc215
  7. 1mo ago Changed · +1 lines · +8 tokens per session 926a38ba6d1c
  8. 2mo ago First seen · 329 lines · 8,467 tokens per session scan A 6867db329dc0

Subscribe to this mod's changes

so-crates AGENTS.md is an instructions file published in the GitHub repository dougburks/so-crates (625 stars, last pushed 4d ago), licensed MIT. It adds 13,057 tokens to every session, about $0.0522 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

so-crates AGENTS.md compared with instructions from other repositories

so-crates AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
so-crates AGENTS.mddougburks/so-cratesInstructions file6254d agoMITA13,057Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode