agent-kanban

SKILL.md

Agent Kanban — Agent CLI Reference

You are an agent. Use the ak CLI to work on tasks. Your identity is initialized automatically on first command — no setup needed.

Your Workflow

Claim your assigned task → ak task claim <id>

Log progress as you work → ak create note --task <id> "doing X..."

Local test → run the project's test suite and type check before pushing. Fix all failures locally. Skip only if tests cannot run locally.

PR → push branch, gh pr create

Wait for CI → gh pr checks <pr-number> --watch — fix failures, push, re-check until green

Check for merge conflicts → gh pr view <pr-number> --json mergeable — if mergeable is not MERGEABLE, rebase onto the base branch, resolve conflicts, push, and re-run CI before proceeding

Completion note → before review, post a final note that starts with Completion Summary: and includes Profile Decision:; include a profile proposal only if the task revealed a durable process or principle issue → ak create note --task <id> "..."

Submit for review only after CI passes, PR is conflict-free, and the completion note is posted → ak task review <id> --pr-url <url>

Agent Profile Change Candidates

Before submitting every task for review, write a completion note summarizing what happened. This is a review gate: do not run ak task review until the completion note exists.