issue-driven

Automate GitHub issue-driven workflows with phase notes and PR linking.

Updated Sep 21, 2025
One-click install
npx skills add https://github.com/hmjn023/solid-imager --skill issue-driven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-driven
Source: https://github.com/hmjn023/solid-imager/tree/main/.opencode/skills/issue-driven
Command: npx skills add https://github.com/hmjn023/solid-imager --skill issue-driven

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub Issues are used as the primary source of truth for task definitions and progress auditing in an autonomous development workflow, enabling teams to document investigations, plans, implementations, and reviews within each issue lifecycle.

Core Features & Use Cases

  • Issue-driven workflow: Use issues to define tasks, track progress, and attach notes at each phase (Investigate, Plan, Implement, Review, Submit, Done).
  • Audit trails & accountability: Each phase generates notes (Investigation, Plan, Implementation, Review) that serve as a trace of decision-making and changes.
  • PR linkage & automation: Create and link pull requests to the corresponding issue, automatically update status, and move the issue along its lifecycle.

Quick Start

Create or select a GitHub issue to begin the workflow and follow Investigate, Plan, Implement, Review, Submit, and Done steps, posting notes and moving the issue through stages as you go.

Frequently Asked Questions about issue-driven

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

FAQPage Schema
How do I automate development workflows using GitHub Issues as the primary source of truth?

Automating development workflows with GitHub Issues requires defining tasks and tracking progress through structured phases. This Skill uses issues to drive the lifecycle, logging notes at each stage from investigation to submission, and linking pull requests to maintain full audit trails.

What is an issue-driven development workflow and how does it track progress?

An issue-driven development workflow uses GitHub Issues as task definitions and audit trails. It tracks progress by generating phase-specific logs—Investigation, Plan, Implementation, and Review—within each issue, ensuring decision-making and changes are fully traceable.

How do I link a pull request to a GitHub issue automatically during the review phase?

To link a pull request to a GitHub issue automatically, the workflow moves the issue through its lifecycle stages and submits changes via PRs. This creates a direct connection between the implementation and the original task definition for accountability.

Can I use this autonomous dev workflow for structured issue-based progress tracking?

Yes, this workflow supports structured issue-based progress tracking by enforcing clear guardrails. It moves issues through Investigate, Plan, Implement, Review, Submit, and Done phases, satisfying requirements for traceable workflow automation with phase-specific logs.

What are the limitations of using GitHub Issues for autonomous development workflow automation?

Using GitHub Issues for autonomous workflow automation requires strict adherence to the defined lifecycle phases. The process depends on generating phase-specific notes and linking PRs, meaning workflows outside this structured Investigate to Done path may not be fully traceable or supported.

Does this issue-driven workflow require any specific dependencies or components to function?

No specific dependencies or components are required to start the issue-driven workflow. You only need a GitHub issue to begin, following the defined Investigate, Plan, Implement, Review, Submit, and Done steps to post notes and track the lifecycle.