moai-kanban-foreman

Dispatches picked kanban backlog cards to isolated worktree workers and verifies completion evidence.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/taewook486/Masters_degree --skill moai-kanban-foreman-taewook486
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-kanban-foreman
Source: https://github.com/taewook486/Masters_degree/tree/main/.claude/skills/moai-kanban-foreman
Command: npx skills add https://github.com/taewook486/Masters_degree --skill moai-kanban-foreman-taewook486

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running an unattended backlog loop requires a disciplined foreman that never picks work itself, never answers approval gates, and never trusts worker claims without evidence. This Skill automates one safe iteration of that loop: watch the queue, dispatch one card, collect verified results, and report. ## Core Features & Use Cases - Queue Watching: Arms a persistent checksum-based monitor on the backlog file so each change triggers a new idempotent iteration. - Isolated Dispatch: Spawns exactly one write-capable worker per card in its own git worktree, with a fixed-field dispatch block and standing orders (branch rename, lane-local verification, evidence file, no push). - Evidence-Based Completion: Advances a card only after reading verbatim passing output in the worker's evidence file; missing or stale evidence leaves the card picked and reported. - Hard Boundaries: Never adds or picks backlog items, never answers approval gates, never pushes, merges, or deletes branches — blocked decisions are surfaced to the operator. - Use Case: An operator backgrounds a Claude Code session running a bare /loop; the foreman continuously works through operator-picked backlog cards overnight, leaving a report naming branches, worktrees, and blocked decisions for morning review. ## Quick Start Run a bare /loop in the project session and background it so the kanban foreman iterates over the picked backlog queue unattended.

Frequently Asked Questions about moai-kanban-foreman

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an unattended kanban backlog loop in Claude Code?▼

Start a session in the project, run a bare /loop, then background the session so loop tasks keep running without a terminal. Pre-approve the permissions the loop uses (queue reads, git inspection, worker spawn) in project settings, since a permission prompt stalls the unattended iteration.

How does the kanban foreman decide which backlog card to dispatch?▼

It dispatches only the oldest backlog item whose state is already picked, with no live worker and no recorded blocker. Queued items are never picked by the foreman — admitting and picking work is exclusively the operator's action.

Can the foreman run multiple workers in parallel?▼

No. Only one write-capable worker runs at a time, and each worker runs in its own git worktree so nothing writes to the shared checkout. Multi-lane factory dispatch is a reserved seam that is not yet implemented.

What happens when a card needs a human decision mid-loop?▼

The foreman never answers approval gates on the operator's behalf. The card stays picked, is named blocked-for-operator in the iteration report along with the decision it waits on, and the loop moves on.

Why does a completed worker's card sometimes stay picked?▼

Completion is verified by reading the worker's evidence file, never by trusting claims. A missing, unreadable, or stale evidence file is treated as a gap: the card stays picked, the report explains why, and it is not re-dispatched that iteration.

Does the kanban foreman push branches or open pull requests?▼

No. The foreman performs no integration actions — no push, pull request, merge, branch deletion, or worktree disposal. The card's branch stays unpushed and its worktree remains until the operator integrates them.