agentleFS
fzfcleefzfclee/consulting-skills/skills/validation-plan/SKILL.md

validation-plan

Skill6 starsChanged 4 months agoApache-2.0View on GitHub

Use when a recommendation, hypothesis, action plan, or business decision needs explicit evidence, tests, decision gates, and continue-adjust-stop criteria. Use when applying validation planning, experiment design, hypothesis test design, decision gates, or learning plan.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill to turn a recommendation into a testable plan with evidence standards and decision gates.

    line 9
  2. Very specific:

    If an input is missing, mark it as missing, state the assumption used, and add a validation action.

    line 27
  3. Very specific:

    Do not use when the user has not yet formed a hypothesis or action option.

    line 31
  4. Distinctive:

    Every validation test must connect to a specific hypothesis.

    line 75
  5. Distinctive:

    Do not use vanity signals such as polite interest when commitment is required.

    line 76
  6. Distinctive:

    Keep the plan realistic for the user's access and timeline.

    line 79

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Validation Plan

Use this skill to turn a recommendation into a testable plan with evidence standards and decision gates.

Method Notes

  • Validation is not the same as implementation. It defines what evidence will increase or reduce confidence.
  • A good validation plan names the hypothesis, test, signal, threshold, owner, timing, and decision rule.
  • It should be proportional to risk: higher-risk decisions need stronger validation.

Required Inputs

Collect or infer these inputs before execution:

  • recommendation or hypothesis to validate
  • decision consequence and risk level
  • available evidence and current confidence
  • feasible tests or evidence sources
  • timeline, owner, and decision deadline

If an input is missing, mark it as missing, state the assumption used, and add a validation action.

When Not To Use

Do not use when the user has not yet formed a hypothesis or action option. Use evidence-map, issue-tree, or hypothesis-tree first.

Step-by-Step Execution

StepRequired inputHow to executeOutput
State the hypothesisRecommendation, expected outcome, current confidence.Write the claim to be validated in one testable sentence.Validation hypothesis.
Define decision consequenceRisk, reversibility, cost of wrong action.Decide how strong the evidence must be before action.Evidence standard.
Select validation methodEvidence sources, access, timeline.Choose interview, document check, commitment test, pilot, prototype, data analysis, stakeholder signal, or market test.Validation method.
Define success and failure signalsHypothesis, expected behavior, thresholds.Make pass, adjust, and stop criteria explicit.Decision criteria.
Plan executionOwner, timing, script or data need, dependencies.Specify who does what by when and with what artifact.Validation workplan.
Decide next gateTest result, action options.Define what decision will be made after evidence arrives.Continue / adjust / stop gate.

Output Template

### 1. Hypothesis To Validate
- Working hypothesis:
- Current confidence:
- Cost of being wrong:

### 2. Evidence Standard
- Required confidence before action:
- Minimum evidence needed:
- Evidence that would weaken the recommendation:

### 3. Validation Plan
| Test | What it validates | Method | Owner / actor | Timing | Pass signal | Adjust signal | Stop signal |
|---|---|---|---|---|---|---|---|
|  |  | interview / document check / pilot / commitment test / data analysis / stakeholder signal / market test |  |  |  |  |  |

### 4. Decision Gate
- Continue if:
- Adjust if:
- Stop if:
- Escalate if:

### 5. Next Step
- First validation action:
- Exact evidence to bring back:

Quality Gate

  • Every validation test must connect to a specific hypothesis.
  • Do not use vanity signals such as polite interest when commitment is required.
  • Define disconfirming evidence, not only confirming evidence.
  • Match validation depth to decision risk and reversibility.
  • Keep the plan realistic for the user's access and timeline.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.