# instruction.md > instruction.md keeps instructions for AI agents: Markdown documents with binding MUST, SHOULD and NEVER lines, versioned, signed and served over MCP, so every agent follows the version its people published. An instruction's address, https://instruction.md/{owner}/{name}, is a page for people and the instruction itself for agents: send `Accept: text/markdown` (or no Accept header at all) and the answer is the published text, exactly, as `curl -H 'Accept: text/markdown' https://instruction.md/instruction-md/code-review` shows. `@{ref}` or `@v{N}` after the name reads a ref or one version; https://instruction.md/{owner} lists an owner's public instructions, as markdown the same way. To follow one, connect an MCP client to https://instruction.md/mcp and read `instruction://{owner}/{name}`. ## Learn - [Learn](https://instruction.md/learn/): What instruction.md is, in plain words, and where to start. - [Quickstart](https://instruction.md/learn/quickstart/): Publish your first instruction and read it back as an agent would. - [Guides](https://instruction.md/learn/guides/): Short videos, step-by-step tasks and quick reads for getting started with instruction.md. - [Write your first instruction](https://instruction.md/learn/guides/first-instruction/): Watch an instruction being written in the editor, from an empty page to rules an agent follows. No account needed. - [Publish it and connect an agent](https://instruction.md/learn/guides/publish-and-connect/): Sign in, publish your instruction, and point an AI agent at it so it follows what you wrote. - [How versions work](https://instruction.md/learn/guides/how-versions-work/): Why your draft never surprises an agent: drafts, versions, and what going live means. - [Concepts](https://instruction.md/learn/concepts/): Documents, versions, refs, visibility, proposals and consumers. - [The language](https://instruction.md/learn/language/): A guided tour of what an instruction can say: rich guidance, rules and policies, tools, skills and people. - [Workflows](https://instruction.md/learn/workflows/): The native instruction.md workflow language: triggers, typed steps, data flow, human decisions, parallel work, recovery and durability. ## Docs - [Docs](https://instruction.md/docs/): How to write, publish and serve instructions your agents follow. - [The assistant](https://instruction.md/docs/assistant/): The AI assistant in the editor: asking it by chat or by voice, how its changes reach your instruction, what your plan includes, and what is sent to OpenAI. - [Claude Code](https://instruction.md/docs/claude-code/): Make an instruction your project's instructions in Claude Code: one command sets it up, and a new version reaches a running session at your next prompt. - [CLI](https://instruction.md/docs/cli/): Publish from CI, follow a ref, sign with your own key, export the audit. - [Codex](https://instruction.md/docs/codex/): Make an instruction your project's instructions in OpenAI's Codex, or your own everywhere: set up in one command, and a new version reaches a running session. - [Connect an agent](https://instruction.md/docs/connect/): Point any MCP client at the registry and follow an instruction. - [Contact us](https://instruction.md/docs/contact/): Where to ask for help or get in touch, what each form is for, when we answer, and what we keep and for how long. - [Deployments](https://instruction.md/docs/deployments/): Run an agent for every instruction in a project or a folder, on a machine of yours: new instructions get one, new versions reach them the way you choose, and an admin approves what you want approved. - [Embed and preview](https://instruction.md/docs/embed/): Draw instruction documents on any web page or Markdown preview with one script tag, and style them with CSS parameters. - [Lost your passkey?](https://instruction.md/docs/lost-passkey/): What to do when you can't sign in: another device, a recovery code, your organization's sign-in, then our support. And what we will never ask you for. - [Managed agents](https://instruction.md/docs/managed-agents/): For administrators: put your organization's instruction on every Claude Code and Codex your people use, and see which version each one applied. - [Other coding agents](https://instruction.md/docs/other-agents/): Make a project follow an instruction in Gemini CLI, Copilot, Cursor, OpenCode, pi and other coding agents: one command or one file, and a new version reaches a running session where the tool allows it. - [Passkeys](https://instruction.md/docs/passkeys/): What a passkey is, how to add a second one, and what happens if you lose a device. - [Privacy](https://instruction.md/docs/privacy/): What instruction.md keeps about you, what the assistant sends to OpenAI and where it is processed, what is stored in your browser, and how to download or delete your data. - [Recovery codes](https://instruction.md/docs/recovery-codes/): Your way back in if you lose your passkey: what recovery codes are, keeping them safe, using one, making new ones. - [Self-hosting](https://instruction.md/docs/self-host/): Run your own registry: what the pieces are, the smallest working instance, Postgres and its backups, identity, signing keys, and the licence. - [Servers, skills and sign-ins](https://instruction.md/docs/servers-and-skills/): An instruction names the MCP servers and skills its agent works with; one command writes them into Claude Code or Codex, and this machine says which account each server uses. Your keys never leave your machine. - [Signing in](https://instruction.md/docs/sign-in/): How you sign in to instruction.md: your address, then a passkey, or your company's sign-in. No passwords. - [Signing and trust](https://instruction.md/docs/signing/): Author signatures, publisher keys, revocation, and what a signature does not promise. - [Talking with agents](https://instruction.md/docs/talking-with-agents/): When an agent that runs for you asks a question or wants permission, it asks you on instruction.md: answer from the Deployments page or your notifications. You can write to a running agent, stop it or restart it, and the assistant explains each request in plain words. - [Terms of Service](https://instruction.md/docs/terms/): The terms for using instruction.md: your account, your content, what you may not do, the assistant, plans, and what we are and are not responsible for. - [Workflow nodes](https://instruction.md/docs/workflow-nodes/): The complete native Instruction Workflow node registry, including triggers, flow control, data transforms, models, tools, agents and human gates. ## Specification - [Specification](https://instruction.md/specification/): The first-edition instruction.md working draft: rich Markdown, explicit instruction semantics, standardized parsing, references, native workflows and portable bundles. - [The specification's repository](https://github.com/instruction-md/specification): the text, the block registry and the conformance corpus ## Help - [Support](https://instruction.md/support/): Help with signing in, a lost passkey, billing and your account, and a form to ask us. - [Contact us](https://instruction.md/contacts/): Who we are and how to reach us, with a form for sales, partnerships, security and press. ## Templates - [Explore](https://instruction.md/explore/): Ready-made instructions to start your own from: starters, templates and what the community has shared. instruction.md's own templates, published by the organization instruction-md (https://instruction.md/instruction-md lists them; each address answers its text to `Accept: text/markdown`): - [Code review](https://instruction.md/instruction-md/code-review): Reviews pull requests: what blocks a merge, what is a suggestion, and what needs a test. - [Customer support](https://instruction.md/instruction-md/customer-support): Answers customers exactly, never guesses at policy, and hands over to a person for refunds and exceptions. - [Incident response](https://instruction.md/instruction-md/incident-response): Keeps an incident's timeline and drafts its status updates; people make the decisions. - [Writing style](https://instruction.md/instruction-md/writing-style): Writes and edits in a clear, direct, friendly voice: the point first, the reader's words. - [Personal data](https://instruction.md/instruction-md/personal-data): Uses only the personal data a task needs, and never sends it where the task didn't name.