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.