writing-planslisted
Install: claude install-skill zzunkie/yardlet
# Writing Task-Internal Plans
## Purpose
Turn one accepted Yardlet task into a small, testable implementation plan. The
intent contract and work queue already own project-level decomposition. Do not
replace them, expand the task, or create a second queue.
## Scope First
1. Read the task's allowed scope, exclusions, acceptance criteria, and anchors.
2. List the files and interfaces likely to change.
3. Stop and report a blocker if acceptance requires work outside the contract.
4. Put adjacent ideas in the handoff or follow-up candidates, never into the
active implementation plan.
## Plan Shape
Write the plan in the worker's normal progress channel unless the task requires
a durable plan file. Each step must contain:
- one independently checkable outcome;
- exact files or interfaces involved;
- the narrow validation that proves the step;
- dependencies on earlier steps;
- any safety or no-clobber constraint that applies.
Prefer the smallest useful sequence:
1. Add or identify a failing check for the required behavior.
2. Make the minimal implementation change.
3. Run the narrow check.
4. Run the relevant regression suite.
5. Compare the actual result with every acceptance criterion.
## Concrete Detail
A useful plan names real paths, types, commands, and expected results. Avoid
placeholders such as `TODO`, "handle edge cases", or "add tests" without naming
the behavior and proof. Follow existing repository patterns and avoid unrelated
refactors.
## Review Boundary