AGENTS.md@gems/okf-proA

AGENTS.md@gems/okf-pro from serradura/okf is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add serradura/okf/gems/okf-pro/AGENTS.md@git:20260820.605496b

Pins git:20260820.605496b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
serradura/okf
Path
gems/okf-pro/AGENTS.md
Versions recorded
5
Latest version
git:20260820.605496b, committed Aug 20, 2026
First version recorded
Aug 19, 2026
Size
7,058 bytes
Repository stars
179
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AGENTS.md

okf-pro — the enforcement layer. It turns an OKF bundle into a working memory an
agent is held to: `okf pro setup` writes the bundle and the governance around it,
`okf pro hook` runs one gate against one hook event. A sibling in the okf
monorepo, beside the baseline `gems/okf/` it depends on.

**This file is context, routing and reference.** [`../../AGENTS.md`](../../AGENTS.md)
binds every change in the repo; what is below is okf-pro's own, and every
argument for it is in `.okf/` rather than here.

## The contract, which outranks everything below it

> Blocking checks fail **closed**. If enforcement is missing or cannot run, the
> call is refused, loudly.
>
> Feedback checks fail **loud**. If enforcement is degraded, it says so in the
> same channel it would use to refuse.
>
> No check ever fails **silent**. A gate that is sometimes absent and does not
> confess converts "unchecked" into "checked and fine", which is worse than
> having no gate at all.

Every defect this gem has ever had failed in the direction of silence. When you
change anything here, the question to ask is not "is this correct?" but "what
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add serradura/okf/gems/okf-pro/AGENTS.md@sha256:4e2d1b4b0d657238

The line at the top of this page pins the label git:20260820.605496b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_euf7zkzqffog2i3z.svg)](https://markdownregistry.com/a/art_euf7zkzqffog2i3z)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 19, 2026 and Aug 20, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20260820.605496b latest2026-08-20 605496b 7,058 BA view · diff
git:20260820.246ce592026-08-20 246ce59 12,368 BA view · diff
git:20260820.3ce93412026-08-20 3ce9341 7,062 BA view · diff
git:20260820.946e2322026-08-20 946e232 13,922 BA view · diff
git:20260819.ed32b4b2026-08-19 ed32b4b 15,009 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (7058 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

serradura/okf · 179 stars · license Apache-2.0 · pushed 2026-09-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_euf7zkzqffog2i3z
GET https://markdownregistry.com/api/v1/resolve?ref=serradura/okf/gems/okf-pro/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/4e2d1b4b0d6572383ab07360d443d9db368f284d8d6df83fa8989a6278770910

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from serradura/okf

CLAUDE.md@.claude CLAUDE.md file
serradura/okf · .claude/CLAUDE.md
git:20260711.24e0e55 · audit B · 179 stars
AGENTS.md AGENTS.md file
serradura/okf · AGENTS.md
git:20260822.4b2c289 · audit A · 179 stars
AGENTS.md@gems/okf-mcp AGENTS.md file
serradura/okf · gems/okf-mcp/AGENTS.md
git:20260820.605496b · audit A · 179 stars
CLAUDE.md@gems/okf-mcp CLAUDE.md file
serradura/okf · gems/okf-mcp/CLAUDE.md
git:20260819.ed32b4b · audit B · 179 stars
CLAUDE.md@gems/okf-pro CLAUDE.md file
serradura/okf · gems/okf-pro/CLAUDE.md
git:20260819.ed32b4b · audit B · 179 stars
okf-pro SKILL.md skill
serradura/okf · gems/okf-pro/lib/okf/pro/template/gem/.claude/skills/okf-pro/SKILL.md · Operating rules for the .okf/ knowledge bundle — filing new concepts, the board, the journal, the daily snapshot…
git:20260819.ed32b4b · audit A · 179 stars
CLAUDE.md@gems/okf-pro/lib/okf/pro/template/seed CLAUDE.md file
serradura/okf · gems/okf-pro/lib/okf/pro/template/seed/CLAUDE.md
git:20260819.ed32b4b · audit A · 179 stars
AGENTS.md@gems/okf-tui AGENTS.md file
serradura/okf · gems/okf-tui/AGENTS.md
git:20260822.4b2c289 · audit A · 179 stars
CLAUDE.md@gems/okf-tui CLAUDE.md file
serradura/okf · gems/okf-tui/CLAUDE.md
git:20260819.ed32b4b · audit B · 179 stars
AGENTS.md@gems/okf AGENTS.md file
serradura/okf · gems/okf/AGENTS.md
git:20260820.246ce59 · audit A · 179 stars
CLAUDE.md@gems/okf CLAUDE.md file
serradura/okf · gems/okf/CLAUDE.md
git:20260820.246ce59 · audit B · 179 stars
okf SKILL.md skill
serradura/okf · gems/okf/lib/okf/skill/SKILL.md · Be the expert on Open Knowledge Format (OKF) — portable project knowledge as a directory of markdown files with YAML…
git:20260819.ed32b4b · audit A · 179 stars

Every file in serradura/okf

Browse by kind, by grade A, or by owner.