ag-pipeline-issue

Converts GitHub Issues into SPECs, plans, builds, verifications, and tests.

19|4|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/andregusman-raiz/a-gusman-claude --skill ag-pipeline-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ag-pipeline-issue
Source: https://github.com/andregusman-raiz/a-gusman-claude/tree/main/skills/ag-pipeline-issue
Command: npx skills add https://github.com/andregusman-raiz/a-gusman-claude --skill ag-pipeline-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub Issues often end up as vague tasks. This Skill ensures every issue is converted into a formal SPEC and a complete, verifiable workflow from planning to delivery, preventing work without clear definitions and traceability.

Core Features & Use Cases

  • Fetch Issue: pull complete context from GitHub (title, body, labels, assignees, comments).
  • SPEC generation: create a technical SPEC linked to the issue.
  • Plan, Build, Verify, Test: orchestrate sequential phases with gates and checks.
  • Artifact generation: save docs/specs/issue-[number]-spec.md and docs/specs/issue-[number]-plan.md.
  • Traceability & governance: enforce close with evidence of verification and testing.
  • Reproducible builds: branch-per-issue workflows for isolation.

Quick Start

Invoke the Agent tool with subagent_type ag-pipeline-issue and provide the GitHub issue number to start the end-to-end pipeline.

Frequently Asked Questions about ag-pipeline-issue

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

FAQPage Schema
How do I turn GitHub Issues into a structured development pipeline?

To turn GitHub Issues into a structured pipeline, you can automate issue handling by converting them into formal SPECs, plans, builds, and verifications. This guides issues through a seven-phase pipeline from fetch to close.

What artifacts are generated when converting a GitHub issue into a spec?

Converting a GitHub issue into a spec generates technical artifacts like docs/specs/issue-[number]-spec.md and docs/specs/issue-[number]-plan.md. These files ensure traceability and provide a formal definition for the planned work.

How do I enforce verification and testing before closing GitHub issues?

To enforce verification and testing before closing GitHub issues, the pipeline applies sequential phases with gates and checks. It requires evidence of successful validation and testing to enforce traceability and governance during issue closure.

Can I isolate builds for individual GitHub issues using a branch-per-issue workflow?

Yes, you can isolate builds for individual GitHub issues using a branch-per-issue workflow. This approach supports reproducible builds by guiding each issue through its own isolated branch within the end-to-end pipeline.

Does the pipeline support pulling complete context like labels and comments from GitHub Issues?

Yes, the pipeline supports pulling complete context from GitHub Issues. During the fetch phase, it extracts the title, body, labels, assignees, and comments to ensure the generated SPEC and plan have full contextual background.

Why do vague GitHub Issues cause problems in software delivery?

Vague GitHub Issues cause problems because they often lead to work without clear definitions or traceability. Converting them into a formal SPEC and a verifiable workflow prevents unstructured development and ensures governance from planning to delivery.