okf
Skill0 starsChanged 9 months agoMITView on GitHub
Bootstraps and maintains the agent knowledge base (OKF / Karpathy LLM-wiki) in a repo, and is the only correct way to change that wiki's structure: use it whenever the user asks to bootstrap, set up, create, migrate, repair, lint, audit or update a wiki or knowledge base for agents, asks whether the wiki is up to date or rotting, or mentions OKF, llm-wiki, the AGENTS.md contract or `.okf/`. Auto-detects repo state and routes to bootstrap (value-gated, full or lite), update, lint, audit, migrate or repair; installs the AGENTS.md contract, Claude Code and Codex hooks, git hooks, a git-tracking guard and a stdlib lint. Never hand-roll a knowledge base instead of using this skill. Do NOT use for ordinary documentation work (READMEs, docstrings, API docs) that does not involve the agent-maintained knowledge base.
17 other projects use a version of this.
Adopted by
Most recently taken up by
- superwebpros/claude-skillstheir own version, first seen Nov 16, 2026
- narr07/skillstheir own version, first seen Nov 15, 2026
- cofin/flowtheir own version, first seen Nov 15, 2026
- MMACABRE/SKILLStheir own version, first seen Nov 8, 2026
- saschb2b/okf-bundlestheir own version, first seen Oct 20, 2026
- scaccogatto/okf-skillstheir own version, first seen Oct 13, 2026
Other versions17 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 17
- scaccogatto/okf-skills★ 444same name
- gannonh/kata★ 67same name
- sniperunder123/okf-knowledge★ 65same name
- gannonh/kata-symphony★ 63same name
- saschb2b/skills★ 22same name
- cofin/flow★ 20same name
- k3ybladewielder/skills★ 7same name
- eloybar/okf-skills★ 5same name
- EwenSellitto/skills★ 4same name
- 18studio/simple_okf★ 3same name
7 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository17 other files it gives its agents.
- AGENTS.mdAGENTS.md
- auditing-skillsSkill
- creating-skillsSkill
- forge-builderSkill
- forge-claude-teamsSkill
- forge-codex-multiagentSkill
- forge-orchestratorSkill
- forge-researchSkill
- handoff-freshSkill
- handoffSkill
- managing-doc-manifestSkill
- pickupSkill
- studySkill
- syncing-docsSkill
- testing-skillsSkill
- updating-skillsSkill
- wrapSkill
The file
We split this skill into the rules it gives an agent
6 rules. 0 are common, 3 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 17 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 31
AGENTS.md is the real file; CLAUDE.md delegates to it: Default: a one-line CLAUDE.md containing @AGENTS.md (Claude Code's documented import.
- Distinctive: line 36
Copy-first migration: Never move, delete or overwrite existing docs or agent files without a shown plan and explicit confirmation.
- Distinctive: line 37
Retrieval is files + grep + index.md: No embeddings, BM25, rerankers or alias indexes by default (reference.md §7 has the one sanctioned …
- Distinctive: line 54
Always also check: git rev-parse --show-toplevel succeeds (no git → bootstrap must git init first) and the wiki path is tracked (git …
- Very specific: line 61
Plan-then-delete: Write <wiki>/_plan.md (page list → evidence → open questions).
- Very specific: line 111
Run audit first and show the gap list.
“Common” is measured: kept by at least 6 in 10 of the 17 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
OKF — bootstrap & maintain an agent knowledge base
Sets up and maintains a durable, agent-facing markdown wiki in the current repo: Karpathy's LLM-wiki pattern in Google's Open Knowledge Format. Works from Claude Code and Codex with the same files, contract and hooks; every mechanism is plain files + python3 stdlib + git. House authoring rules (evidence-backed, REQUIRED before writing pages): reference.md. Fetch the canonical sources only if genuinely unfamiliar: Karpathy gist gist.github.com/karpathy/442a6bf555914893e9891c11519de94f, OKF spec github.com/GoogleCloudPlatform/open-knowledge-format/blob/main/SPEC.md (v0.2; reference.md §1 summarizes what this skill accepts).
Workflow
- 1. Detect repo state (§Detection) → route to a mode
- 2. Run that mode's flow (§Bootstrap / §Update / §Lint / §Audit / §Migrate / §Repair)
- 3. Verify: lint passes, wiki git-tracked, contract + CLAUDE.md delegation + hooks intact
- 4. Report visibly: show lint output, list pages touched, state what was skipped
An explicit argument overrides detection: /okf bootstrap|update|lint|audit|migrate|repair.
Enforcement model — three layers, named honestly
- Structure guard (
.okf/lint.py): well-formedness and rot signals — frontmatter, links, index entries for missing pages, orphans, git-tracking, citation presence, passedstale_after. It cannot measure insight. - Write-forcing and nudges (deterministic, zero tokens). The Stop gate (Claude Code and Codex hooks) blocks ending a turn while code changed this session — uncommitted or committed since the session started — without a wiki page or log entry; uncommitted work that predates the session and is unchanged neither trips nor satisfies it; the deliberate escapes are a
no-impactlog line dated today or anOkf-Impact: nonecommit trailer.raw/captures never satisfy it. The git hooks lint staged pages and refuse a wiki commit whoseindex.mdlists a page that is not in it (errors block), warn on code-only commits, and advance the review anchor when a commit touches the wiki. CI re-runs the lint at merge. Reach, stated plainly: Claude and Codex hooks travel with the repo (.claude/settings.json,.codex/hooks.json) and load after the runtime's one-time trust step; git hooks and the review anchor are per-clone until/okfruns there; the SessionStart pointer says so when they are missing. Claude Code overrides a Stop hook after 8 consecutive blocks, so the gate is a strong nudge, not a guarantee. Under an agent with no hooks the contract alone carries the obligation. - Guidance (AGENTS.md contract + reference.md): where quality lives — model judgment by design.
Trust boundary. .okf/ (lint, runner, git hooks) is repo-controlled code that runs on every edit, stop and commit. Review it like husky/ or CI config; on a clone you do not trust, run python3 ~/.claude/skills/okf/scripts/okf_lint.py lint instead. The SessionStart hook warns when the repo copy differs from the installed skill copy at the same version.
Core invariants (non-negotiable)
- AGENTS.md is the real file; CLAUDE.md delegates to it. Default: a one-line CLAUDE.md containing
@AGENTS.md(Claude Code's documented import; works on Windows and in Cowork). A relative symlink is an opt-in for all-POSIX teams. Never duplicate content. - Pointer, not inline. AGENTS.md carries a short contract pointing into the wiki; it routes, it never summarizes (LLM-generated overviews are redundant with existing docs and cost tokens: ETH arXiv:2602.11988).
- Single writer. The main agent is the sole writer of the wiki; subagents inspect and report only.
- Generate minimally; pages accrete. First pass ≤8 pages; no architecture dumps.
- The wiki must be git-tracked (the #1 observed rot cause). A bare
!/docs/llm-wiki/**under a blanketdocs/ignore does nothing; re-include parents:docs/*then!docs/llm-wiki/; verify withgit check-ignore -v <wiki>/index.md. - Copy-first migration. Never move, delete or overwrite existing docs or agent files without a shown plan and explicit confirmation.
- Retrieval is files + grep + index.md. No embeddings, BM25, rerankers or alias indexes by default (reference.md §7 has the one sanctioned opt-in and the honest cost note).
- Mechanize what can be mechanized; be honest about the rest. Log appends, lint, gates and the anchor fire from hooks and scripts. Knowledge quality cannot be mechanized.
- Other people's uncommitted work is off-limits. Run
git statusfirst. Never edit, stage or commit a file that already has uncommitted changes you did not make (a parallel session's or the user's work in progress); do everything else, then list the skipped steps and ask the user to commit or stash and re-run/okf.
Detection (run first, always)
Priority order, first match wins. Auto-detect the wiki dir among wiki/, docs/llm-wiki/, docs/wiki/, llm-wiki/, openwiki/ (a dir with an index.md). Default for NEW bootstraps: wiki/. An existing healthy wiki dir always beats the default — never relocate a working wiki.
| # | State | Signals | Route |
| 1 | Fully bootstrapped | AGENTS.md contains <!-- okf:contract AND CLAUDE.md delegates to it (symlink, @AGENTS.md import, or a file whose content is just AGENTS.md) AND <wiki>/index.md + .okf/config.json exist (config.json is the bootstrap-completed marker) | update (or audit if the user asked for status or whether the wiki is still accurate) |
| 2 | Partial / drifted | Wiki exists but contract, delegation, .okf/, or hooks missing; or CLAUDE.md and AGENTS.md are diverged regular files with real content | repair |
| 3 | Legacy / foreign wiki | docs/llm-wiki/ without frontmatter, openwiki/, droid-wiki/, flat dated research-*.md, or ANY substantial pre-OKF knowledge dir (architect/, research/, notes/, dated reports) | migrate |
| 4 | Nothing | none of the above | bootstrap |
Machinery version, every run: compare grep -m1 OKF_LINT_VERSION .okf/lint.py with the skill's own scripts/okf_lint.py. If the repo's copy is older, upgrade first — §Repair steps 2–3 (contract refresh with refresh-contract, then .okf/ lint, runner, githooks, Claude and Codex hook merge, gitignore entries) and commit it on its own — then run the routed mode. audit only reports it. In an eval rehearsal, plain /okf on two current-looking repos ran an update and left a two-versions-old .okf/ (old Stop gate included) in place.
Always also check: git rev-parse --show-toplevel succeeds (no git → bootstrap must git init first) and the wiki path is tracked (git check-ignore, git status --porcelain --ignored). Namespace note: other tools also use .okf/ (okf-skills' bundle dir) and /okf; if .okf/ exists without lint.py + config.json, it is not ours — stop and ask.
Bootstrap
- Value gate first. Does this repo clear the wiki's cost bar? Knowledge-dense, investigative, or long-lived multi-session repos do; a small script repo may not — offer the lite profile (step L) or decline with reasons. Ask ≤3 questions total (value, capture depth, wiki dir if ambiguous). Unattended runs: self-arbitrate each question with the most reasonable assumption and record every choice in DECISIONS.md at the repo root (git-track it — an untracked root file pins noop-check to STALE). Attended runs record routing choices there too.
- Concept gate. Confirm the two canonical concepts are understood (reference.md §1 suffices offline).
- Survey (read-only subagents allowed; single writer enforced): structural pass (README, manifests, entrypoints, CI), then semantic pass (domain, key flows, sources to ingest).
- Plan-then-delete. Write
<wiki>/_plan.md(page list → evidence → open questions); delete it before finishing. Mandatory for bootstraps and multi-file migrations; skippable for ≤3-file migrations with the skip logged in DECISIONS.md. - Generate minimally per invariant 4: root
index.md(navigational, ≤200 lines; each entry copies the page'sdescriptionverbatim and points at a page that exists — a planned page saysplannedon its line), a flat layout until ~7 pages, everydescriptionleading with its distinguishing terms (never "How/Why/When/This page…"),log.md(an event log, not a page catalog), and only the pages the survey justifies (≤8). Frontmatter per reference.md; no inline YAML comments. Evidence durability: newly fetched material goes verbatim under<wiki>/raw/and isgit added; a cited pre-existing file that is UNTRACKED (and not ignored by policy) is copied — never moved — into<wiki>/raw/or tracked. Cited evidence must survivegit clean. - Wire the contract. Create or append to AGENTS.md from templates/agents-contract.md (
{WIKI}replaced; preserve every non-OKF section, deduping prose the contract now covers). CLAUDE.md, four cases: absent → write the one-line@AGENTS.mdimport (orln -s AGENTS.md CLAUDE.mdif the user prefers symlinks); regular file with content → show it and SPLIT: instruction-shaped parts (how to work here) are absorbed into AGENTS.md; knowledge-shaped parts (domain facts, findings) go to wiki pages, never into AGENTS.md (invariant 2 outranks this step); then replace with the import (confirm first); already a symlink/import to AGENTS.md → done; symlink to anything else → show the target and do NOT retarget without explicit confirmation. - Install enforcement.
- Copy
scripts/okf_lint.py→.okf/lint.py,templates/okf-py.sh→.okf/okf-py.sh, and every file intemplates/githooks/→.okf/githooks/(chmod +x). Write.okf/config.json:{"wikiDir": "<wiki>", "profile": "full", "typeVocab": [...]}. - Git hooks (agent-agnostic, per clone). Route by what exists, IN THIS ORDER; record the choice in DECISIONS.md:
0.
git config --global|--system core.hooksPathset → never set a local core.hooksPath (it would shadow the user's global hooks: secret scanners, git-lfs). If the global framework documents a per-repo chain point (e.g..git/hooks-local/), install there a pre-commit that runssh .okf/okf-py.sh pre-commit(and post-commit/post-rewrite likewise) and VERIFY it fires; no chain point → skip git hooks with a loud note and lean on CI.- A LOCAL
core.hooksPathis already set (e.g..githooks/) → chain from that directory's hooks with confirmation; never overwrite. .git/hooks/has ANY native non-sample hook → install into.git/hooks/pre-commit|post-commit|post-rewritedirectly (chaining into an existing file with confirmation); do NOT set core.hooksPath (it would orphan the other native hooks).- husky/lefthook config present → chain into that framework or skip with a visible note.
- Clean →
git config core.hooksPath .okf/githooks. Project gates belong in.okf/githooks/pre-commit.local; the template runs it first and survives re-copies.
- A LOCAL
- Claude hooks (scripted merge — never hand-edit settings.json): render templates/hooks-settings.json to
.okf/hooks-fragment.json, thenpython3 .okf/lint.py install-hooks .okf/hooks-fragment.json. It merges onlyhooks.*, is idempotent, upgrades older okf entries, honors"hooksDisabled": ["Stop"]in config (the way to turn the Stop gate off — never delete the block by hand), backs up under.okf/, and refuses invalid JSON. - Codex hooks: render templates/hooks-codex.json to
.okf/hooks-codex-fragment.json, thenpython3 .okf/lint.py install-hooks .okf/hooks-codex-fragment.json --target codex. Tell the user: run/hooksonce in Codex to trust the three entries;codex execneeds--dangerously-bypass-hook-trust. - CI backstop: copy templates/ci-okf-lint.yml →
.github/workflows/okf-lint.yml(or adapt). It matters MOST where git hooks could not be installed (routing 0/3). - Git-tracking guard per invariant 5.
- Copy
- Lint, commit, stamp (this order). Append the bootstrap entry to
log.md; add.okf/last-update.json,.okf/session-head,.okf/session-dirty.json,.okf/hook-seen.json,.okf/hooks-fragment.json,.okf/hooks-codex-fragment.json,.okf/log.lock,.okf/*.bakto.gitignore(per-clone state, deliberately untracked);python3 .okf/lint.py lintand fix errors (the pre-commit hook would block them);git addwiki, AGENTS.md, CLAUDE.md,.okf/,.claude/settings.json,.codex/hooks.json, DECISIONS.md; make the bootstrap commit (the post-commit hook stamps the anchor; if hooks were skipped runpython3 .okf/lint.py state-update); show the final lint output.
L. Lite profile (repos below the value bar): contract + CLAUDE.md delegation + git-tracking guard + .okf/ (lint, runner, config with "profile": "lite") + a bare <wiki>/index.md + log.md. No generated pages, no state machine, no CI, no hooks (say so). /okf upgrades lite→full on request.
Update (the maintenance loop)
- No-op short-circuit:
python3 .okf/lint.py noop-check.CURRENT→ report "wiki already current," stop.STALElists uncertified commits (code touched, no wiki, no[no-impact]/Okf-Impact: nonemarker) and uncommitted paths — commits that already carried their wiki update are not listed.NO-STATE(fresh clone) →state-update --from-last-wiki-commit, then re-run. It fails toward STALE on any git uncertainty; trust it. - Diff per commit:
git log <anchor>..HEAD --statfor the listed commits;git diff --name-status HEADfor the worktree. - Docs-impact plan: changed source → affected wiki page → edit → why; include any claim a truth audit (§Audit) reported wrong. No impact → no edit.
- Soft diff budget: <5 source files changed → edit ≤1–2 pages; >3 pages needing edits demands re-justification. Budget by commit when the list is long. No-op updates are valid.
- Surgical edits: replace the stale sentence; no formatting-only edits; bump the page
timestamp(orgenerated.at) when meaning changes. Sweep the whole wiki, not just the page you opened: when a change resolves a status line ("open blocker", "not supported", "refused", "out of scope") or changes a count or value,grep -rn '<feature>\|<old value>' <wiki>/and fix every page that states it. In the 2026-10 production audit, status lines and counts on pages nobody reopened were most of the wrong claims (reference.md §6). - Rename safety: renaming a page rewrites ALL inbound relative links in the same change.
- Contradictions: newest verified evidence wins; note supersessions in the page and
log.md; root index ≤200 lines. - Close out: update per-dir
index.mdif navigation changed;python3 .okf/lint.py lint(show output; an outdated-contract warning is fixed per §Repair step 2); commit the wiki changes — the post-commit hook advances the anchor. If you reviewed the diff and it truly had no doc impact: append a datedno-impactlog line (or use the trailer) andpython3 .okf/lint.py state-update --mark-reviewed.
Ingest variant (new source material): capture raw (and git add it) → synthesize into affected pages → cross-link → index if nav changed → log. Same budget discipline.
Lint
python3 .okf/lint.py lint — deterministic, repo-local, stdlib-only; from a subdirectory use python3 "$(git rev-parse --show-toplevel)/.okf/lint.py" lint. Errors (exit 1): missing/malformed/placeholder frontmatter, multi-line scalars in required fields, absolute internal links, index.md entries for pages that do not exist (a line saying planned downgrades to a warning), gitignored wiki or wiki files, cited local evidence that is untracked or gitignored, non-git repo, missing root index. Warnings: unknown type, forward/broken links in pages, an AGENTS.md contract older than the template, orphans (log.md links don't count), missing per-dir index, thin pages, missing citations (## Sources, source: or v0.2 sources:), untracked files (named), passed stale_after, >200-line root index, duplicate descriptions, symlinked pages, descriptions opening with a generic word, index entries that do not reuse a page's description verbatim, subdirectories before ~7 pages. The write-time hook surfaces the description and index checks while you author, whichever tool wrote the page (Edit, Write, apply_patch or a shell command): fix them then. Fix errors now; triage warnings visibly. --help prints usage; claims is the truth-check sampler (§Audit).
Audit (read-only)
Report, change nothing.
- Structure: detection state, lint summary,
noop-checkresult, page/dir counts, log.md recency, hook presence (.claude/settings.json,.codex/hooks.json,git config core.hooksPath, CI workflow), anchor age, git-tracking status. End with a prioritized repair list. - Truth check — whether the pages are still true, which lint cannot see. In a production audit, 4.3% of checkable claims were wrong, nearly all exact numbers or status lines.
python3 .okf/lint.py claimssamples 12 sentences (--nonly if the user asks for more;--seedresamples), weighted toward status lines, numbers and code references, each with its cited sources. A repo whose.okf/lint.pypredates 1.4.0 has noclaims: run the skill's ownscripts/okf_lint.py claimsfrom the repo root instead (audit never upgrades.okf/).- Check every sampled sentence against the repository per reference.md §11 — the wiki is never evidence; code, config, tests, data,
raw/captures and git history are. "Not checked" is not a verdict: the hard-to-check sentences are where wrong ones hide. Verdicts: supported (cite the confirming line) · wrong (all or part of it is contradicted: quote the contradicting line and say whether it went stale or was never true) · unconfirmed (checkable, but you found no evidence either way; say what you searched) · outside the repo (a decision, rationale or external fact the repo cannot confirm — expected, not a defect). In a large repo, split the sentences across read-only subagents (Claude Code: Agent tool; Codex: spawn_agent); they report and never edit (invariant 3). - Second look on every "wrong": open the evidence again and quote the exact contradicting line (or have a fresh subagent, not told your verdict, re-check it). No quote, no "wrong" — it becomes unconfirmed. In the production audit a first pass's flags held up 42 of 72 times; its "supported" verdicts 96 of 96.
- Report one row per sampled sentence —
| page:line | claim | verdict | evidence (quoted for "wrong") | suggested fix |— then the counts per verdict, stating that it is a sample. Fixes go through/okf update(Docs-impact plan), never through the audit.
Repair (partial / drifted — confirmation-gated)
- Run
auditfirst and show the gap list. Confirm scope before changing anything. - Reconcile AGENTS.md/CLAUDE.md drift: show both; merge the union of non-duplicate content into AGENTS.md; a contract block whose marker version is OLDER than the template's (
<!-- okf:contract v1 -->vs the template's v3; lint warns) is outdated — refresh it with the skill'spython3 <skill>/scripts/okf_lint.py refresh-contract, never by hand: it replaces the block and moves every paragraph containing non-template text below it, under## Repo-specific rules kept from the previous okf contract; show that section and leave it as it is — it is the repo's own text; a few sentences that repeat the contract cost less than a lost rule (by hand, an agent dropped three of a repo's evidence rules; told to trim "covered" paragraphs, agents dropped a repo-specific clause in 3 of 3 runs); a block at the current version whose text differs is a customization — report it, do not refresh it; then, with confirmation, replace CLAUDE.md with the delegation. - Add missing pieces in dependency order:
.okf/(lint, runner, config, githooks) → git-tracking fix → git hooks → Claude and Codex hooks merge → missingindex.md/log.md(thin, from existing pages only). Existing well-formed pages stay byte-identical. Upgrading an older.okf/: re-copy lint, runner and githooks from the skill, but a githook whose content differs from the okf template carries a project gate — keep it (or move its gate intopre-commit.local, shown first);config.jsonandpre-commit.localstay. - Frontmatter backfill for existing pages: propose
type/title/descriptionper page as a shown plan; apply on confirmation. - Lint, commit, stamp; show output.
Migrate (absorb existing docs — copy-first, confirmation-gated)
- Inventory existing knowledge artifacts (legacy
docs/llm-wiki/,openwiki//droid-wiki/output, flat dated research files, ADRs). - Present a mapping plan: source file → target wiki page +
type→ synthesized or verbatim. Nothing moves, is deleted, or overwritten until the user confirms (unattended: copy-first, delete nothing, log the choice). - Copy content in with frontmatter; convert
[[wikilinks]]to relative links; park full-fidelity originals under<wiki>/raw/when they are external or dated; keep an existing healthy wiki dir as the wiki dir. Evidence durability check: after any.gitignorefix, rungit check-ignore -von every file the pages cite (ADRs, docs, data); a cited file that is still ignored or untracked is re-included (!docs/adr/) or copied — never moved — into<wiki>/raw/. Lint warns on every cited local file that is not tracked. - Then run Bootstrap steps 6–8. Originals are archived or removed only on explicit confirmation.
Codex parity
Identical files, contract and hooks. .codex/hooks.json carries the same SessionStart pointer, PostToolUse auto-log (parses apply_patch) and Stop gate; trust them once with /hooks. Invocation: the skill is installed at ~/.codex/skills/okf as a copy — re-sync it after skill updates (cp -r ~/.claude/skills/okf ~/.codex/skills/); read this SKILL.md and follow it directly.
Self-Evolution
Update when: (1) the user corrects a flow; (2) OKF spec moves past v0.2 or renames reserved files (config makes reserved names parameters); (3) lint changes — keep scripts/okf_lint.py and repo copies in sync (lintVersion is stamped in state files; re-copy on the next /okf run per repo); (4) a production repo patches .okf/ locally — upstream it.
Current version: 1.4.2 — see CHANGELOG.md for the production evidence behind each change.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

