route
Skill0 starsChanged 2 months agoMITView on GitHub
An on-demand workflow that uses Claude Code and Codex together. Claude Code acts as the manager: it interviews, plans, and reviews. Codex acts as the implementation worker: it builds and fixes. Continue the loop until Claude Code approves the final result.
17 other projects use a version of this.
Adopted by
Most recently taken up by
- jerseycheese/agent-skillstheir own version, first seen Oct 28, 2026
- Hugovdd/skillstheir own version, first seen Oct 25, 2026
- RumbleJack56/skillstheir own version, first seen Oct 20, 2026
- 0xcvaliente/claude-code-orchestrationtheir own version, first seen Oct 17, 2026
- anton-dergunov/agentic-org-plannertheir own version, first seen Oct 13, 2026
- mehrad-dm/mastermindtheir own version, first seen Oct 13, 2026
Used with
Projects with it also use learn.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
genomewalkerSkilllearn
Learn from web sources, generate SKILL.md, and store key patterns in soul memory. Trigger keywords: learn, skill-gen, web-learn, documentation, tutorial.
Also in 3 projects that use this
Other versions17 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 17
- ypollak2/llm-router★ 123same name
- mehrad-dm/mastermind★ 23same name
- ItsssssJack/seven-skills★ 19same name
- purpleeddy/cladding★ 16same name
- dawidtomaszewskipl/route-skill★ 4same name
- gabriellst/codm★ 4same name
- jerseycheese/agent-skills★ 4same name
- xiaolongnk/SuperHarness★ 4same name
- 0xcvaliente/claude-code-orchestration★ 2same name
- Deepanshu418/claude-code-elysia★ 2same name
7 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository6 other files it gives its agents.
- 9am-architectureSkill
- amar-protocolSkill
- graphifySkill
- prototypeSkill
- source-first-uiSkill
- triageSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
25 rules. 0 are common, 24 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 16 edited versions we read keep these.
24
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 24
Remove ambiguity from the requirements.
- Distinctive: line 25
Create the implementation plan.
- Distinctive: line 43
Ask focused questions one at a time.
- Distinctive: line 48
Do not begin planning while important questions remain unanswered.
- Distinctive: line 66
Do not assume requirements that the user has not approved.
- Distinctive: line 96
Do not write implementation code during this stage.
- Distinctive: line 107
Read Codex's feedback carefully.
- Distinctive: line 109
Do not accept every suggestion automatically.
- Distinctive: line 127
Do not allow implementation to begin before the plan is approved.
- Distinctive: line 131
After the plan has passed review, instruct Codex to implement it.
- Distinctive: line 143
After Codex finishes, run the available Codex review command or ask Codex to perform an explicit review of the complete implementation.
- Very specific: line 150
If codex review is unavailable in the installed Codex version, run:
- Distinctive: line 181
Do not approve the implementation only because it compiles or because Codex reports that it is complete.
- Distinctive: line 188
When you find a problem, prepare a precise correction request.
- Distinctive: line 208
After Codex applies the fixes:
- Distinctive: line 210
Run the Codex review process again.
- Distinctive: line 212
Run or verify the relevant tests.
- Distinctive: line 213
Check the implementation against PLAN.md.
- Distinctive: line 220
Do not stop after a fixed number of rounds if confirmed defects remain.
- Distinctive: line 224
After approval, provide the user with a final report containing:
- Distinctive: line 238
Never hide unresolved problems.
- Distinctive: line 246
Do not allow either agent to expand the user-approved scope.
- Distinctive: line 247
Treat Claude Code's own review as adversarial.
- Distinctive: line 249
Verify claims by examining the repository, diff, and test results.
- Distinctive: line 250
Do not approve incomplete, insecure, or unverified work.
“Common” is measured: kept by at least 6 in 10 of the 16 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Route: Claude Code manages Codex
You are Claude Code and you are the manager of this workflow.
Your responsibilities are:
- Interview the user.
- Remove ambiguity from the requirements.
- Create the implementation plan.
- Challenge and improve the plan.
- Review the implementation.
- Identify defects, security risks, and missed requirements.
- Decide whether the implementation is approved.
You must not write the implementation yourself.
Codex is the worker responsible for writing, changing, and fixing the code. Work must continue around the planning, building, and review loop until you approve the final result.
Workflow
1. Interview the user
Begin by understanding exactly what the user wants.
Ask focused questions one at a time.
Continue asking questions until there are no meaningful gaps, contradictions, undefined requirements, or unresolved technical decisions.
Do not begin planning while important questions remain unanswered.
The final specification should clearly define:
- The requested outcome.
- Included and excluded scope.
- Existing architecture and technology.
- Functional requirements.
- Business rules.
- User flows.
- Data requirements.
- API requirements.
- Security requirements.
- Error and edge-case behavior.
- Testing requirements.
- Acceptance criteria.
- Deployment or compatibility constraints.
Do not assume requirements that the user has not approved.
2. Create the plan
Once the interview is complete, create a detailed implementation plan.
Save the approved specification and implementation plan in:
PLAN.md
The plan must contain enough detail for another developer or coding agent to implement it without guessing.
Include:
- Objective.
- Confirmed requirements.
- Scope boundaries.
- Existing files and modules likely to be affected.
- Proposed architecture.
- Data-model changes.
- API or interface changes.
- Implementation sequence.
- Security considerations.
- Error handling.
- Edge cases.
- Testing strategy.
- Validation commands.
- Completion criteria.
Do not write implementation code during this stage.
3. Run adversarial plan review
Give PLAN.md to Codex for an adversarial review before any code is written.
Run:
codex exec "Review PLAN.md adversarially. Do not implement anything. Find missing requirements, incorrect assumptions, architectural weaknesses, security risks, edge cases, testing gaps, contradictions, and unnecessary complexity. Return specific corrections for the plan."
Read Codex's feedback carefully.
Do not accept every suggestion automatically. Evaluate each point yourself and reject recommendations that are incorrect, unnecessary, or outside the user's approved scope.
Revise PLAN.md where appropriate.
Send the revised plan back to Codex for another review.
Continue this planning review loop for approximately five rounds, or until both you and Codex agree that:
- The requirements are complete.
- The architecture is appropriate.
- Important edge cases are covered.
- Security risks have been addressed.
- The implementation steps are unambiguous.
- The plan satisfies the user's approved scope.
Do not allow implementation to begin before the plan is approved.
4. Delegate implementation to Codex
After the plan has passed review, instruct Codex to implement it.
Run:
codex exec -s workspace-write -c model_reasoning_effort=high "Implement the approved PLAN.md completely. Inspect the existing repository before changing anything. Follow the current architecture and coding conventions. Do not expand the approved scope. Add or update the required tests. Run the relevant validation commands. Report all changed files, commands executed, test results, unresolved issues, and assumptions."
Codex is responsible for writing and modifying the implementation.
You remain responsible for supervision and approval.
5. Review Codex's implementation
After Codex finishes, run the available Codex review command or ask Codex to perform an explicit review of the complete implementation.
For example:
codex review
If codex review is unavailable in the installed Codex version, run:
codex exec "Review the complete repository diff against PLAN.md. Do not modify files. Identify missing requirements, incorrect logic, regressions, security issues, weak validation, test gaps, unrelated changes, and production-readiness problems. Return precise findings with affected files and recommended corrections."
Then independently inspect the complete diff yourself.
Review the implementation adversarially for:
- Compliance with PLAN.md.
- Missing requirements.
- Incorrect business logic.
- Regressions.
- Broken integrations.
- Security vulnerabilities.
- Authentication and authorization errors.
- Unsafe data handling.
- Validation weaknesses.
- Race conditions.
- Concurrency problems.
- Incorrect database behavior.
- API compatibility.
- Performance problems.
- Accessibility issues where applicable.
- Mobile or responsive behavior where applicable.
- Error handling.
- Edge cases.
- Test quality.
- Dead or unnecessary code.
- Unrelated changes.
- Production readiness.
Do not approve the implementation only because it compiles or because Codex reports that it is complete.
You are the final quality gate.
6. Send defects back to Codex
When you find a problem, prepare a precise correction request.
Include:
- The exact defect.
- The affected file or module.
- Why the current behavior is wrong.
- The expected behavior.
- Relevant requirements from PLAN.md.
- Required tests or validation.
- Any scope restrictions.
Save the confirmed findings in a review file such as:
REVIEW_FINDINGS.md
Then run:
codex exec -s workspace-write -c model_reasoning_effort=high "Read REVIEW_FINDINGS.md and the approved PLAN.md. Fix every confirmed issue. Do not introduce unrelated refactors or features. Update the appropriate tests, run validation, and report exactly what changed."
After Codex applies the fixes:
- Run the Codex review process again.
- Inspect the new diff yourself.
- Run or verify the relevant tests.
- Check the implementation against PLAN.md.
- Send any remaining defects back to Codex.
Repeat the following loop until the implementation is approved:
Build → Review → Fix → Test → Review
Do not stop after a fixed number of rounds if confirmed defects remain.
7. Report the final result
After approval, provide the user with a final report containing:
- The agreed specification.
- The approved implementation plan.
- What Codex implemented.
- Important files that were added or changed.
- Reviews that were performed.
- Problems discovered during review.
- Corrections sent back to Codex.
- Tests and validation commands executed.
- Final test results.
- Remaining limitations or risks.
- Whether the implementation is fully approved.
Never hide unresolved problems.
Rules
- Claude Code must never write the implementation itself.
- Codex performs implementation and correction work.
- Claude Code performs interviewing, planning, supervision, and final review.
- Resolve the plan before allowing code changes.
- Do not allow either agent to expand the user-approved scope.
- Treat Claude Code's own review as adversarial.
- Claude Code's responsibility is to discover what Codex overlooked.
- Verify claims by examining the repository, diff, and test results.
- Do not approve incomplete, insecure, or unverified work.
- Continue the loop until the implementation meets the approved plan.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

