next-task
March 25, 2026 ยท View on GitHub
Autonomous workflow orchestrator that takes a task from discovery to production through 12 coordinated phases - exploration, planning, implementation, multi-agent review, and shipping.
Why
Manual development workflows leak time at every handoff: finding the right task, setting up isolated branches, remembering to run tests, reviewing your own code, syncing docs, creating PRs. next-task removes all of that. You select a task and approve a plan; everything after that runs autonomously.
Use cases:
- Pick the highest-priority issue from GitHub/GitLab and ship it end-to-end
- Resume an interrupted workflow from exactly where it stopped
- Run parallel workflows in isolated git worktrees
Installation
agentsys install next-task
Requires agentsys runtime.
Quick Start
/next-task # Start fresh - select source, pick task, approve plan, ship
/next-task --resume # Resume active workflow
/next-task --resume 123 # Resume by task ID
/next-task --resume feature/my-task-123 # Resume by branch name
/next-task --status # Show current workflow state
/next-task --abort # Cancel and clean up
/next-task bug # Filter to bug-labeled issues only
/next-task --base develop # Target a non-default branch
How It Works
The workflow has 12 phases. Phases 1-6 involve the user; phases 7-12 run autonomously.
| Phase | Name | Agent | Model |
|---|---|---|---|
| 1 | Policy Selection | - | - |
| 2 | Task Discovery | task-discoverer | Sonnet |
| 3 | Worktree Setup | worktree-manager | Haiku |
| 4 | Exploration | exploration-agent | Sonnet |
| 5 | Planning | planning-agent | Opus |
| 6 | User Approval | - | - |
| 7 | Implementation | implementation-agent | Opus |
| 8 | Pre-Review Gates | deslop:deslop-agent + prepare-delivery:test-coverage-checker | Sonnet |
| 9 | Review Loop | 4+ parallel reviewers | Sonnet |
| 10 | Delivery Validation | prepare-delivery:delivery-validator | Sonnet |
| 11 | Docs Update | sync-docs:sync-docs-agent | Sonnet |
| 12 | Ship | ship:ship | - |
Human interaction happens exactly three times: source/priority selection (Phase 1), task selection (Phase 2), and plan approval (Phase 6). Everything after Phase 6 is autonomous.
Phase highlights
Task discovery (Phase 2) fetches from GitHub Issues, GitHub Projects, GitLab, or local markdown files. Issues with open PRs are automatically excluded. Tasks are scored by priority labels, severity, and age.
Worktree isolation (Phase 3) creates a git worktree per task so multiple workflows can run in parallel without conflicts.
Multi-agent review (Phase 9) spawns 4 core reviewers in parallel - code quality, security, performance, and test coverage - plus conditional specialists (database, API, frontend, backend, devops, architecture) based on which files changed. Runs up to 5 iterations with stall detection.
Pre-review gates (Phase 8) run deslop (AI slop cleanup) and test coverage checks in parallel before the review loop starts.
Task Sources
| Source | How it works |
|---|---|
| GitHub Issues | gh issue list with label-based scoring |
| GitHub Projects | gh project item-list (v2 boards) |
| GitLab Issues | glab issue list |
| Local file | Scans PLAN.md, tasks.md, TODO.md for unchecked items |
| Custom | CLI, MCP, or Skill tool |
State Management
Workflow state survives session restarts via two files:
{stateDir}/tasks.json- active task registry (in main repo){stateDir}/flow.json- workflow progress (in worktree)
The state directory is platform-aware: .claude/, .opencode/, or .codex/.
Skills
| Skill | Purpose |
|---|---|
| discover-tasks | Fetch, filter, score, and present tasks for selection |
Phases 8-10 use agents from the prepare-delivery plugin:
prepare-delivery:test-coverage-checker (Phase 8), prepare-delivery:delivery-validator (Phase 10).
Requirements
- agentsys runtime
- Git 2.20+ (worktree support)
- GitHub CLI (
gh) for GitHub sources, or GitLab CLI (glab) for GitLab - Node.js 18+
Cross-Plugin Dependencies
| Plugin | Used in |
|---|---|
| deslop | Phase 8 - AI slop cleanup |
| prepare-delivery | Phases 8-10 - test coverage, review orchestration, delivery validation |
| sync-docs | Phase 11 - documentation sync |
| ship | Phase 12 - PR creation, CI, merge |
Related Plugins
- ship - standalone PR and release workflow
- enhance - plugin structure and config analysis
- audit-project - multi-agent code review (standalone)
License
MIT