issue-ingest

What problem does it solve?

Manually processing GitHub issues—triage, root cause identification, and spec writing—is slow, inconsistent, and often leads to misaligned fixes that waste engineering time and delay delivery.

Core Features & Use Cases

• Structured Issue Intake: Automatically parses GitHub issue URLs into normalized intake notes with observed behavior, expected behavior, reproduction steps, and environment context, flagging missing information as needed.
• Confidence-Scored Root Cause Localization: Generates falsifiable root cause hypotheses, validates top candidates via specialized codebase agents, and prunes to a single high-confidence root cause.
• Testable Spec Generation: Produces standards-aligned resolution specs with requirement numbering, Given/When/Then scenarios, built-in clarification funnels, and optional QA gate selection, with automatic transitions to planning or full fix workflows when requested.
• Use Case: A developer receives a bug report GitHub issue; running this skill automatically fetches the issue, identifies the responsible code area, generates a testable fix spec, and moves directly to implementation planning if the plan=true flag is set.

Quick Start

Use the issue-ingest skill to process the GitHub issue at https://github.com/your-org/your-repo/issues/456 and generate a resolution spec with root cause analysis and optional transition to planning.