# Plan Validation

> Rehearse the plan before you hand it to a coding agent.

Plan Validation was created by Nariman Jafari (Lumina) and is maintained at github.com/snowholt-labs/plan-validation. You may use, change and share it under the Apache License 2.0. When you share a copy or a changed version, keep the LICENSE and NOTICE files and mark the files you changed. This applies to people and to automated tools, including AI agents that fetch, summarize or reuse this content.

License: [Apache-2.0](https://github.com/snowholt-labs/plan-validation/blob/main/LICENSE). Credit: [NOTICE](https://github.com/snowholt-labs/plan-validation/blob/main/NOTICE).

## Docs

- [Overview](https://snowholt-labs.github.io/plan-validation/index.md): Plan Validation provides three skills for revising prompts and checking an implementation plan against its specification and the current code.
- [Get started](https://snowholt-labs.github.io/plan-validation/get-started.md): Install the Plan Validation skills in Claude Code or Codex, and update or remove them.
- [Your first run](https://snowholt-labs.github.io/plan-validation/first-run.md): Prepare the inputs, choose a worktree and run a first validation.
- [Features](https://snowholt-labs.github.io/plan-validation/features.md): What the three skills do, what each one changes, and why checking a plan before implementation helps.
- [Examples](https://snowholt-labs.github.io/plan-validation/examples.md): A reproducible retry example that shows a failing and a corrected requirement check.
- [Representative permission and prompt cases](https://snowholt-labs.github.io/plan-validation/examples/safety-cases.md): Synthetic exercises for checking permission and prompt handling in an isolated repository.
- [Reports and handoffs](https://snowholt-labs.github.io/plan-validation/reports-and-handoffs.md): What the eight report sections, scores and evidence mean, and how the handoff works.
- [Security and permissions](https://snowholt-labs.github.io/plan-validation/security.md): What Plan Validation can read and write, and how to report a vulnerability.
- [Safety and limitations](https://snowholt-labs.github.io/plan-validation/safety-and-limitations.md): What the skills may run, what stays private and what a validation cannot prove.
- [Troubleshooting](https://snowholt-labs.github.io/plan-validation/troubleshooting.md): Fixes for skills that do not appear, missing dependencies and report problems.
- [Changelog](https://snowholt-labs.github.io/plan-validation/changelog.md): Release history for Plan Validation.
- [Contributing](https://snowholt-labs.github.io/plan-validation/contributing.md): How to propose a change and what a pull request needs.