Skip to content

Improvement Deduping

Framework improvement issues should be high signal. Duplicate creation lowers trust fast.

Deduping Rule

Before drafting a new issue, ORCA Framework should check:

  • existing GitHub issues when access is available
  • local improvement backlog entries
  • ecosystem opportunities and watch docs when the item overlaps scheduled maintenance
  • recent session candidates that describe the same friction

Likely Duplicate Signals

  • same command or doc surface
  • same missing capability
  • same host-specific limitation
  • same workaround repeated with no materially new angle

What To Do When Overlap Exists

  • If the existing issue is still the right target, append context instead of opening a new issue.
  • If the session adds materially new evidence, record that evidence and link the existing issue.
  • If the overlap is partial, draft a note that explains what is new versus already tracked.

Use templates/related-issue-note.md.