Trello Orchestrator Runner
Use deterministic Trello lifecycle control with trello-workflow-map.json.
Inputs required
TRELLO_API_KEYTRELLO_TOKENtrello-workflow-map.jsonin workspace root
Hard rules
- Manager-only intake: create/update objective card in
Inbox. - Move flow in order:
Inbox -> Scoped -> Ready -> In Progress (Local|Remote) -> In Review -> Done|Blocked
- Local-first routing by default (
In Progress (Local)). - Remote is escalation-only (
In Progress (Remote)). - Never move to
Donewithout explicit reviewer ACCEPT against original objective. - On reject, move back to active in-progress list and continue loop until ACCEPT or explicit stop/block.
Required card description fields
Ensure card desc includes:
- objective
- acceptance_criteria
- owner_agent
- execution_mode
- escalation_reason
- expected_files_modules
- risk_level
- test_plan
- review_outcome
Deterministic Trello API patterns
- Create card:
POST /1/cardswithidList,name,desc
- Move list:
PUT /1/cards/{cardId}/idList?value={listId}
- Add comment:
POST /1/cards/{cardId}/actions/commentswithtext
- Update desc:
PUT /1/cards/{cardId}withdesc
Execution loop
- Parse objective.
- Create/locate epic card in
Inbox. - Scope (planner) -> move to
Scoped, comment scope summary. - Route (manager) -> move to
Ready, comment local/remote decision. - Start builder:
- local default -> move to
In Progress (Local) - escalation -> move to
In Progress (Remote)
- local default -> move to
- Review -> move to
In Review, add review findings. - Decision:
- ACCEPT -> set
review_outcome: accepted, move toDone - REJECT -> set
review_outcome: rejected, move back to in-progress and continue - BLOCKED -> move to
Blockedwith explicit reason
- ACCEPT -> set
Output back to user
Return:
- card id + URL
- current list
- routing mode (local/remote)
- reviewer verdict
- next action