# Batch Issues

> Batch-process open GitHub issues with parallel agents. Analyzes conflicts, dispatches workers, creates PRs. Usage: /batch-issues [issue numbers] [--dry-run] [--max-parallel N]

- Skill: `future-architect/batch-issues` (Agent Skill)
- Install (CLI): `npx skillmds@latest add future-architect/batch-issues`
- Raw SKILL.md: https://api.skillmd.com/api/skills/future-architect/batch-issues/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: future-architect (https://skillmd.com/u/future-architect)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/future-architect/batch-issues

---


# /batch-issues -- Parallel Issue Dispatcher

> **Full specification**: See `.github/prompts/batch-issues.prompt.md` for the complete
> procedure, conflict analysis, agent workflow, and safety rules.

## Quick Reference

- **Auto-select**: `/batch-issues` -- pick open issues, analyze conflicts, dispatch
- **Specific issues**: `/batch-issues 168 171 187` -- process these issues
- **Dry run**: `/batch-issues --dry-run` -- show plan only
- **Limit parallelism**: `/batch-issues --max-parallel 2`
- Phase 1: Issue selection & filtering
- Phase 2: Conflict analysis (shared file detection)
- Phase 3: Size/risk assessment (S/M/L classification)
- Phase 4: Dispatch plan (present to user)
- Phase 5: Agent dispatch (worktree-isolated, parallel across groups, sequential within)
- Phase 6: Summary report with PR links
- Phase 6.5: Orchestrator review — run `/review-until-clean` on each PR (agents can't launch independent reviewers)
- Phase 7: Evidence verification — check/fix Before/After test output in every PR body
- Each agent: reproduce (MANDATORY) -> architect -> implement -> self-check -> verify after (MANDATORY) -> before/after PR (template enforced)
- Independent review runs at orchestrator level (Phase 6.5), NOT inside agents