systemic-issue-triage

by Gentleman-Programming7.8k

Developer Tools

Trigger: new issue, bug report, triage, backlog, issue flood, community report, root cause, dead-end, blocked user. Attack issues by root class, never one-by-one; fixes must shrink the system, not gro

Install

The skill file stays in the publisher's repository.

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

npx skills add Gentleman-Programming/gentle-ai --skill systemic-issue-triage -a cursor -y

Download skill internal/assets/skills/systemic-issue-triage/SKILL.md on GitHub

Related skills

View all

Questions

How do I install systemic-issue-triage?: Download internal/assets/skills/systemic-issue-triage/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does systemic-issue-triage live?: The publisher keeps it at https://github.com/Gentleman-Programming/gentle-ai.
Which agents can use systemic-issue-triage?: Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.

name: systemic-issue-triage description: "Trigger: new issue, bug report, triage, backlog, issue flood, community report, root cause, dead-end, blocked user. Attack issues by root class, never one-by-one; fixes must shrink the system, not grow it." license: Apache-2.0 metadata: author: "Alan-TheGentleman" version: "1.0"

Systemic Issue Triage

Activation Contract

Use when triaging incoming issues, planning fixes for a backlog, or deciding how to respond to any bug report. The failure mode this skill exists to prevent: fixing symptoms one-by-one until the system becomes over-engineered machinery that grows exponentially and nobody can maintain.

Situation	Action
3+ issues, same subsystem	One cluster exploration → one chained fix batch, slices by root not by issue
Issue matches an in-flight redesign	Bucket A; close at delivery with the named test; offer the current workaround (e.g. kill switch) meanwhile
Fix wants a new state/flag/verb	Redesign: what can be deleted or relaxed instead?
Dead-end report (no exit)	Highest severity class; the fix is an exit, not a guard
Reporter's value not reproducible from code	Make the message self-diagnosing, then ask the reporter for their exact input
Test written against the issue's mechanism passes on unmodified main	The diagnosis is wrong, the report is not. Strengthen the test until it drives the real surface
One thread, two failure modes	Comment naming both and what each waits on; close neither
A gate ships without the change that satisfies it	Highest severity: the population it blocks cannot even reproduce their other issues

systemic-issue-triage

Install

Related skills

Questions

Systemic Issue Triage

Activation Contract

Label and action authority

Hard Rules

Decision Gates

Output Contract