issue-resolver

The Issue Resolver AI is a specialized tool designed to streamline the lifecycle of GitHub issues by applying Specification Driven Development (SDD) principles. It acts as an intelligent bridge between raw issue reports and actionable development tasks. The skill is intended for software engineers and project leads who require structured, trace-linked resolution paths for bugs, feature requests, and refactoring tasks. By automating the classification and planning stages, it significantly reduces the cognitive overhead of triaging project backlogs and ensures that every resolution aligns with formal requirement definitions.

• Automatically categorizes issues into Bug, Feature, Documentation, Refactor, or Unknown types.

• Extracts requirements from issue bodies using checkbox parsing and keyword analysis.

• Generates semantic branch names and structured SDD resolution plans.

• Performs impact analysis to estimate scope, effort, and risk factors.

• Provides a robust CLI interface via musubi-resolve for one-command issue-to-PR workflows.

• Generates comprehensive markdown-based resolution reports including affected components and dependencies.

• Integrates seamlessly with other MUSUBI skills like Requirements Analyst and Test Engineer to support full traceability from issue to code.

• Inputs: GitHub issue data (number, title, body, labels, assignees) provided via the IssueInfo class.

• Outputs: Actionable resolution plans, semantic branch identifiers, requirement lists, and impact assessments.

• Usage: Ideal for teams practicing SDD, utilizing the IssueResolver module within Node.js environments or invoking commands via CLI.

• Constraints: Requires consistent formatting in GitHub issue bodies (e.g., standard markdown checkboxes) for optimal requirement extraction.

• Operational tips: Pair this skill with musubi-requirements for EARS-compliant documentation generation and musubi-trace for full mapping from requirements to implementation.