31 / 139 · 13 Browser Automation with Playwright · Quick Start Preparation: Turn Discovery into a Scaffolding-Ready Package← prev⊞ allnext →☰ Read as one page
2.11Step 7 — Prepare the planning system
The first scaffold should not only create code folders. It should create an operating system for future work.
That means Claude Code should create at least:
docs/plans/active/
docs/plans/completed/
docs/plans/handoffs/
docs/plans/templates/
Required templates
The scaffold should include templates for:
- sprint contract
- execution plan
- evaluator report
What each should contain
Sprint contract
- task name
- linked request or spec
- scope
- out of scope
- acceptance criteria
- validation commands
- expected files to change
- risks and assumptions
Execution plan
- problem statement
- approach
- phases
- progress log
- decisions
- follow-up debt
Evaluator report
- contract reviewed
- commands run
- environment
- pass/fail summary
- evidence
- missing coverage
- recommendation
This makes future long-running agent work much more reliable.