Repo Conventions
The files a project publishes for the tools, crawlers and people that open it.
-
1EditorConfig
An INI-like .editorconfig file, read from the file's directory upward, that tells any editor the indentation, line endings, charset and whitespace rules of a project.
v0.17.2 in use here -
2AGENTS.md
A Markdown file at the root of a repository that gives AI coding agents the context and instructions a new teammate would need, kept separate from the human README.
-
3The /llms.txt file
A proposal for a Markdown file at /llms.txt that gives language models a curated overview of a website and links to clean Markdown versions of its pages.
-
4Robots Exclusion Protocol
The rules a service publishes at /robots.txt to tell crawlers which URIs they may access, as standardised by the IETF in RFC 9309 from Martijn Koster's 1994 method.
-
5Sitemaps XML format
An XML file listing the URLs of a site, with optional last-modified, change-frequency and priority hints, that webmasters publish so search engines can crawl more intelligently.
v0.90 in use here -
6security.txt
A machine-parsable file at /.well-known/security.txt in which an organisation states how security researchers should report vulnerabilities to it, defined by RFC 9116.
-
7Well-Known Uniform Resource Identifiers
A reserved path prefix, /.well-known/, under which registered site-wide metadata such as security.txt lives, so applications can discover information about an origin, defined by RFC 8615.
-
8humans.txt
A plain text file in the site root, next to robots.txt, that names the people who built a website and the standards and tools it uses.
-
9Contributor Covenant
A code of conduct for open source communities, adopted by tens of thousands of projects, stating the pledge, the standards, the enforcement responsibilities and the consequences.
v2.1 in use here
Other bundles
Agentic Stack
What an agent request meets on its way to a system, in order.
8 documentsRelease Hygiene
Versions, commits, changelogs, licences and citations that mean the same thing to every tool.
6 documentsCorporate Principles
How product companies say they work, side by side.
10 documentsSoftware Manifestos
The documents that named the movements, from free software to local-first.
8 documentsEngineering Taste
Short texts on choosing and writing software well.
5 documentsAgent State
How agent work, conversations and workspaces are recorded so several actors can continue them.
6 documents