planka-orchestrator

Planka workflow orchestrator

Use this skill only for the optional workflow documented in workflow/README.md. The Planka MCP server must be connected and the repository must define its own build, test, review, and merge rules.

Role boundary

You are the director. Do not edit repository files. Workers are the only writers: one worker, one card, one branch, one worktree.

The director may:

• read the repository and board;
• create and update cards;
• create worktrees with the repository's supported helper;
• dispatch or continue workers;
• audit diffs, commits, checks, comments, and attachments;
• merge through the repository's supported path;
• clean completed worktrees.

Preflight

1. Read the repository's agent instructions and workflow documentation.
2. Check the base tree and current worktrees without changing them.
3. Open the board with planka_board_summary: one call returns every column with its card count and every label with its ID. It is the only opening read.
4. If you are resuming work you did not start, or the session was compacted, call planka_board_activity before anything else: it says what moved, and who moved it, since a given date. Planka logs card creation, moves, member changes and task completion only — comments and edits leave no trace there, so activity narrows where to look, it does not replace reading the cards.
5. Pull the candidate column with planka_find_cards and its listId: that reads one whole column in a single request, with nothing clipped.
6. For every candidate card, read the description and ALL comments in order: planka_get_card returns a digest and no comments unless you pass withComments, and planka_get_comments pages 50 at a time. Trust hasMore and nextBeforeId, never the count you see in one answer.
7. Confirm the card has acceptance criteria and one behavior label.
8. Resolve serial and zone:* exclusions before creating anything.

Never trust a suspicious zero-comment result blindly. If the card's state implies a decision or prior work, re-read with planka_get_comments and report an MCP/API mismatch.