llms.txtA

llms.txt from oliver-zehentleitner/keep-the-why is an llms.txt file: plain text a project publishes for AI models to read.

Install it, pinned
mdr add oliver-zehentleitner/keep-the-why/llms.txt@git:20261012.4c14d0d

Pins git:20261012.4c14d0d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
llms.txt file
Repository
oliver-zehentleitner/keep-the-why
Path
llms.txt
Versions recorded
56
Latest version
git:20261012.4c14d0d, committed Oct 12, 2026
First version recorded
Sep 2, 2026
Size
39,856 bytes
Repository stars
232
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

# Keep the Why

> The why layer of repo-native project memory: the reasoning behind a codebase as Markdown in the
> repo, versioned by Git, for coding agents and humans, so nothing rejected is proposed twice.

Keep the Why is the why layer of repo-native project memory (the thesis, by the same author:
https://oliver-zehentleitner.github.io/repo-native-project-memory/ — the repository already holds what a project is,
how it works and what changed; context/ is the row it was missing): an agent skill, and
the file convention it maintains, that preserve the reasoning behind a codebase — architecture
decisions, rejected alternatives, workarounds, incident learnings, operational constraints that
the code alone can't explain — in the repo.
That memory is plain Markdown in `context/`, committed with the code, so Git already provides the
storage, the history and the distribution: it travels with every clone, branch and fork, and a pull
request shows the reasoning diff beside the code diff; permissions and review are the code's, and
git blame and git log are the audit trail of every entry (permissions, distribution, review, forks,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add oliver-zehentleitner/keep-the-why/llms.txt@sha256:24b78e38b4c6a50b

The line at the top of this page pins the label git:20261012.4c14d0d, 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_6xcjci2djknpodxg.svg)](https://markdownregistry.com/a/art_6xcjci2djknpodxg)

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

Versions

The registry has recorded 56 versions of this file, between Sep 2, 2026 and Oct 12, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261012.4c14d0d latest2026-10-12 4c14d0d 39,856 BA view · diff
git:20261012.02450ff2026-10-12 02450ff 39,840 BA view · diff
git:20261011.348db2f2026-10-11 348db2f 38,749 BA view · diff
git:20261009.bb024f12026-10-09 bb024f1 38,749 BA view · diff
git:20261008.3d28d432026-10-08 3d28d43 38,542 BA view · diff
git:20261006.47a54e62026-10-06 47a54e6 38,482 BA view · diff
git:20261006.5f3ac8b2026-10-06 5f3ac8b 38,445 BA view · diff
git:20261006.7f8377c2026-10-06 7f8377c 37,388 BA view · diff
git:20261005.00915de2026-10-05 00915de 37,027 BA view · diff
git:20261005.eae4a242026-10-05 eae4a24 37,027 BA view · diff
git:20261004.08407b22026-10-04 08407b2 36,244 BA view · diff
git:20261002.e1f458d2026-10-02 e1f458d 35,712 BA view · diff
git:20261002.5cea7812026-10-02 5cea781 35,712 BA view · diff
git:20261001.3b5c2532026-10-01 3b5c253 34,424 BA view · diff
git:20261001.74972d12026-10-01 74972d1 34,429 BA view · diff
git:20261001.ed302832026-10-01 ed30283 34,285 BA view · diff
git:20260930.6b5f9cd2026-09-30 6b5f9cd 34,184 BA view · diff
git:20260930.6990a822026-09-30 6990a82 34,184 BA view · diff
git:20260927.3ed4fcd2026-09-27 3ed4fcd 30,876 BA view · diff
git:20260927.236573a2026-09-27 236573a 30,687 BA view · diff
git:20260924.5c493482026-09-24 5c49348 30,310 BA view · diff
git:20260923.243f27c2026-09-23 243f27c 29,991 BA view · diff
git:20260923.1465bb92026-09-23 1465bb9 29,406 BA view · diff
git:20260922.880be512026-09-22 880be51 29,505 BA view · diff
git:20260922.78c6d4e2026-09-22 78c6d4e 28,925 BA view · diff
git:20260922.d5d23c52026-09-22 d5d23c5 27,983 BA view · diff
git:20260918.5ccc7d82026-09-18 5ccc7d8 24,489 BA view · diff
git:20260918.d6e72b02026-09-18 d6e72b0 24,489 BA view · diff
git:20260914.a774b742026-09-14 a774b74 24,312 BA view · diff
git:20260914.3e243712026-09-14 3e24371 24,030 BA view · diff
git:20260914.394b45c2026-09-14 394b45c 24,030 BA view · diff
git:20260911.7425ae12026-09-11 7425ae1 23,582 BA view · diff
git:20260911.5168e892026-09-11 5168e89 23,537 BA view · diff
git:20260911.99ee4052026-09-11 99ee405 23,537 BA view · diff
git:20260910.b071f592026-09-10 b071f59 21,958 BA view · diff
git:20260910.27ebe892026-09-10 27ebe89 21,958 BA view · diff
git:20260910.0517fee2026-09-10 0517fee 21,765 BA view · diff
git:20260909.3a080df2026-09-09 3a080df 21,643 BA view · diff
git:20260909.fbbd74e2026-09-09 fbbd74e 21,643 BA view · diff
git:20260908.30050662026-09-08 3005066 21,483 BA view · diff
git:20260908.1c795dd2026-09-08 1c795dd 21,191 BA view · diff
git:20260908.2ef17092026-09-08 2ef1709 20,718 BA view · diff
git:20260908.7b1d6c72026-09-08 7b1d6c7 20,718 BA view · diff
git:20260908.9953a662026-09-08 9953a66 20,440 BA view · diff
git:20260907.5cc21912026-09-07 5cc2191 19,564 BA view · diff
git:20260907.f99634b2026-09-07 f99634b 19,564 BA view · diff
git:20260907.a14f8da2026-09-07 a14f8da 19,564 BA view · diff
git:20260907.2e1bf7e2026-09-07 2e1bf7e 19,564 BA view · diff
git:20260907.86c4cd42026-09-07 86c4cd4 19,381 BA view · diff
git:20260906.7217f9b2026-09-06 7217f9b 18,875 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 (39856 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

oliver-zehentleitner/keep-the-why · 232 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6xcjci2djknpodxg
GET https://markdownregistry.com/api/v1/resolve?ref=oliver-zehentleitner/keep-the-why/llms.txt
GET https://markdownregistry.com/api/v1/blob/24b78e38b4c6a50b644cd8035f51513f9953da703c19a969cc276cfedc7d07c8

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 add an llms.txt file to a website · which agent file does what.

More from oliver-zehentleitner/keep-the-why

AGENTS.md AGENTS.md file
oliver-zehentleitner/keep-the-why · AGENTS.md
git:20260901.b5992ad · audit A · 232 stars
AGENTS.md@context AGENTS.md file
oliver-zehentleitner/keep-the-why · context/AGENTS.md
git:20260901.b5992ad · audit B · 232 stars
CLAUDE.md@context CLAUDE.md file
oliver-zehentleitner/keep-the-why · context/CLAUDE.md
git:20260901.b5992ad · audit B · 232 stars
keep-the-why SKILL.md skill
oliver-zehentleitner/keep-the-why · skills/keep-the-why/SKILL.md · In a project with a .keep-the-why, or when asked about Keep the Why or to set it up - extract and preserve the…
v0.20.2 · audit A · 232 stars
AGENTS.md@tools/evals/fixtures/_base AGENTS.md file
oliver-zehentleitner/keep-the-why · tools/evals/fixtures/_base/AGENTS.md
git:20260901.8d0050c · audit B · 232 stars
AGENTS.md@tools/evals/fixtures/_base/context AGENTS.md file
oliver-zehentleitner/keep-the-why · tools/evals/fixtures/_base/context/AGENTS.md
git:20260901.8d0050c · audit B · 232 stars
CLAUDE.md@tools/evals/fixtures/_base/context CLAUDE.md file
oliver-zehentleitner/keep-the-why · tools/evals/fixtures/_base/context/CLAUDE.md
git:20260901.8d0050c · audit B · 232 stars
AGENTS.md@tools/evals/fixtures/autostart-project-instruction-loads-skill AGENTS.md file
oliver-zehentleitner/keep-the-why · tools/evals/fixtures/autostart-project-instruction-loads-skill/AGENTS.md
git:20260904.ae66ab5 · audit A · 232 stars
CLAUDE.md@tools/evals/fixtures/autostart-project-instruction-loads-skill CLAUDE.md file
oliver-zehentleitner/keep-the-why · tools/evals/fixtures/autostart-project-instruction-loads-skill/CLAUDE.md
git:20260904.ae66ab5 · audit B · 232 stars
AGENTS.md@tools/evals/fixtures/config-migrates-to-dedicated-file AGENTS.md file
oliver-zehentleitner/keep-the-why · tools/evals/fixtures/config-migrates-to-dedicated-file/AGENTS.md
git:20260901.8d0050c · audit A · 232 stars
AGENTS.md@tools/evals/fixtures/context-cache-is-read-only/home/.keep-the-why/cache/ktw-eval-fixture---billing/context AGENTS.md file
oliver-zehentleitner/keep-the-why · tools/evals/fixtures/context-cache-is-read-only/home/.keep-the-why/cache/ktw-eval-fixture---billing/context/AGENTS.md
git:20260927.4c8492d · audit B · 232 stars
CLAUDE.md@tools/evals/fixtures/context-cache-is-read-only/home/.keep-the-why/cache/ktw-eval-fixture---billing/context CLAUDE.md file
oliver-zehentleitner/keep-the-why · tools/evals/fixtures/context-cache-is-read-only/home/.keep-the-why/cache/ktw-eval-fixture---billing/context/CLAUDE.md
git:20260927.4c8492d · audit B · 232 stars

Every file in oliver-zehentleitner/keep-the-why

Other files named llms.txt

llms.txt llms.txt file
garrytan/gbrain · llms.txt
git:20261009.8edae60 · audit A · 31,074 stars
llms.txt llms.txt file
othmanadi/planning-with-files · llms.txt
git:20260917.2fbbd77 · audit A · 27,556 stars
llms.txt llms.txt file
nteract/semiotic · llms.txt
git:20261006.a110d98 · audit A · 2,716 stars
llms.txt llms.txt file
ethanyoq/ai-novel-writer · llms.txt
git:20261018.88fb1ad · audit A · 1,705 stars
llms.txt llms.txt file
geekplux/markvis · llms.txt
git:20261019.8e49964 · audit A · 1,598 stars
llms.txt llms.txt file
fujibee/agmsg · llms.txt
git:20260627.990bb29 · audit A · 1,557 stars
llms.txt llms.txt file
reticlehq/reticle · llms.txt
git:20261016.5281a4b · audit B · 1,263 stars
llms.txt llms.txt file
asheshgoplani/agent-deck · llms.txt
git:20260301.a014772 · audit B · 1,127 stars

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