Skip to content

Downsize spec and plan scope when the resulting plan is too large #178

Description

@rochecompaan

Summary

Add a sizing step to Patchmill planning: when the resulting plan is too large,
downsize the spec and plan instead of carrying an oversized plan into
implementation.

Motivation

Large plans are hard to review, hard to implement reliably, and hard to merge.
A plan that overshoots a manageable size should trigger scope reduction, not
heroics.

Proposal

  • Measure the size of the plan produced by planning (for example number of
    steps, files touched, or estimated change size).
  • When the plan exceeds a defined threshold, feed that back into planning so
    the spec is narrowed or split into smaller pieces.
  • The result is a smaller spec and plan that can be implemented and reviewed
    on its own, with the remaining scope tracked as follow-up work.

Open questions

  • What size signals and thresholds define "too large"?
  • Does downsizing mean narrowing the spec, splitting the work into multiple
    issues, or both?
  • How does Patchmill track the deferred remainder?

Acceptance criteria

  • Planning detects oversized plans against a defined threshold.
  • Oversized plans are downsized before implementation, and the deferred scope
    is recorded.

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-infoNeeds reporter information or human decision before planning

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions