# methodology-advisor

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.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 6529 repo stars
- Author: FlorianBruniaux
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/methodology-advisor.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/methodology-advisor

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/methodology-advisor.md` — Call it with /methodology-advisor. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/methodology-advisor.md` — Call it with /prompts:methodology-advisor. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/methodology-advisor.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/methodology-advisor.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/methodology-advisor.md

## When to use it
- 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
- Run `/methodology-advisor` and tell me which stack fits this project
- Use `/methodology-advisor` before we start — I want a process recommendation first
- Scan the repo with `methodology-advisor` and ask your three questions

## Similar
- [pentest-engagement-methodology](https://affpapa.org/en/nevibecode/skills/pentest-engagement-methodology.md) — skill · 356 installs
- [sparc-methodology](https://affpapa.org/en/nevibecode/skills/sparc-methodology.md) — skill · 1200 installs
- [research-methodology](https://affpapa.org/en/nevibecode/skills/poemswe-research-methodology.md) — skill · 244 installs
- [xp-practices](https://affpapa.org/en/nevibecode/skills/xp-practices.md) — skill · 125 installs
- [shift-left-testing](https://affpapa.org/en/nevibecode/skills/proffesor-for-testing-shift-left-testing.md) — skill · 117 installs
- [superpowers](https://affpapa.org/en/nevibecode/plugins/superpowers.md) — plugin · ★ 323788 repo stars

From the same set: [florianbruniaux/claude-code-ultimate-guide](https://affpapa.org/en/nevibecode/by/florianbruniaux/claude-code-ultimate-guide.md) — 45 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
