Quick summary:
/planin Oh-my-pi (OMP) is a runtime mode: it locks the session read-only so the agent can investigate without editing the project./skill:ak-planin AgentKit is a Skill that writes an implementation roadmap to files (plan.mdplus phase files) for review and handoff toak-cook. Use/planwhen you need a safe investigation, and/skill:ak-planwhen you need a durable roadmap. If you want both, run them one after the other, and do not run/skill:ak-planinside Plan mode.
Both commands say "plan", so it is easy to assume they are interchangeable, or that turning on both gives you more thorough planning. In practice, nesting them gets the workflow stuck at the file-writing step. If both plans do get written, they drift apart.
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this guide is an affiliate link. For OMP, I am an independent researcher, not part of the development team, with no commercial relationship.
Note: the current AgentKit beta (since 3.0.0-beta.35, October 21, 2026) changed skill names from ak:<name> to ak-<name>, and the commands in this post use the new names: Claude Code calls /ak-plan, Codex calls $ak-plan. On an older version, swap ak- back to ak: to get the matching command.
Versions I checked: I ran the full workflow on 2026-09-01 on OMP 18.0.11 with the AgentKit beta of that time, on the pi-omp profile. On 2026-10-03 I re-checked against the OMP 18.4.0 docs and omp --help, without re-running everything on newer AgentKit releases. Where something comes only from the docs, I say so.
I choose by what I want in hand at the end
Before I type the word "plan", I ask one question: do I need to lock what the agent can do, or do I need a delivery document?
Think of a kitchen. OMP Plan mode is the switch that locks the gas: you may open the cupboards, inspect the ingredients and write down how to cook, but you cannot light the flame yet. AgentKit ak-plan is the process for building the menu and the work tickets: which dish comes first, who owns it, what must be checked. One controls what the runtime is allowed to do, the other produces a document for delivery.
| What you need | What to use |
|---|---|
| Investigate a change without letting the agent edit the project | OMP /plan |
Produce plan.md, phases, dependencies, test gates and a handoff | AgentKit /skill:ak-plan |
| Both | Run them in sequence: /plan, Save and quit, then /skill:ak-plan in a normal session |
/skill:ak-plan suits multi-file refactors, migrations, auth, payments, data integrity, or work that has to continue across sessions, because that work needs a plan you can reread in another session. /plan suits the case where you only want the agent to look first and propose, without touching any file.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "OMP Plan mode vs AgentKit ak-plan: when to use which" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "omp-plan-mode-vs-agentkit-ak-plan". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 01/09/2026
- Licence
- Subscriber-only; redistribution prohibited
- Slug
- omp-plan-mode-vs-agentkit-ak-plan
