moai-kanban-foreman

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running an unattended backlog loop safely is hard: an autonomous agent might pick its own work, answer approval gates meant for humans, run concurrent writers, or trust a worker's claim of completion. This Skill encodes one disciplined kanban foreman iteration with hard boundaries so a bare /loop can run unattended without those failure modes. ## Core Features & Use Cases - Queue watch and dispatch: Monitors the backlog file via a checksum-polling watcher, reads the queue with moai todo list --json, and dispatches only the oldest operator-picked card to a single worker spawned with isolation: "worktree". - Evidence-based completion: Advances a card with moai todo done only after reading the worker's evidence file containing verbatim passing check output and named gaps; missing or stale evidence leaves the card picked. - Hard safety boundaries: Never adds or picks cards, never answers approval gates, never pushes or merges, runs only one write-capable worker at a time, and removes AskUserQuestion so the loop cannot stall on a prompt. - Use Case: An operator backgrounds a Claude Code session running bare /loop overnight; each iteration the foreman checks the queue, dispatches one picked card to an isolated worktree worker, collects its evidence on return, and writes a short report the operator reads on reattach. ## Quick Start Run a bare /loop in the project session to start unattended foreman iterations over the moai todo backlog queue.

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. Each iteration watches the backlog queue, dispatches one picked card to a worktree-isolated worker, and reports results.

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

It dispatches only the oldest card whose state is already picked, with no live worker and no recorded blocker. Queued items are never auto-picked; admitting and picking work is exclusively the operator's action.

Can the loop answer approval gates or pick work on its own?▼

No. AskUserQuestion is removed from the tool pool, and any card needing an unrecorded human decision is left picked and reported as blocked-for-operator. The foreman never runs moai todo add or moai todo next.

How is worker completion verified before closing a card?▼

Completion is read, never trusted: the foreman reads the worker's evidence file and advances the card only when verbatim passing check output is present and gaps are named. Missing, unreadable, or stale evidence leaves the card picked.

Why does the queue watcher poll with checksums instead of file events?▼

The backlog file is replaced atomically on every mutation, so tools following a single file handle miss changes. A checksum poll every five seconds emits one line per change at minimal cost and survives atomic replacement.

What are the limitations of the kanban foreman loop?▼

It spawns only one worker per card with no multi-lane factory fan-out, performs no integration actions like push or merge, and expires seven days after creation. Background monitors also do not survive a session resume and must be re-armed.