Skip to content

feat: allow bundling small related issues into a single branch/PR #98

Open

Description

@q-soriarty

Description

The current git-workflow skill strictly requires one branch per issue and one PR per issue. In practice, when multiple small, closely related issues belong to the same feature area and have no independent value, forcing separate branches adds overhead without benefit.

Proposed Change

Allow bundling 2-3 small related issues into a single branch and PR when:

  • The issues belong to the same command group or feature area
  • Each issue is small (< 30 min implementation)
  • They share no dependencies with other work
  • They would be reviewed together anyway

The PR should reference all closed issues (Closes #X, Closes #Y, Closes #Z) and the description should clearly separate each issue's contribution.

Example

We encountered this building copia-cli. Phase 3 had three small issues:

Each was ~15 min TDD work, all registered in the same root command, no interdependency. Creating 3 separate branches, 3 PRs, 3 CI runs, 3 merge cycles added significant ceremony for trivial changes.

The bundled approach: one branch with 4 atomic commits (one per issue + wiring), one PR with all 3 Closes references, one review cycle.

Suggested Skill Update

Add a note in the "Issue-Driven Workflow" section:

Small issue bundling: When 2-3 issues are small, closely related, and belong to the same feature area, they may be implemented on a single branch with one PR. Each issue should have its own atomic commit(s), and the PR must reference all closed issues. Use judgment — if any issue could reasonably be reviewed independently, keep it separate.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions