Templates

Project Improvement Playground

Use this to choose a real project slice.

Source: templates/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.