aio-kanban

!bash "${CLAUDE_PLUGIN_ROOT}/skills/aio-kanban/scripts/kanban-status.sh" 2>/dev/null

Kanban Protocol (v3 — index + per-task files)

Board is a flat index at .kanban/board.md. Each line points to a task file. Tasks live at .kanban/tasks/T-NNN-slug.md with full body (description, criteria, notes).

Follow this protocol exactly. Do NOT adapt or invent your own format.

---

Init

If auto-status above shows "not initialized":

mkdir -p .kanban/archive .kanban/tasks
cat > .kanban/board.md << 'BOARD'
# Kanban Board
<!-- Updated: YYYY-MM-DD -->

## Backlog

## Todo

## Doing

## Done

## Blocked
BOARD

Then inject the kanban guide into CLAUDE.md:

bash "${CLAUDE_PLUGIN_ROOT}/skills/aio-kanban/scripts/kanban-inject.sh"

---

Formats — MUST use verbatim

Board line (one per task)

- [T-NNN](tasks/T-NNN-slug.md) Title — priority/effort

Example:

- [T-052](tasks/T-052-rate-limit.md) Rate limit per endpoint — high/S

Task file (.kanban/tasks/T-NNN-slug.md)

# T-NNN: Title
> One-line description

- **priority**: critical | high | medium | low
- **effort**: XS | S | M | L

## Criteria
- [ ] Acceptance criterion 1
- [ ] Acceptance criterion 2

## Notes
(free-form section — design sketches, links, discussion)

Optional fields (add below - **effort**):

• - **depends**: T-NNN
• - **branch**: feat/branch-name
• - **completed**: YYYY-MM-DD (added when moved to Done)
• - **blocked-by**: reason (added when moved to Blocked)

ID rule: T-NNN, zero-padded, monotonic. NEVER reuse. Slug rule: kebab-case from title, lowercase, alphanumeric+hyphen only, max 40 chars.

---

Workflow Rules

1. Add a task:
   • Pick next ID: highest existing T-NNN + 1.
   • Generate slug from title (kebab-case, ≤40 chars).
   • Create file .kanban/tasks/T-NNN-slug.md with format above.
   • Insert board line under ## Backlog in .kanban/board.md.
2. Refine: move the board line to ## Todo when criteria are defined.
3. Start: move the board line to ## Doing, add - **branch**: ... to the task file. NEVER exceed 2 in Doing.
4. Complete: ALL criteria checkboxes checked → move board line to ## Done, add - **completed**: YYYY-MM-DD to task file.
5. Block: move to ## Blocked, add - **blocked-by**: ... to task file. Review daily.
6. Archive: monthly, cut Done lines AND their task files to .kanban/archive/YYYY-MM/ (board lines into archive/YYYY-MM/board.md, task files into archive/YYYY-MM/tasks/).
7. Update timestamp: every board write updates <!-- Updated: YYYY-MM-DD -->.