# manifesto.md > A directory of the documents projects stand on: manifestos, principles, specifications and file conventions. One page per document, linking the author's canonical text and the version it was read against. A listing asserts nothing beyond the link; a claimed listing was confirmed by the document's maintainer. Pages are static. Each document page states its tenets (quoted from the source), the canonical URL, the version read against, maintainer, licence of the text, and the bundles it belongs to. The whole catalog is also available as JSON. ## Catalog - [Catalog as JSON](https://manifesto.md/index.json): every listing with its fields - [Full text for models](https://manifesto.md/llms-full.txt): all document pages in one file - [How to add or claim a listing](https://manifesto.md/add/) - [What the badge asserts](https://manifesto.md/badge/) ## Specifications - [12-Factor AI-enabled CLI](https://manifesto.md/12fc/): Twelve testable factors for a command-line tool whose operator may be a human or an AI agent, from machine-readable capabilities to meaningful exit codes, with a conformance gate. Canonical text: https://github.com/hop-top/spec-12fc/blob/main/specs/v0.1/spec.md - [Purpose-bound Access Control and Trust](https://manifesto.md/pact/): How an AI agent proves who it acts for, with what declared purpose and evidence, to a gateway that already authenticates and authorizes; a PACT pass never grants access and a native denial always wins. Canonical text: https://github.com/hop-top/poly-pact/tree/next/spec/v1.0 - [Agent Operation Protocol](https://manifesto.md/aop/): Six laws a system must enforce at its API boundary so that any actor, human or agent, can act on a shared operational graph without breaking it. Canonical text: https://agentoperationprotocol.org/v0.6/ - [Open Workspace Schema Framework](https://manifesto.md/owsf/): A portable, append-only workspace artifact model for execution continuity, replay, handoff and forking across tools; structure and invariants, not orchestration or transport. Canonical text: https://github.com/hop-top/spec-owsf/blob/main/specs/v1.0/core.md - [crtx](https://manifesto.md/crtx/): The wire and storage shape for AI agent conversations, sessions, turns, content parts, tool calls and the envelope that carries them, so runtime tools agree on one record. Canonical text: https://github.com/hop-top/spec-crtx/blob/main/specs/v0.1/envelope.md - [V*](https://manifesto.md/vstar/): Agentic-system state, worlds, missions, players, turns, observations and decisions, represented as iCalendar and vCard components so agent work rides existing calendar and contact tooling instead of a bespoke protocol. Canonical text: https://github.com/hop-top/poly-vstar/tree/main/spec/v1.0 - [CLEAR](https://manifesto.md/clear/): Contractual Labor Exchange of Agents and Resources, an economic coordination layer where agents contract, delegate work and settle outcomes under deterministic rules. Canonical text: https://manifesto.md/clear/ - [Semantic Versioning](https://manifesto.md/semver/): A version number of the form major.minor.patch and the rules for when each part increments, so dependency declarations mean the same thing to everyone. Canonical text: https://semver.org/spec/v2.0.0.html - [Conventional Commits](https://manifesto.md/conventional-commits/): A lightweight convention on top of commit messages, type, scope and description, that machines and people can read and that maps onto semantic versions. Canonical text: https://www.conventionalcommits.org/en/v1.0.0/ - [Keep a Changelog](https://manifesto.md/keep-a-changelog/): A format for a changelog file that people can read, one entry per version, grouped by the kind of change, newest first. Canonical text: https://keepachangelog.com/en/1.1.0/ - [Contributor Covenant](https://manifesto.md/contributor-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. Canonical text: https://www.contributor-covenant.org/version/2/1/code_of_conduct/ - [Agent2Agent Protocol](https://manifesto.md/a2a/): An open protocol for communication and interoperability between opaque agentic applications, with JSON-RPC, gRPC and HTTP+JSON bindings and an Agent Card for discovery. Canonical text: https://a2a-protocol.org/latest/specification/ - [Agentic Permissions Policy Algebra](https://manifesto.md/openappa/): A declarative policy format and deterministic engine that labels data flowing between an LLM agent and its tools, so restricted data cannot reach audiences it was never allowed to reach. Canonical text: https://www.openappa.com/contracts - [Model Context Protocol](https://manifesto.md/mcp/): An open protocol, built on JSON-RPC, for connecting LLM applications to external data sources and tools through hosts, clients and servers. Canonical text: https://modelcontextprotocol.io/specification/2026-07-28 ## Conventions - [AGENTS.md](https://manifesto.md/agents-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. Canonical text: https://agents.md/ - [Citation File Format](https://manifesto.md/citation-cff/): A CITATION.cff file in the root of a repository that gives human- and machine-readable citation metadata for software or a dataset, in YAML. Canonical text: https://citation-file-format.github.io/ - [EditorConfig](https://manifesto.md/editorconfig/): 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. Canonical text: https://editorconfig.org/ - [humans.txt](https://manifesto.md/humans-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. Canonical text: https://humanstxt.org/ - [REUSE Specification](https://manifesto.md/reuse/): A standardised way to declare copyright and licensing for every file in a project, using SPDX identifiers in comment headers, a LICENSES directory and REUSE.toml. Canonical text: https://reuse.software/spec-3.3/ - [Robots Exclusion Protocol](https://manifesto.md/robots-txt/): 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. Canonical text: https://www.rfc-editor.org/rfc/rfc9309.html - [security.txt](https://manifesto.md/security-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. Canonical text: https://www.rfc-editor.org/rfc/rfc9116.html - [Sitemaps XML format](https://manifesto.md/sitemaps/): 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. Canonical text: https://www.sitemaps.org/protocol.html - [System Package Data Exchange](https://manifesto.md/spdx/): An open standard data model and serialisations for communicating bill-of-materials information about software, including licensing, security, build, AI and dataset metadata. Canonical text: https://spdx.github.io/spdx-spec/v3.0.1/ - [The /llms.txt file](https://manifesto.md/llms-txt/): 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. Canonical text: https://llmstxt.org/ - [Well-Known Uniform Resource Identifiers](https://manifesto.md/well-known-uris/): 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. Canonical text: https://www.rfc-editor.org/rfc/rfc8615.html ## Manifestos - [Manifesto for Agile Software Development](https://manifesto.md/agile-manifesto/): Four value pairs and twelve principles for developing software, written by seventeen practitioners in 2001; the document the word agile points at. Canonical text: https://agilemanifesto.org/ - [The Reactive Manifesto](https://manifesto.md/reactive-manifesto/): Four traits of systems built to meet modern demands, responsive, resilient, elastic and message driven, published in 2013 and revised in 2014, with thousands of signatories. Canonical text: https://www.reactivemanifesto.org/ - [The GNU Manifesto](https://manifesto.md/gnu-manifesto/): Richard Stallman's 1985 statement of why a complete free Unix-compatible system was being written and what free software means, the founding document of the free software movement. Canonical text: https://www.gnu.org/gnu/manifesto.html - [The Cluetrain Manifesto](https://manifesto.md/cluetrain/): Ninety-five theses from 1999 on how networked markets talk and what that does to companies that still broadcast at them. Canonical text: https://www.cluetrain.com/ - [Netflix Culture Memo](https://manifesto.md/netflix-culture/): Netflix's statement of how it works, from the dream team it hires to the preference for people over process, published on its jobs site. Canonical text: https://jobs.netflix.com/culture - [The Mozilla Manifesto](https://manifesto.md/mozilla-manifesto/): Mozilla's ten principles for an internet that is open, accessible and enriches people's lives, with a 2017 addendum pledging a healthy internet. Canonical text: https://www.mozilla.org/en-US/about/manifesto/ ## Principless - [The Twelve-Factor App](https://manifesto.md/12-factor-app/): Twelve factors for building software-as-a-service applications that are portable, declarative and ready to scale, written at Heroku from experience operating hundreds of thousands of apps. Canonical text: https://12factor.net/ - [12-Factor Agents](https://manifesto.md/12-factor-agents/): Principles for building LLM-powered software reliable enough to put in front of production customers, modelled on the Twelve-Factor App and maintained in the open. Canonical text: https://github.com/humanlayer/12-factor-agents - [Local-first software](https://manifesto.md/local-first/): Seven ideals for software that keeps the primary copy of data on the user's device while still supporting collaboration, from the Ink and Switch essay that named the category. Canonical text: https://www.inkandswitch.com/local-first/ - [The Zen of Python](https://manifesto.md/zen-of-python/): Nineteen aphorisms for the design of the Python language and of Python code, recorded as PEP 20 and printed by import this. Canonical text: https://peps.python.org/pep-0020/ - [Amazon Leadership Principles](https://manifesto.md/amazon-leadership-principles/): The sixteen principles Amazon says it uses every day when discussing ideas, solving problems and hiring, published on its jobs site. Canonical text: https://www.amazon.jobs/content/en/our-workplace/leadership-principles - [Basics of the Unix Philosophy](https://manifesto.md/unix-philosophy/): Eric Raymond's seventeen rules distilling the Unix design tradition, alongside Doug McIlroy's original maxims, from The Art of Unix Programming. Canonical text: http://www.catb.org/~esr/writings/taoup/html/ch01s06.html - [Choose Boring Technology](https://manifesto.md/boring-technology/): Dan McKinley's argument for spending a company's few innovation tokens deliberately and preferring well-understood technology with known failure modes. Canonical text: https://boringtechnology.club/ - [GitLab Values](https://manifesto.md/gitlab-values/): The six values GitLab's public handbook uses to guide behaviour and decisions across the company, summed up by the acronym CREDIT. Canonical text: https://handbook.gitlab.com/handbook/values/ - [Linear Method](https://manifesto.md/linear-method/): Linear's principles and practices for building software products, from setting product direction to launching and building in public. Canonical text: https://linear.app/method - [PostHog Values](https://manifesto.md/posthog-values/): The five values in PostHog's public handbook that describe how the company expects its team to work and decide. Canonical text: https://posthog.com/handbook/values - [Shape Up](https://manifesto.md/shape-up/): Basecamp's method for product development in six-week cycles, in three parts, shaping the work, betting on it, and building it, written as a free online book. Canonical text: https://basecamp.com/shapeup - [Stripe Operating Principles](https://manifesto.md/stripe-operating-principles/): The six principles Stripe lists under "How we operate" on its careers site to describe how it expects people to work. Canonical text: https://stripe.com/jobs/culture - [Ten things we know to be true](https://manifesto.md/google-ten-things/): Google's ten-point philosophy, first written when the company was a few years old and kept as a public statement of how it builds products. Canonical text: https://about.google/company-info/philosophy/ - [The Tao of HashiCorp](https://manifesto.md/tao-of-hashicorp/): The eight design principles HashiCorp states as the foundation of its products and the way it approaches building infrastructure tooling. Canonical text: https://www.hashicorp.com/en/tao-of-hashicorp - [Valve Handbook for New Employees](https://manifesto.md/valve-handbook/): Valve's guide for new hires on working in a company with no managers, which it describes as an abbreviated encapsulation of its guiding principles. Canonical text: https://cdn.fastly.steamstatic.com/apps/valve/Valve_NewEmployeeHandbook.pdf ## Bundles - [Agentic Stack](https://manifesto.md/bundles/agentic-stack/): What an agent request meets on its way to a system, in order. - [Release Hygiene](https://manifesto.md/bundles/release-hygiene/): Versions, commits, changelogs, licences and citations that mean the same thing to every tool. - [Repo Conventions](https://manifesto.md/bundles/repo-conventions/): The files a project publishes for the tools, crawlers and people that open it. - [Corporate Principles](https://manifesto.md/bundles/corporate-principles/): How product companies say they work, side by side. - [Software Manifestos](https://manifesto.md/bundles/software-manifestos/): The documents that named the movements, from free software to local-first. - [Engineering Taste](https://manifesto.md/bundles/engineering-taste/): Short texts on choosing and writing software well. - [Agent State](https://manifesto.md/bundles/agent-state/): How agent work, conversations and workspaces are recorded so several actors can continue them. ## Optional - [Source repository](https://github.com/manifesto-md/manifesto.md): data files, issue templates, contribution rules