auto-issues

Orchestrate sequential issue workflow phases and commit changes in isolated worktrees.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/KMakayee/playbook --skill auto-issues
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: auto-issues
Source: https://github.com/KMakayee/playbook/tree/main/.claude/skills/auto-issues
Command: npx skills add https://github.com/KMakayee/playbook --skill auto-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, bash, claude, and includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of manually coordinating a complete issue workflow across multiple phases (research, plan, implement, update, then commit) for issue-driven engineering work.

Core Features & Use Cases

  • End-to-end issue pipeline orchestration: Runs research, plan, implement, and update sequentially, ensuring the required artifacts are produced at each phase.
  • Dedicated worktree workflow: Executes fully inside an existing worktree-issue-<N> worktree, deriving the issue number from the branch name to keep runs isolated.
  • Integrity validation and audit trail: Writes per-phase logs to tasks/logs/, generates an eval verdict via pipeline-eval.sh, and enforces artifact existence and minimum content thresholds.

Quick Start

Run /auto-issues from inside your issue’s dedicated worktree branch named worktree-issue-N so the pipeline can derive N, execute all phases, and commit the resulting changes.

Frequently Asked Questions about auto-issues

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

FAQPage Schema
How do I automate a git issue workflow from research to final commit?▼

You automate an issue workflow by running sequential phase orchestrations for research, plan, implement, and update inside an isolated worktree. The pipeline enforces strict artifact validation and completes with a single-session inline git add, commit, and push.

What is an issue pipeline orchestration and how does it handle code review artifacts?▼

An issue pipeline orchestration sequentially executes research, planning, implementation, and updating phases to produce required engineering artifacts. It validates these artifacts against minimum content thresholds and writes per-phase logs to ensure a strict audit trail for the code review process.

Do I need a specific git branch naming convention to run issue pipeline automation?▼

Yes, issue pipeline automation requires a dedicated git branch named worktree-issue-<N>. The pipeline derives the issue number directly from this branch name to keep execution isolated and correctly map the automated phases to the specific issue.

Can I use Claude and bash scripts to orchestrate multi-phase engineering tasks?▼

Yes, you can use Claude and bash scripts to orchestrate multi-phase engineering tasks through per-phase Claude Codex invocations. The pipeline uses bash scripts to manage the sequential execution, generate an eval verdict, and validate logs and artifacts produced during each phase.

How do I validate artifact integrity and logs during automated issue resolution?▼

You validate artifact integrity and logs during automated issue resolution by enforcing artifact existence and minimum content thresholds at each phase. The pipeline writes per-phase logs to a tasks/logs directory and generates a final evaluation verdict using a dedicated validation script.

What are the limitations of automating issue pipelines inside isolated worktrees?▼

Automating issue pipelines inside isolated worktrees requires strict sequential phase orchestration and an existing worktree-issue-<N> branch. The pipeline cannot run without deriving the issue number from the branch name and depends on per-phase Claude Codex invocations for execution.