name: test-plan-writer
description: Write a validation plan for a change, including automated tests, manual checks, regression coverage, and exploratory testing. Use it when you need to scope verification quickly before a PR.
Test Plan Writer
Purpose
Create an actionable test plan tailored to the change.
Core Principles
- Scope validation by user impact, not just implementation details.
- Separate automated checks from manual validation.
- Cover both success and failure flows.
- Prioritize paths with the highest regression risk.
- Include visual validation whenever the UI changes.
- Decide in advance what evidence will prove validation, such as command output, logs, or screenshots.
- Change summary
- Affected files or modules
- User impact or risk
- Available test tools or environment details, if available
Workflow
- Identify the user flows and system paths affected by the change.
- Pull out the highest-risk scenarios first.
- Separate what can be covered by automated tests from what needs manual validation.
- Add failure, exception, permission, and boundary-value cases.
- Include regression checks for existing behavior.
- Document what evidence should be captured from validation.
Test Goal
- Behavior this validation is meant to protect
Impact Scope
- User flows
- System or module impact
Priority
- High: scenarios that must be checked
- Medium: scenarios that should be checked if possible
- Low: scenarios to check if time allows
Automated Validation
- Commands to run
- Test types to cover
- Expected result
Manual Validation
- Core scenarios
- Failure or exception scenarios
- Permission or boundary-value scenarios
Regression Checks
- Existing areas that need rechecking
- Related feature checkpoints
Visual Validation
- Screen states to inspect
- Screenshots or other evidence to capture
Preconditions
- Required data
- Required accounts or permissions
- Environment variables or setup steps
Exit Criteria
- What must pass to consider validation complete
- Residual risks that remain
- Draft the most complete test plan possible with the available context.
- Split missing environment details into explicit assumptions.
- Limit follow-up questions to three.