What is datapages AGENTS.md?

Project instructions for developing datapages, a Go-based code-generation project, including coding conventions, commands, dependencies, and folder roles.

Use it when editing the parser or other Go packages, running checks, updating generated files, or building the command-line tool and examples.

It gives contributors the project's expected way to format, test, generate, build, and organize code.

How romshark/datapages configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to romshark/datapages. 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/romshark/datapages/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/romshark/datapages

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/romshark/datapages/agents-md/github.svg)](https://agentmods.dev/instructions/romshark/datapages/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/romshark/datapages/agents-md"><img src="https://agentmods.dev/badge/instructions/romshark/datapages/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/romshark/datapages/agents-md"><img src="https://agentmods.dev/badge/instructions/romshark/datapages/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 5,834 This file is loaded in full into every session.

When invoked 5,834 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.05834	$0.05834
Opus 5.5	$0.02334	$0.02334
Sonnet 5.5	$0.01167	$0.01167
Haiku 4.5	$0.00583	$0.00583

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

Security

Grade A, and why

datapages 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 · 279 lines

How it starts

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

Code Style

Follow standard Go conventions (Effective Go).
Comment as described in code comments.
Use require from testify for test assertions, use assert only where it makes sense.
Use table-driven map-based (to ensure random input ordering) tests where applicable with concise name tests as map keys.

Commands

mage lint: lint.
mage fmt: format.
mage modTidy: tidy every Go module.
mage test: lint, then test.
mage coverage: measure the generator and generated-code coverage.
mage build: build the CLI and examples.
mage genTempl: generate templ files.
mage genDatapages: generate Datapages code.
mage genAISkills: generate AI agent instructions for every example.
mage genOfflineWorker: minify the offline service worker.
mage genMorpheus: build the Morpheus bundle of the Toxiproxy settings page of datapages watch.
mage watchDocs: serve the GitHub Pages site and reload it on changes. See DEV.md.
mage gen: generate templ files, Datapages code, AI agent instructions, documentation, the offline service worker and the Morpheus bundle.
mage checkGen: check that generated code is current.
mage checkWatch: report active datapages watch processes and fail if any exist.
mage goFix: run go fix on every module.
mage all: run fmt, modTidy, genTempl, genDocs, test and vulncheck.

Do not run templ generate or any target that wraps it (genTempl, genDocs, gen, checkGen, all) while datapages watch is running. Watch mode serves application template strings from temporary files. A separate generation deletes those files when it exits, which prevents the server from rendering until the next .templ change.

datapages watch stores 1 lock file per module in the system temporary directory under datapages-watch and refreshes it every 2s. genTempl and genDocs run mage checkWatch before generating. SIGKILL prevents lock cleanup, but a stale lock expires 10s after its last write. TestWatch skips while a lock is held. See the datapages skill for recovery instructions.

Read the full file on GitHub · 279 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 · +20 tokens per session 2d470b4627bc
7d ago Changed · +9 lines · +466 tokens per session 68fbf6905129
17d ago Changed · +3 lines · +103 tokens per session 034e00107067
19d ago Changed · +2 lines · +110 tokens per session 8792411a0494
22d ago Changed · +1 lines · +58 tokens per session 838c3666d429
24d ago Changed · +2 lines · -36 tokens per session 85d9f1afc2c7
25d ago Changed · +1 lines · +112 tokens per session 06183b5e11b2
26d ago Changed · +1 lines · +46 tokens per session a75bf7bf4766
1mo ago Changed · +1 lines · +56 tokens per session f82d31d2a077
1mo ago First seen · 259 lines · 4,899 tokens per session scan A 662d14e09e99

Subscribe to this mod's changes

datapages AGENTS.md is an instructions file published in the GitHub repository romshark/datapages (119 stars, last pushed 2d ago), licensed MIT. It adds 5,834 tokens to every session, about $0.0233 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-30.

Frontend Go datastar framework nats templ

datapages AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
datapages AGENTS.mdromshark/datapages	Instructions file	119	2d ago	MIT	A	5,834	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	today	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

datapages: Instructions file for Codex