methodology-advisor — Claude Code command
The methodology-advisor command for Claude Code and Codex reads the codebase and asks three questions to recommend an AI-development methodology stack. Run it at the start of a project, before choosing a workflow.
CC-BY-SA-4.0 ★ 6,529 updated 2026-10-22
.claude/commands/methodology-advisor.mdWhat methodology-advisor does
The command scans the repository without producing any output: it checks package.json, Cargo.toml, pyproject.toml, git history, test file counts, CI configs, OpenAPI schemas, and LLM API imports to build a picture of the project.
From those signals it scores eight stacks — solo-mvp, team-greenfield, microservices, brownfield-saas, enterprise-gov, llm-native, power-solo, and plan-moderate. Then it surfaces two or three concrete observations and asks exactly three questions, covering only what the code could not answer: the main pain point, deploy frequency, and setup appetite.
The output is a single recommendation: the chosen stack, why it fits, the included methodologies, a quick-start list built from actual file paths in the repo, and one honest trade-off. The full cycle takes 2–4 minutes according to the command's own header.
What it helps with
- choose a methodology stack before the first AI-assisted sprint
- decide whether TDD, BDD, or contract testing fits the current project
- find a workflow for a monorepo with multiple services or packages
- establish an AI-assisted process when migrating a legacy codebase
- get a concrete quick-start tied to real paths in the repository
Example prompts for the agent
- Run
/methodology-advisorand tell me which stack fits this project - Use
/methodology-advisorbefore we start — I want a process recommendation first - Scan the repo with
methodology-advisorand ask your three questions
How to install methodology-advisor
Manually: put the files in place
.claude/commands/methodology-advisor.mdCall it with /methodology-advisor. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/methodology-advisor.mdCall it with /prompts:methodology-advisor. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/methodology-advisor.prompt.mdManually: put the files in place
.gemini/commands/methodology-advisor.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about methodology-advisor
How do I install methodology-advisor in Claude Code?
Copy the command file to .claude/commands/methodology-advisor.md inside your repository. The command will then be available in Claude Code.
What does the methodology-advisor command do?
It reads project files and git history, scores eight methodology stacks, and recommends one — with a rationale, a quick-start list, and one honest trade-off. It asks three targeted questions before the final recommendation.
How do I install methodology-advisor in Codex?
Copy the file to ~/.codex/prompts/methodology-advisor.md. The command will then be available in Codex.