Instruction Context
<!-- GENERATED by scripts/build_readme.py - do not hand-edit. -->
# Instruction & context
[Back to README](../README.md)
| | Convention | Files | Read by | Spec |
| --- | --- | --- | --- | --- |
| 🟢 | [AGENTS.md](../conventions/agents-md/) | `AGENTS.md` | Most coding agents - OpenAI Codex, Cursor, Jules, Aider, Gemini CLI, Zed, and others | [spec ↗](https://agents.md) |
| 🟢 | [CLAUDE.md](../conventions/claude-md/) | `CLAUDE.md` | Claude Code, and tools that read the Claude memory convention | [spec ↗](https://code.claude.com/docs/en/memory) |
| 🟢 | [Tool-specific instruction files](../conventions/tool-specific-instructions/) | `GEMINI.md` `AGENT.md` `QWEN.md` `WARP.md` `CONVENTIONS.md` `copilot-instructions.md` | Each file is read by its namesake tool - Gemini CLI, Amp, Qwen Code, Warp, Aider, GitHub Copilot - often alongside or as a bridge to AGENTS.md | [spec ↗](https://agents.md) |
| 🟠 | [OKF (Open Knowledge Format)](../conventions/okf/) | `.md` | Agents over MCP (okfy, openknowledge, superops okf CLIs); Google's knowledge-catalog ingests bundles | [spec ↗](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf) |
## [AGENTS.md](../conventions/agents-md/)
A plain-Markdown "README for agents" - build/test commands, conventions, and gotchas an agent needs before touching the code. The most widely adopted cross-tool instruction file.
## [CLAUDE.md](../conventions/claude-md/)
Anthropic's memory file for Claude Code - loaded automatically at session start to carry project commands, style rules, and standing instructions across turns.
## [Tool-specific instruction files](../conventions/tool-specific-instructions/)
Per-tool instruction files that predate or coexist with AGENTS.md. Some tools now default to AGENTS.md while keeping legacy filenames alive, so these variants still matter when auditing real repositories.
## [OKF (Open Knowledge Format)](../conventions/okf/)
A machine-first organizational knowledge base: a version-controlled folder of typed Markdown files (one concept per file) that any agent reads as ground-truth context. Open-sourced by Google Cloud in 2026 as the content layer to MCP's transport.when to use it
Community prompt sourced from the open-source GitHub repo ItamarZand88/awesome-agent-conventions (MIT). A "Instruction Context" style prompt — adapt the placeholders and specifics to your task. Imported as-is and not independently retested here, so check the output before relying on it.
tags
productivitycommunitydeveloper
source
ItamarZand88/awesome-agent-conventions · MIT
more in Productivity
Productivity✓ tested
Summarize a doc into decisions & actions
chief of staff who extracts what to DO, not just what was said
Productivity✓ tested
Draft a reply to a hard email
calm, direct communicator who de-escalates without caving
Productivity✓ tested
Turn a brain-dump into a weekly plan
planning coach who protects your focus, not just your calendar