builder-playground.md

Project Improvement Playground

Use this to choose a real project slice.

Project

Repo:
What it does:
Primary language/framework:

Current pain

What keeps showing up?

• recurring bug:
• flaky test or build:
• repeated review comment:
• confusing subsystem:
• slow workflow:
• risky change area:

Why this slice

• I care about it because:
• It is small enough because:
• It is real enough because:
• I can tell whether the output is good because:

Terrain

Systems involved:

People affected:

• users:
• maintainers:
• operators:
• reviewers:

Blast radius if wrong:

Constraints

Hard constraints:

Soft constraints:

Assumed constraints to question:

First evidence

What check, repro, trace, or test would prove the current behavior is wrong?

Search requirement

Before implementing, compare at least one option at each level:

• Band-Aid;
• Local Optimum;
• Reframe;
• Redesign.