AGENTS.mdA

AGENTS.md from using-system/oddyssey is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add using-system/oddyssey/AGENTS.md@git:20260920.e60b5e1

Pins git:20260920.e60b5e1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
using-system/oddyssey
Path
AGENTS.md
Versions recorded
18
Latest version
git:20260920.e60b5e1, committed Sep 20, 2026
First version recorded
Sep 5, 2026
Size
26,125 bytes
Repository stars
10
License
MIT

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

## Working conventions

Never commit on the default branch: branch first, named
`type/short-description` (`fix/stack-env-reset`, `docs/reports-guide`).
Commit messages, PR titles, and issue titles all follow
[Conventional Commits](https://www.conventionalcommits.org/) —
`type(scope): lowercase imperative description`. The PR title becomes
the squash commit and the release note, and drives the version
(`feat:` → minor, `fix:`/others → patch): **never add a `!` or
`BREAKING CHANGE` marker without discussing it first** — it triggers a
major release. One logical change per PR. **Every PR references an
existing issue** (`Closes #N` in the body) — no exceptions: the issue
carries the problem and its discussion, the PR carries the change;
open the issue first when none exists. **When the implementation
deviates from what the issue specified** — a rule dropped, a
threshold changed, a scope narrowed, a design replaced — record each
amended choice as a comment on that issue, what changed and why,
before opening the PR: the issue is the decision record a later
reader opens first. The full contributor
workflow lives in [CONTRIBUTING.md](CONTRIBUTING.md); where this file
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add using-system/oddyssey/AGENTS.md@sha256:572aaf7d642f64fc

The line at the top of this page pins the label git:20260920.e60b5e1, 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_6ad3cydzis357u3o.svg)](https://markdownregistry.com/a/art_6ad3cydzis357u3o)

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

Versions

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

versioncommittedcommitsizeaudit
git:20260920.e60b5e1 latest2026-09-20 e60b5e1 26,125 BA view · diff
git:20260917.31326ac2026-09-17 31326ac 26,125 BA view · diff
git:20260916.33cb7762026-09-16 33cb776 24,844 BA view · diff
git:20260914.82cc2192026-09-14 82cc219 24,704 BA view · diff
git:20260912.1927ef42026-09-12 1927ef4 24,704 BA view · diff
git:20260911.3b321572026-09-11 3b32157 23,780 BA view · diff
git:20260911.7bbcd122026-09-11 7bbcd12 21,119 BA view · diff
git:20260909.99d2ea22026-09-09 99d2ea2 21,063 BA view · diff
git:20260908.79a10092026-09-08 79a1009 20,273 BA view · diff
git:20260907.f3841042026-09-07 f384104 18,580 BA view · diff
git:20260906.2da3fc92026-09-06 2da3fc9 14,595 BA view · diff
git:20260906.a5d7ef92026-09-06 a5d7ef9 14,530 BA view · diff
git:20260906.f77b8e02026-09-06 f77b8e0 14,530 BA view · diff
git:20260905.566d5122026-09-05 566d512 14,071 BA view · diff
git:20260905.f16aea62026-09-05 f16aea6 13,953 BA view · diff
git:20260905.cb54b122026-09-05 cb54b12 13,868 BA view · diff
git:20260905.d4a6eee2026-09-05 d4a6eee 13,703 BA view · diff
git:20260905.a4a18f82026-09-05 a4a18f8 13,703 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 (26125 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

using-system/oddyssey · 10 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6ad3cydzis357u3o
GET https://markdownregistry.com/api/v1/resolve?ref=using-system/oddyssey/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/572aaf7d642f64fc771b44bace1c117f334185b46b1528c28ff338fd5b9dd732

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 using-system/oddyssey

backend-configuration SKILL.md skill
using-system/oddyssey · .apm/skills/backend-configuration/SKILL.md · Own the configured observability backend, in two sections invoked by name. Check: display the configured stack and the…
git:20260926.15d5c37 · audit A · 10 stars
get-status SKILL.md skill
using-system/oddyssey · .apm/skills/get-status/SKILL.md · Render the state of the ODD loop from the repository's committed .odd/ history and git alone - one screen by default…
git:20260918.535f541 · audit A · 10 stars
k6-guides SKILL.md skill
using-system/oddyssey · .apm/skills/k6-guides/SKILL.md · Curated map of the official k6 load-testing docs - installation, running a script, scripting…
git:20260909.99d2ea2 · audit A · 10 stars
observability-cli-guides SKILL.md skill
using-system/oddyssey · .apm/skills/observability-cli-guides/SKILL.md · The package's knowledge of every observability stack it supports, one reference file per stack - the terminal query…
git:20260911.602b35b · audit A · 10 stars
odd-memory SKILL.md skill
using-system/oddyssey · .apm/skills/odd-memory/SKILL.md · The .odd/ memory - its contract and one reference per kind. The contract states what every kind shares (where the…
git:20260918.535f541 · audit A · 10 stars
otel-guides SKILL.md skill
using-system/oddyssey · .apm/skills/otel-guides/SKILL.md · Curated map of the official OpenTelemetry documentation by language. Use when planning or implementing OpenTelemetry…
git:20260905.83c6ee4 · audit A · 10 stars
package-layout SKILL.md skill
using-system/oddyssey · .apm/skills/package-layout/SKILL.md · Where this package is installed and what each part of it is - every skill, its reference files, its scripts, and the…
git:20260907.f384104 · audit A · 10 stars
run-scenario SKILL.md skill
using-system/oddyssey · .apm/skills/run-scenario/SKILL.md · Drive a reproducible request scenario against a locally running service - ad-hoc requests, or a stored k6 benchmark…
git:20260914.60f6a52 · audit B · 10 stars
setup-local-stack SKILL.md skill
using-system/oddyssey · .apm/skills/setup-local-stack/SKILL.md · Configure gcx against the local oddyssey Grafana stack and query its four signals (metrics, traces, logs, profiles)…
git:20260914.a0222b0 · audit A · 10 stars
test-plugin-harnessing SKILL.md skill
using-system/oddyssey · .claude/skills/test-plugin-harnessing/SKILL.md · Measure and optimise one phase of an oddyssey run - preflight, drive, observation, or the whole run - under one of the…
git:20260920.e60b5e1 · audit A · 10 stars
CLAUDE.md CLAUDE.md file
using-system/oddyssey · CLAUDE.md
git:20260828.67451e8 · audit B · 10 stars
backend-configuration SKILL.md skill
using-system/oddyssey · marketplace/oddyssey/skills/backend-configuration/SKILL.md · Own the configured observability backend, in two sections invoked by name. Check: display the configured stack and the…
git:20260926.0ccec67 · audit A · 10 stars

Every file in using-system/oddyssey

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.