AGENTS.mdB

AGENTS.md from tale-project/tale is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add tale-project/tale/AGENTS.md@git:20261030.aaa6dde

Pins git:20261030.aaa6dde in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
AGENTS.md file
Repository
tale-project/tale
Path
AGENTS.md
Versions recorded
9
Latest version
git:20261030.aaa6dde, committed Oct 30, 2026
First version recorded
Jul 17, 2026
Size
10,732 bytes
Repository stars
42
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

# Working in this repository

The shared contract for every coding agent in every tale-project repository. Read it, then read
[`.agents/repo.md`](.agents/repo.md) — the repo-specific contract — before your first change.

Repositories are Bun workspaces (with Turborepo where there is more than one workspace); a
workspace script runs through `bun run --filter <workspace> <script>`.

## Read the repo contract next

[`.agents/repo.md`](.agents/repo.md) is the per-repo file: layout, stack, domain rules, extra
gates, and the debt ledger. This shared file never carries repo facts — if a fact is specific to
one repository, it belongs there. When the two seem to disagree, the repo contract wins.

## How to work

The biggest quality lever is deciding well, not typing fast. Work in this order:

1. **Classify the task** and follow its discipline end-to-end: a defect (find the root cause, lock
   it with a regression test); structure-not-behaviour (refactor without changing behaviour); new
   behaviour (a feature, screen, endpoint, or flag); a review (an adversarial read before merge).
   Exploring is read-only and returns the conclusion; a migration is phased and reversible, each
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tale-project/tale/AGENTS.md@sha256:7117f5d8b3315f49

The line at the top of this page pins the label git:20261030.aaa6dde, 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_plmkas22wilnzt6v.svg)](https://markdownregistry.com/a/art_plmkas22wilnzt6v)

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

Versions

The registry has recorded 9 versions of this file, between Jul 17, 2026 and Oct 30, 2026, about one every 13 days.

versioncommittedcommitsizeaudit
git:20261030.aaa6dde latest2026-10-30 aaa6dde 10,732 BB view · diff
git:20260921.ed257cb2026-09-21 ed257cb 10,165 BB view · diff
git:20260908.131a3572026-09-08 131a357 9,761 BB view · diff
git:20260908.7b09e8f2026-09-08 7b09e8f 7,641 BB view · diff
git:20260824.f923f502026-08-24 f923f50 6,511 BB view · diff
git:20260822.ccaf64d2026-08-22 ccaf64d 6,077 BB view · diff
git:20260729.2743ee42026-07-29 2743ee4 9,029 BB view · diff
git:20260718.9c2c00a2026-07-18 9c2c00a 13,544 BB view · diff
git:20260717.c973bc32026-07-17 c973bc3 13,528 BB view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Size between 200 bytes and 200 KB (10732 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

Starting a new one? Use a template for AGENTS.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

tale-project/tale · 42 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_plmkas22wilnzt6v
GET https://markdownregistry.com/api/v1/resolve?ref=tale-project/tale/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/7117f5d8b3315f495f6a5e5be2d9f9d87b8d04a712844da7134475cfbb6a5d0d

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 tale-project/tale

create-migration SKILL.md skill
tale-project/tale · .agents/skills/create-migration/SKILL.md · Use this skill whenever you change the shape of the 0.5 backend database — a new table, a new column, an index, a…
git:20260930.5f8dfea · audit A · 42 stars
write-docs SKILL.md skill
tale-project/tale · .agents/skills/write-docs/SKILL.md · Write, reorganize, or review end-user documentation, navigation, examples, and screenshots, including moving, renaming…
git:20260930.7f12462 · audit A · 42 stars
write-translations SKILL.md skill
tale-project/tale · .agents/skills/write-translations/SKILL.md · Author or review localized Tale UI messages, documentation, regional overrides, and glossary terms. Preserve meaning…
git:20261006.68386d3 · audit A · 42 stars
AGENTS.md@.agents/skills/write-translations/locales/de-CH AGENTS.md file
tale-project/tale · .agents/skills/write-translations/locales/de-CH/AGENTS.md
git:20260914.b26ddbc · audit A · 42 stars
AGENTS.md@.agents/skills/write-translations/locales/de AGENTS.md file
tale-project/tale · .agents/skills/write-translations/locales/de/AGENTS.md
git:20260914.b26ddbc · audit A · 42 stars
AGENTS.md@.agents/skills/write-translations/locales/en AGENTS.md file
tale-project/tale · .agents/skills/write-translations/locales/en/AGENTS.md
git:20260914.b26ddbc · audit A · 42 stars
AGENTS.md@.agents/skills/write-translations/locales/fr AGENTS.md file
tale-project/tale · .agents/skills/write-translations/locales/fr/AGENTS.md
git:20260914.b26ddbc · audit A · 42 stars
CLAUDE.md@.claude CLAUDE.md file
tale-project/tale · .claude/CLAUDE.md
git:20260822.ccaf64d · audit A · 42 stars
create-migration SKILL.md skill
tale-project/tale · .claude/skills/create-migration/SKILL.md · Use this skill whenever you change the shape of the 0.5 backend database — a new table, a new column, an index, a…
git:20260930.5f8dfea · audit A · 42 stars
write-docs SKILL.md skill
tale-project/tale · .claude/skills/write-docs/SKILL.md · Write, reorganize, or review end-user documentation, navigation, examples, and screenshots, including moving, renaming…
git:20260930.7f12462 · audit A · 42 stars
write-translations SKILL.md skill
tale-project/tale · .claude/skills/write-translations/SKILL.md · Author or review localized Tale UI messages, documentation, regional overrides, and glossary terms. Preserve meaning…
git:20261006.68386d3 · audit A · 42 stars
AGENTS.md@.claude/skills/write-translations/locales/de-CH AGENTS.md file
tale-project/tale · .claude/skills/write-translations/locales/de-CH/AGENTS.md
git:20260914.b26ddbc · audit A · 42 stars

Every file in tale-project/tale

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 B, or by owner.