symphony-trello: Skill for Codex

Symphony Board Cards

The symphony-trello card commands read the board's Trello key and token themselves and never print them. Work only through these commands: the .env files and any secret file a workflow names stay unread, because the commands never need you to see a credential.

Steps

1. Run symphony-trello status to see the connected boards. When more than one board is connected, pass --board NAME to every card command, with a board name that status shows.
2. Run symphony-trello card list --board NAME --json to learn the lists, their roles, where moves and new cards are allowed, and the open cards.
3. Run the card command the request needs. Add --json whenever you read the output, and name each card by its title and URL in your answer.

Commands

CARD is a card id, a short link, or a https://trello.com/c/ URL. LIST is an open list name or a role: active, in-progress, human-review, blocked, merging, or terminal. A list name wins over a role name.

Rules

• When the user does not name the list for a new card or a move, and the list roles from card list leave more than one list that fits, ask the user which list to use. Never guess a list.
• Archive a card only after the user confirmed that exact card, by title, in this conversation. Pass that title as --confirm-title; the command refuses a title that differs from the card's. Trello keeps archived cards, and the board menu restores them.
• The workflow's trello_tools settings decide where cards may move and start. A failure prints setup_failed code=CODE message=... and exits with 2. These codes mean a setting refused the write: trello_tools_disabled, trello_writes_disabled, trello_comments_disabled, trello_move_not_allowed, trello_move_allowlist_required, and trello_create_list_not_allowed. For them, tell the user which setting refused the write; edit the workflow only when the user asks for that.
• Any other code, such as trello_auth_failed or trello_api_request, is not a workflow setting. Tell the user the message and the Next step: line that follows it, and leave trello_tools alone.
• In a Symphony worker run on a card, where the trello_move_current_card tool exists, handle that card with the worker's trello_* tools.