Kanban board

Use scripts/kanban.mjs as the shared renderer. Do not hand-edit generated HTML.

Workflow

Create or update a kanban.json in the target project. Treat it as the source of truth: never invent cards, themes, notes, links, or column assignments.
Install the managed lifecycle block into the project-root CLAUDE.md for Claude Code and AGENTS.md for Codex. Use scripts/install-lifecycle.mjs <project-directory> --agent claude|codex|both; it preserves existing instructions and replaces an existing marked block instead of duplicating it.
Use workflow.planning, workflow.active, workflow.review, and workflow.completed to map lifecycle events to the project's actual columns. If workflow is missing, ask for or establish the mappings before moving a card; do not guess based on a column name.

Build the board:

/path/to/kanban/scripts/kanban build kanban.json --out kanban.html

At work start, launch the local board server in the background. It selects an available random port and opens the browser for the user: