afk-batch

A Claude Code and Codex workflow suite for turning one GitHub spec into one reviewable PR.

This plugin ships the runner layer — implement-spec plus the PR review helpers. The planning layer (idea → spec → tickets) comes from Matt Pocock's skills, installed separately and used as-is; this plugin only adds the repo conventions that make their output runnable.

The default flow is:

1. wayfinder or grill-with-docs (upstream) — clarify the idea. Use wayfinder for large/foggy efforts; use grill-with-docs for focused codebase-backed ideas.
2. to-spec (upstream) — synthesize the discussion into a GitHub spec, following this repo's conventions ([Spec] title, ## Success Criteria, agent-ready label only when autosufficient).
3. to-tickets (upstream, optional) — split the spec into tracer-bullet child tickets (native sub-issues + blocked-by relationships) only when it is too large to implement directly.
4. /implement-spec <spec> (this plugin) — implement exactly one spec, with independent code review per unit, dependency-wave scheduling, final integration review, and one self-contained PR body containing criteria verdicts, file cohorts by intent, review guardrails, and a GitHub QA checklist. Depending on your install, the command is namespaced: /afk-batch:implement-spec (if a bare /implement-spec says "Unknown command", use the namespaced form).
5. Human review and merge — the runner opens PRs but never merges them.

pr-rabbit and pr-walkthrough remain available for auditing or explaining an existing PR. The old /afk-batch backlog-draining command is still shipped for compatibility, but new work should use /implement-spec.

Install

1. Install Matt Pocock's skills (pick one):

npx skills@latest add mattpocock/skills

/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock

2. Install this plugin:

/plugin marketplace add 64ix/claude-afk-batch
/plugin install afk-batch@claude-afk-batch

Or cherry-pick the skills (not the runner command/workflows) via skills.sh:

npx skills@latest add 64ix/claude-afk-batch

3. Per repo, run /setup-matt-pocock-skills (tracker, labels, domain docs), then /setup (runner commands + spec conventions).

Local Claude development:

claude --plugin-dir ./plugins/afk-batch

Codex development uses the repo-local plugin manifest at plugins/afk-batch/.codex-plugin/plugin.json.

Layout

.claude-plugin/marketplace.json
plugins/afk-batch/
├── .claude-plugin/plugin.json
├── .codex-plugin/plugin.json
├── commands/
│   ├── implement-spec.md
│   └── afk-batch.md                 # legacy backlog runner
├── skills/
│   ├── implement-spec/
│   ├── pr-rabbit, pr-walkthrough/
│   └── setup, ask, NOTICE.md
├── workflows/
│   ├── spec-implement.js
│   └── afk-implement.js             # legacy backlog workflow
└── README.md

Status

v0.8 — planning skills delegated to upstream mattpocock/skills (this plugin no longer bundles copies); child tickets and dependencies are discovered through native GitHub sub-issues / blocked-by relationships with ## Parent / ## Blocked by text fallback. GitHub-first: implement-spec targets GitHub Issues and PRs via gh.