# validate-implementation-plan

Audits implementation plans for speculative complexity and brittle assumptions. Writes a separate audit file without touching the original plan.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1700 installs · ★ 3
- Author: b-mendoza
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/b-mendoza/agent-skills/tree/HEAD/skills/validate-implementation-plan/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/validate-implementation-plan

## What it does

This skill audits technical design documents and implementation roadmaps. The source plan is untrusted input. Only `plan-snapshotter` reads `PLAN_PATH` directly. Later stages inspect a sanitized snapshot and structured findings to keep the review contained. The source file remains untouched.

A deterministic state machine guides execution. The extractor numbers project requirements. Dedicated auditors test traceability and flag premature complexity under YAGNI principles. Failing branches allow up to 3 retry attempts. The final report is saved alongside the source plan.

External web pages do not count as proof. Verification relies strictly on local repository files. To start an audit, provide `PLAN_PATH` and `ORIGIN_CONTEXT`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/validate-implementation-plan/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/validate-implementation-plan/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/validate-implementation-plan/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/validate-implementation-plan/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install b-mendoza/agent-skills validate-implementation-plan
```

2. **Manually: put the files in place**
- File: `.github/skills/validate-implementation-plan/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/b-mendoza/agent-skills --path skills/validate-implementation-plan
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/validate-implementation-plan/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill validate-implementation-plan -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/b-mendoza/agent-skills/tree/HEAD/skills/validate-implementation-plan/SKILL.md

## When to use it
- audit an implementation plan for unnecessary technical complexity
- verify requirement traceability without altering source markdown
- isolate fragile technical assumptions before writing code
- generate a standalone markdown audit report with severity findings

## Example prompts
- Audit docs/cache-refactor-plan.md with origin context "Add MVP cache invalidation without new infra"
- Review implementation outline in docs/migration.md and save the report to docs/migration.audit.md
- Run plan audit on docs/feature-spec.md using context from docs/requirements.md

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

---
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