AGENTS.mdA

AGENTS.md from dkylewillis/vera is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add dkylewillis/vera/AGENTS.md@git:20261104.b78af8e

Pins git:20261104.b78af8e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
dkylewillis/vera
Path
AGENTS.md
Versions recorded
26
Latest version
git:20261104.b78af8e, committed Nov 4, 2026
First version recorded
Aug 31, 2026
Size
17,491 bytes
Repository stars
17
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

# Using VERA as an AI agent

This file teaches AI coding agents how to use VERA to retrieve context from documents.

## What is an `.vera` file?

A single SQLite vector database containing ready-made chunks, JSON metadata,
pre-computed embeddings, and optional opaque attachments. Extraction may record
pages, headings, figures, and regions as metadata or attachments. You can search
it instantly — no parsing, chunking, embedding API calls, or retrieval service. See
[docs/vera-spec-v0.2.md](docs/vera-spec-v0.2.md) for the current format specification.

## Quick reference

All one-shot commands support `--json` for machine-readable output on stdout.
`vera mcp` is a long-running stdio server and does not accept `--json`.

```bash
# Search a document (hybrid = semantic + keyword, best default)
vera search manual.vera "stormwater detention requirements" --top-k 5 --json

# Search a folder of .vera files as one corpus (results include "file")
vera search ./library "stormwater detention requirements" --top-k 5 --json

# Search nested folders directly, or build a persistent local library index
vera search ./library "stormwater detention requirements" --recursive --json
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dkylewillis/vera/AGENTS.md@sha256:1754d92c118f6820

The line at the top of this page pins the label git:20261104.b78af8e, 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_gssllpmubdvaaxke.svg)](https://markdownregistry.com/a/art_gssllpmubdvaaxke)

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

Versions

The registry has recorded 26 versions of this file, between Aug 31, 2026 and Nov 4, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261104.b78af8e latest2026-11-04 b78af8e 17,491 BA view · diff
git:20261103.24d02d02026-11-03 24d02d0 17,341 BA view · diff
git:20261103.b31ab352026-11-03 b31ab35 17,258 BA view · diff
git:20261101.92539452026-11-01 9253945 16,997 BA view · diff
git:20261030.fd90da12026-10-30 fd90da1 16,378 BA view · diff
git:20261030.62004c22026-10-30 62004c2 16,633 BA view · diff
git:20261030.cb2ae962026-10-30 cb2ae96 16,531 BA view · diff
git:20261029.bb009052026-10-29 bb00905 16,140 BA view · diff
git:20261029.f7d00ed2026-10-29 f7d00ed 16,184 BA view · diff
git:20261027.3325a422026-10-27 3325a42 16,038 BA view · diff
git:20261027.c6dda562026-10-27 c6dda56 15,444 BA view · diff
git:20261026.5a5d3cc2026-10-26 5a5d3cc 16,082 BA view · diff
git:20260924.0e395cb2026-09-24 0e395cb 15,377 BA view · diff
git:20260922.26b8dc12026-09-22 26b8dc1 15,325 BA view · diff
git:20260921.0884d742026-09-21 0884d74 15,283 BA view · diff
git:20260921.0a5a7152026-09-21 0a5a715 15,187 BA view · diff
git:20260917.8f581aa2026-09-17 8f581aa 15,064 BA view · diff
git:20260915.6fec82f2026-09-15 6fec82f 14,834 BA view · diff
git:20260914.35bda752026-09-14 35bda75 14,396 BA view · diff
git:20260911.afa81462026-09-11 afa8146 14,189 BA view · diff
git:20260911.ef42a612026-09-11 ef42a61 14,014 BA view · diff
git:20260910.a4f31362026-09-10 a4f3136 13,933 BA view · diff
git:20260901.b30b8712026-09-01 b30b871 13,941 BA view · diff
git:20260831.f88e9d92026-08-31 f88e9d9 13,891 BA view · diff
git:20260831.bf444522026-08-31 bf44452 12,873 BA view · diff
git:20260831.467653f2026-08-31 467653f 13,775 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 (17491 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

dkylewillis/vera · 17 stars · license Apache-2.0 · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_gssllpmubdvaaxke
GET https://markdownregistry.com/api/v1/resolve?ref=dkylewillis/vera/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/1754d92c118f6820c7f47a84a371141918c51483d98f8425e294badc3935bc06

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 dkylewillis/vera

vera-search SKILL.md skill
dkylewillis/vera · plugins/vera/skills/vera-search/SKILL.md · Searches, inspects, validates, converts, indexes, and exports VERA (.vera) document archives with citation-ready…
v1.0.0 · audit A · 17 stars

Every file in dkylewillis/vera

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

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