manifesto.md

Bundle 9 documents

Repo Conventions

The files a project publishes for the tools, crawlers and people that open it.

  1. 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
  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. 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.

Other bundles