issue-work-loop

Orchestrates a six-phase workflow for taking GitHub issues from discovery to verified close-out.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/t-step/bindle-archive --skill issue-work-loop-t-step
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: issue-work-loop
Source: https://github.com/t-step/bindle-archive/tree/main/skills/issue-work-loop
Command: npx skills add https://github.com/t-step/bindle-archive --skill issue-work-loop-t-step

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working a repository issue end-to-end involves many failure-prone steps: reimplementing already-shipped work, trusting unverified "done" claims, skipping real test gates, and letting implementation permission slide into unauthorized merges or closures. This Skill automates a six-phase contract that prevents each of those failures structurally. ## Core Features & Use Cases - Six-phase orchestration: Orient, discover & qualify, deduplicate, bound & execute, verify, and close out — each phase delegated to a named Bindle-native skill or helper script. - Deduplication before claiming: Runs bin/issue-dedup-scan.sh and reads its exit code (0/3/4/64) to distinguish not-started, evidence-found, and uncertain states before any repository mutation. - Two-authority invariant: Enforces that implementation permission never implies push, PR, comment, close, merge, or release authority — each external mutation requires its own explicit grant. - Workspace isolation: Creates an objective worktree from a fresh origin/main SHA via bin/objective-worktree.sh before any mutating pass, leaving the primary checkout untouched. - Use Case: You run gh issue view 42, decide to work it, and invoke this Skill — it dedups against prior work, isolates a worktree, bounds the scope, runs the repo's real verification gates, and stops at an authority-gated disposition decision instead of auto-closing the issue. ## Quick Start Use the issue-work-loop skill to pick up GitHub issue number 42 in this repository and work it through verification to an honest close-out.

Frequently Asked Questions about issue-work-loop

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

FAQPage Schema
How do I work a GitHub issue end-to-end with Claude Code?▼

Invoke the issue-work-loop skill with the issue number. It runs six phases — orient, discover, deduplicate, execute, verify, close out — delegating each to a Bindle-native skill and stopping at an authority-gated disposition decision before any external mutation.

How does the skill prevent reimplementing already-shipped work?▼

Phase 3 runs bin/issue-dedup-scan.sh before any repository mutation and reads its exit code: 0 means no evidence, 3 means evidence found requiring manual classification, and 4 means a query failed and must never be treated as not-started.

Can the skill merge or close an issue after implementing a fix?▼

No, not by itself. The two-authority invariant makes implementation permission and external mutations (push, PR, comment, close, merge, release) separate grants; each external action needs its own explicit user grant naming that exact action.

When should I not use the issue-work-loop skill?▼

Do not use it for multi-issue scheduling, wave computation, or deciding which issue to work next — those are explicit non-goals. It also never substitutes DomI-fleet tools like check-done or dispatch-issue for any phase.

Why does the skill create a git worktree before making changes?▼

Phase 4 runs bin/objective-worktree.sh to base the work on a fresh origin/main SHA in a dedicated worktree, leaving the primary checkout untouched. Read-only or plan-only passes with an analysis deliverable are exempt.

What happens if verification tests fail during the workflow?▼

Phase 5 reports each check as not run, failed, or passed with no optimistic rounding. A failed state excludes issue closure from the Phase 6 disposition options, since closure criteria are not met.