afkkit

Installation
SKILL.md

afkkit

The away-from-keyboard orchestrator. Hand it a groomed ready issue and it drives the middle of the dev workflow from an isolated worktree to an open pull request: implement and commit, verify and review, fix, write a manual QA plan, open the PR, and flip the issue to in-review. The human gates stay where judgment lives: planning and grilling happen before (the ready label is the entry contract), review and merge happen after. Deep code review also happens after: a PR-level review bot covers the diff once the PR opens, so afkkit runs exactly one review round in-span.

afkkit adds no worktree, tracker, or PR behavior of its own. It sequences companion kits (issuekit start at the front, then implementkit, commitkit, reviewkit, qakit, and prkit) and owns exactly one thing they don't: the escalation policy that decides, at every step, whether to keep going or stop cleanly and leave the issue for a human.

The contract

  • Input: an issue number, or all. afkkit invokes issuekit start <n> itself, and issuekit refuses anything not labeled ready, gets the worktree from gitkit (off a freshly resolved base ref, adopting an existing one rather than recreating it), and flips ready → in-progress. That guard is the safety property, and it holds no matter who types the command: an issue only reaches ready after a human grill session, and afkkit can neither promote an issue to ready nor start one that isn't.
  • Output on success: an open PR whose body carries the implementation's documented assumptions, what the acceptance checks confirmed, any unresolved review nits as known follow-ups, and a pointer to a committed QA plan, plus the issue moved to in-review.
  • Output on a blocked run: no PR. The worktree and its commits stay intact, a comment on the issue names the precise stuck-state, the issue is labeled for whoever must pick it up, and, in a batch, the next issue starts. afkkit never publishes half-broken work.

When this fires

  • one issue. "afkkit 42", "run #42 unattended", "autopilot issue 42", "take #42 to a PR".
  • the whole ready queue. "afkkit all", "work the ready issues while I'm away", "drain the ready backlog".

If the user names neither an issue number nor all, ask which. afkkit never plans, grills, merges, or responds to PR review feedback (see Non-goals).

Installs
160
Repository
mimukit/skills
GitHub Stars
1
First Seen
Jul 24, 2026
afkkit — mimukit/skills