oh-my-issues

Cluster GitHub issue backlogs by root cause into plan-master issues.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/chicago-joe/manymems --skill oh-my-issues-chicago-joe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oh-my-issues
Source: https://github.com/chicago-joe/manymems/tree/main/plugin/skills/oh-my-issues
Command: npx skills add https://github.com/chicago-joe/manymems --skill oh-my-issues-chicago-joe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cluster GitHub issue backlogs by root cause into a small set of plan-master issues, enabling efficient triage, consolidation of duplicates, and a roadmap.

Core Features & Use Cases

  • Cluster by root cause to expose architectural defects
  • Open master plan issues and corresponding design docs under plans/
  • Redirect each symptom to the master plan with a standardized comment
  • Bundle architectural fixes into PRs that close all related children atomically
  • Route new incoming bugs to existing masters as Round N updates

Quick Start

Triage your open issues by root cause, create plan-master issues, and redirect duplicates to their master plan.

Frequently Asked Questions about oh-my-issues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cluster a GitHub issue backlog by root cause?

To cluster a GitHub issue backlog by root cause, you triage reported symptoms and consolidate them into a small set of plan-master issues. This exposes architectural defects and enables efficient roadmap planning by routing duplicates to canonical plans.

What is a plan-master workflow for issue triage?

A plan-master workflow for issue triage is a process where you open master plan issues and corresponding design docs under plans/. You redirect each symptom to the master plan with a standardized comment to consolidate duplicates and manage architectural fixes.

How do I consolidate duplicate GitHub issues into a roadmap?

You consolidate duplicate GitHub issues by clustering them by root cause into plan-master issues. This enables roadmap planning by atomically closing all related children via PRs once the underlying architectural fix is bundled and merged.

Can I route incoming bugs to existing plan-master issues on GitHub?

Yes, you can route new incoming bugs to existing plan-master issues as Round N updates. This applies to repositories with many reported symptoms, allowing continuous triage by redirecting new duplicates to their canonical plans.

Does automated issue triage require creating design docs?

Automated issue triage using this plan-master approach requires creating design docs in a plans/ directory. These docs accompany the plan-master issues to document the architectural fixes needed for the clustered root causes.

What is the best way to close clustered GitHub issues atomically?

The best way to close clustered GitHub issues atomically is to bundle the architectural fixes into Pull Requests. When the PR merges, it closes all related child issues routed to the plan-master simultaneously.