Most Capable Agent System Prompt

A copy-paste system prompt for people who use coding agents like Claude Code, Codex, or Cursor: paste it in, and your agent starts building a durable, self-improving agent system for general computer work.

Left alone, most agent sessions forget everything between runs, call work done without checking it, and stall once a task is finished. This prompt gives your agent a full architecture and operating doctrine - task graphs, verification, file-based memory, evals, governance, and a self-improvement loop - and tells it to start building right away, either as a harness wrapper around your existing agent or as fresh code built from scratch, based on your preference. The target is one system that can handle software engineering, scientific research, running a company, data analysis, browser and desktop automation, and complex multi-month projects, and that learns from every task.

What the agent is told to do:

• Inspect your workspace, ask only the questions it cannot answer itself, and write a runtime capability matrix and an implementation contract.
• Set up a file-based project operating system (AGENTS.md, plan.md, tasks.md, knowledge.md, FAILURE.md, and more) so any compatible agent can continue the work from the folder alone.
• Prove one closed loop end to end as the first milestone: goal, task graph, execution, verification, memory update, visibility to a human, and one lesson learned.
• Keep going from there: control plane, workers, memory, model routing, approvals and budgets, an eval harness, and a self-improvement loop, in the order the prompt's BUILD ORDER section lays out.

Contents

• Quick start
• How to use it
• What to expect
• FAQ
• The Prompt
• Research Appendix
• Subsystem Reference Map
• Notes
• License

Quick start

1. Copy the prompt: use the copy button on the code block under The Prompt, or the terminal command below.
2. Start your agent in an empty folder (or in the repo you want it to extend) and paste the prompt as your first message. It works with Claude Code, OpenAI Codex, Cursor, Antigravity, OpenClaw, OpenCode, OpenHands, the Claude Agent SDK, or any similar agent that can read and write files and run commands.
3. Answer the few questions it asks. Then it starts building.

To copy just the prompt from a terminal on macOS:

curl -fsSL https://raw.githubusercontent.com/fainir/most-capable-agent-system-prompt/main/README.md | awk '/^```text$/{f=1;next} f&&/^```$/{exit} f' | LANG=en_US.UTF-8 pbcopy

On Linux, replace | LANG=en_US.UTF-8 pbcopy with | xclip -selection clipboard or | wl-copy. To save it to a file instead, replace it with > prompt.md.

How to use it

Harness wrapper or from scratch

The prompt supports both paths (see IMPLEMENTATION POSTURE inside it):

• Harness-wrapper mode keeps your current agent (Claude Code, Codex, and so on) as the execution engine and builds the task system, file protocol, evals, and control plane around it. This is the default when the prompt runs inside a strong existing agent.
• Native runtime mode builds the system directly on an agent SDK, for when you want deeper control.

To choose, add a line after the prompt, for example Use harness-wrapper mode around Claude Code. or Use native runtime mode on the Claude Agent SDK, in TypeScript.

What to expect

• It is long. About 2,950 lines, 16,800 words, and 111,000 characters: roughly 23,000 tokens with OpenAI's tokenizers (measured with tiktoken), and other tokenizers, such as Claude's, may count more. That fits easily in a modern context window, but as a system prompt or instructions file it is sent with every request (prompt caching helps).
• It builds instead of chatting. The prompt treats an architecture essay without real files as failure. Expect the agent to inspect the workspace, ask a short batch of questions, and then write files: an operating summary for itself, a capability matrix, an implementation contract, planning files, and the now, next, blocked, improve, and recurring queues. Then it starts on the first milestone.
• It is a multi-component system. Over time the agent works toward a control plane, workers, a task graph engine, layered memory, model routing, approvals and budgets, evals, and a self-improvement loop. Expect many files, long sessions, and real token spend.
• It keeps going. Its stopping rules say to continue until the current milestone is implemented and verified, a real blocker needs you, or you pause or redirect it.
• Run it somewhere safe. It writes files and runs commands. Start in a dedicated folder under git, keep your agent's normal approval settings, and avoid fully unattended modes on a machine with credentials you care about.

FAQ

Does it work with model X or tool Y? It is plain text with no tool-specific syntax, so it works with any agent that can read and write files and run shell commands. It asks for a lot of long-horizon work, so results depend heavily on the model: strong agentic models with large context windows follow it best. In a chat-only interface without tools, the model can only plan, not build.

Why is it so long? The target system is ambitious, and the prompt says so up front. To keep the length from getting lost during long runs, it tells the agent to read the core sections first, write a compact operating summary for itself, and re-read that summary as it works.

Can I trim it? Yes. The prompt's READER CONTRACT names the core sections: NON-NEGOTIABLE DESIGN BETS, RELIABILITY MATH AND HARNESS ENGINEERING, RECOMMENDED DEFAULT IMPLEMENTATION CHOICES, BUILD ORDER, FIRST MILESTONE DEFINITION, NON-NEGOTIABLE RULES, and INITIAL ACTIONS YOU MUST TAKE NOW. Keep those. Good candidates to cut are the interface sections (END-USER INTERFACE DOCTRINE through INTERFACE SUCCESS CRITERIA) if you do not need a UI yet, the company or science sections if they do not apply to you, and the reference list (RESEARCH-INFORMED SYSTEMS TO STUDY AND STEAL FROM through CROSS-CUTTING META-LESSONS FROM THE ECOSYSTEM).

How do I customize it? Leave the prompt as is and add a short block of your own after it. That way you can drop in a newer version of the prompt later without redoing your edits. For example:

Project constraints:
- Runtime: Claude Code on macOS. Use harness-wrapper mode.
- Stack: TypeScript and SQLite.
- First milestone: coding tasks in this repository only.
- Ask before any paid API call, deploy, or git push.

Can I point it at an existing codebase? Yes. Before scaffolding anything, it checks whether there is an existing repository to extend. Run it on a branch so you can review what it changes.

The Prompt

You are the principal architect and builder of a maximally capable, self-improving agentic operating system for computer-based work.

The long-term objective is not merely “an AI coding assistant”. The objective is a system that can increasingly perform, coordinate, verify, and improve work across the full range of tasks a skilled human can do on a computer, including:
- software engineering
- debugging
- browser workflows
- desktop workflows
- research
- planning
- writing
- operations
- analysis
- finance support
- customer support
- sales and marketing operations
- scientific workflows
- multi-step project execution
- company-running routines

That means the target is one system that can move fluidly across scales:
- a simple request answered immediately
- a bounded task completed and verified
- a complex project decomposed and driven forward over time
- a long-running operating loop such as product work, company operations, or scientific research

Treat this as a serious systems-engineering program with measurable progress, failure modes, economics, safety boundaries, and long-horizon capability growth.

Your job is to build the system, not just describe it.

If a choice arises betwe