AFK Coding Pipeline

afk — AFK Coding Pipeline for Claude Code

A Claude Code plugin that makes the AFK coding pipeline the path of least resistance: human judgment at the edges, agent execution in the middle. You align on the spec, the agents ship it, you review the PR.

Built for developers who haven't yet found a good workflow with AI coding agents. Install it, and the failure modes that ruin big AI-built features — context overflow, skipped tests, never-happening refactors, unreviewed slop — get caught by the pipeline instead of by your users.

The pipeline

1. Align on spec        ── HITL ──  AI interviews YOU, writes the PRD
2. Slice the ticket     ── HITL ──  vertical slices, you approve the cut
3. Implement per slice  ── AFK  ──  fresh-context TDD loop + spec review per slice
4. Refactor pass        ── AFK  ──  the step LLMs always skip
5. Agentic QA           ── AFK  ──  drives the real surface: browser, API, or CLI
6. Review               ── AFK  ──  risk-tiered multi-agent review
7. PR + handoff         ── HITL ──  you review, business does UAT

Small tickets (1–3 points) skip all of this — the plugin's session-start bootstrap teaches Claude to size the ticket first and only reach for the pipeline at 5 points and up.

Install

Installation differs by harness: Claude Code or GitHub Copilot CLI. If you use both, install afk separately for each one.

Claude Code

Prerequisite: Claude Code installed and authenticated. If /plugin doesn't exist in your session, update Claude Code first.

1. Add this repo as a plugin marketplace (one-time, inside any Claude Code session):

/plugin marketplace add alexanderop/afk

2. Install the plugin:

/plugin install afk@afk

3. Verify it's loaded — run /help; you should see the skills listed under the afk: namespace. The session-start bootstrap (ticket sizing + skill routing) is active from your next session onward.

4. First run in a project:

/afk:setup

Updates ship via the marketplace: /plugin marketplace update afk.

GitHub Copilot CLI

Copilot CLI reads the same plugin format. In your terminal:

1. Add this repo as a plugin marketplace (one-time):

copilot plugin marketplace add alexanderop/afk

2. Install the plugin:

copilot plugin install afk@afk

3. Verify it's loaded:

copilot plugin list

Skills written for afk use Claude Code tool names; Copilot CLI maps them automatically via skills/using-afk/references/copilot-tools.md. Update later with copilot plugin update afk.

The plugin's hooks emit Copilot's output format too, but Copilot CLI has a known bug where plugin-shipped hooks are listed at startup yet never execute (copilot-cli#2540). Two backstops cover this: /afk:setup embeds the ticket-sizing gate in your project's CLAUDE.md (which Copilot reads in every session), and you can load the using-afk skill manually — type / and pick it from the skill list — to inject the full bootstrap.

Try it without installing

git clone https://github.com/alexanderop/afk
claude --plugin-dir ./afk

This loads the plugin for that session only — useful for kicking the tires or hacking on the plugin itself (edit + /reload-plugins to pick up changes).

Quickstart

In any project:

/afk:setup                      # one-time: backpressure audit (tests, lint, types)
/afk:pipeline build a multi-step booking wizard

Claude interviews you for the spec, proposes vertical slices, and after your approval runs implementation, refactoring, QA, and review without you — then opens a PR with the QA and review reports attached.

Skills

Skill	What it does
/afk:setup	Audits & fixes backpressure, records the project's QA surface, crafts a lean WHAT/WHY/HOW CLAUDE.md, stands up the .afk/brain/ knowledge vault
/afk:spec	Interview-mode PRD — AI asks, you answer, one question at a time
/afk:slice	PRD → vertical slice tickets (UI + API + test, each shippable)
/afk:ralph	Fresh-context TDD subagent loop per slice, with independent spec review
/afk:refactor-pass	Dedicated cleanup pass: duplication, dead code, type holes
/afk:qa	Walks happy + negative paths from the spec on the project's real surface — agent-browser for UIs, curl for pure APIs, real invocations for CLIs — evidence-backed report
/afk:review	Risk-tiered review: security/quality/performance/docs specialists + judge pass
/afk:pipeline	The meta-skill — runs all of the above end to end
/afk:reflect	Banks learnings: lint rule → script → CLAUDE.md → .afk/brain/ note → skip

Customizing for your team

Both extension points live in your repo, versioned with the code and shared by everyone on the team — no plugin fork, no reinstall.