القائمة
Manage team kanban boards and tasks. Use when creating, moving, filtering, getting, or editing tasks. Trigger with /team-kanban. Loaded by ai-maestro-plugin
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Batch-approve, refuse, or archive TRDD proposals — move them between the four design/ zones (proposals/ to tasks/ on approve; to refused/ on refuse; to archived/ on complete/cancel/supersede). GATED: only a MANAGER (or solo USER) may approve/refuse/archive; the COS relays but does not approve; list is open to all. Use when a MANAGER drains the proposal queue or archives a finished/cancelled/superseded TRDD. Trigger with /ama-proposal-approvals, 'list pending proposals', or 'approve proposals 4,6'. Column moves within tasks/ are /ama-trdd-transition.
Search, read, verify, and server-mediated mutate TRDDs via the aimaestro-trdd.sh CLI — the AI Maestro dashboard's authorization-aware view of the design/ corpus. Write verbs (edit / approve / refuse / promote / archive) are STRICT, gated by each TRDD's min-approval-requirement with a hard self-approval ban. Use when server-mirrored state or server-side authorization matters: the dashboard kanban, approving a proposal, confirming an approval is real. Trigger with /ama-trdd-server, 'approve this TRDD', 'search TRDDs on the dashboard'. For local design/ file editing use ama-trdd-find/write/update/transition. Loaded by ai-maestro-plugin
Move a TRDD between kanban columns (the 14-stage pipeline plus blocked/failed) — enforcing the transition matrix: who may trigger each move, the frontmatter side-effects it requires, and the AMP broadcast it sends. Each move is role-gated (ORCH dispatches, ARCH designs, INTEGRATOR owns the ->complete flip, assignee signals dev->testing, MEMBER is signal-only). Use when advancing a task through the pipeline. Trigger with /ama-trdd-transition, 'move TRDD X to testing', 'dispatch this task', or 'mark it blocked'. Authoring is /ama-trdd-write, editing /ama-trdd-update, rendering /ama-kanban-render.
Author a new TRDD task-design document under design/ with correct v2 frontmatter — uuid + timestamps, the right zone (tasks/ for a Tier-0 task written directly as 'planned'; proposals/ for a Tier-1/2/3 task needing approval), and a self-contained body. Allowed for every role (MEMBER via COS). Use when a non-trivial task, feature, or decision must be captured as a tracked spec, or a report's decision becomes a TRDD. Trigger with /ama-trdd-write, 'write a TRDD for X', or 'capture this as a task spec'. Finding is /ama-trdd-find, editing /ama-trdd-update, column moves /ama-trdd-transition.
Use when managing teams or governance titles. Trigger with /team-governance. Loaded by ai-maestro-plugin
Drive an agent's HTML dashboard side panel via the frozen aimaestro-panel.sh CLI — push HTML or a live URL, open/close/refresh the panel, check how many dashboard clients are connected, and drain feedback events the panel's HTML posted back. Use when an agent wants to render a status view, a form, or a live page in its own dashboard panel. Trigger with /ama-panel, 'show this in my side panel', 'push this HTML to my panel', 'check if anyone is watching my panel', 'read panel feedback'. CRITICAL gotcha: 'delivered: 0' from open/set means the content was DROPPED, not queued — always check status first when delivery matters. Loaded by ai-maestro-plugin
| name | team-kanban |
| user-invocable | false |
| description | Manage team kanban boards and tasks. Use when creating, moving, filtering, getting, or editing tasks. Trigger with /team-kanban. Loaded by ai-maestro-plugin |
| allowed-tools | Bash(amp-kanban-list.sh:*), Bash(amp-kanban-get.sh:*), Bash(amp-kanban-create-task.sh:*), Bash(amp-kanban-move.sh:*), Bash(amp-kanban-edit.sh:*), Bash(amp-kanban-archive.sh:*), Bash(aimaestro-teams.sh:*), Bash(jq:*), Bash(kanban-sync.py:*), Read, Edit, Grep, Glob |
| metadata | {"author":"Emasoft","version":"2.1.1"} |
Manage team kanban boards and tasks via the frozen amp-kanban-* CLIs + aimaestro-teams.sh kanban-config. Create, filter, get, move, edit, archive tasks; configure columns; sync with GitHub Projects v2.
Single board — anti-split-brain (team-kanban vs the ama-* design board). Two
kanban surfaces exist and are NOT interchangeable — each is the SINGLE writer of its own
domain, so there is no split brain. THIS skill is the live team-coordination
board (server-backed: who is assigned what, presence, real-time task state).
The ama-kanban-render / ama-trdd-transition skills render and move the
design/spec board where the TRDD files
under design/ ARE the board and column: is the source of truth for
design-pipeline state. A team task references a TRDD by TRDD-<id> but never
overrides its column:. When they appear to disagree: the TRDD file wins for
pipeline state; this server board wins for live assignment/presence.
Recall first (proactive memory). Before acting on a recurring problem, a design decision, or a repeated alert, recall prior lessons FIRST:
/janitor-memory-recall <symptom>(shared wiki memory — index by the symptom / your words, not the fix's jargon) and/memory-search <query>(past discussion). See the proactive memory contract in the pluginCLAUDE.md.
amp-kanban-* / aimaestro-teams.sh CLIs resolve the API base + auth internally)amp-kanban-* + aimaestro-teams.sh CLIs on PATH; jq installedgh CLI authenticated, kanban-sync.py at ~/.local/bin/Approval requirements. Task creation and board operations (create/move/archive/configure) on a team you belong to are
min-approval-requirement: none(in-scope) — no proposal needed; act directly. Anything that escalates beyond your slice (creating a team, cross-team work) follows theama-proposal-approvalsskill and the ai-maestro approval overlay (.claude/rules/aimaestro-trdd-approval.md).
Identify team: aimaestro-teams.sh list | jq .
Create task: amp-kanban-create-task.sh "<title>" [--status S] [--priority N] [--labels "a,b"] [--assignee <id>]
List/filter: amp-kanban-list.sh [--status X] [--assignee Y] [--label Z]
Get one task: amp-kanban-get.sh <task-id> — full task object, not just the fields list filters return.
Move task (status only): amp-kanban-move.sh <task-id> <status>
Edit task (any field): amp-kanban-edit.sh <task-id> --set priority=1 --set assigneeAgentId=<uuid> or --set-json blockedBy='["<id>"]' — the general verb; every field the task PUT accepts, repeatable per call.
Archive/delete task: amp-kanban-archive.sh <task-id>
Configure columns: aimaestro-teams.sh kanban-config <team-id> --get | --set <columns-json>
GitHub sync: kanban-sync.py link <team-id> <owner/repo> <project-number> (out of #11 scope — keep)
When the sync posts to GitHub (issue, PR comment, project-item note), per PRRD G1.1 begin the body with a one-line self-identification of the authoring agent, since all agents share the one owner identity.
| Operation | CLI command |
|---|---|
| List / filter tasks | amp-kanban-list.sh [--status|--assignee|--label|--task-type] |
| Get one task | amp-kanban-get.sh <task-id> |
| Create task | amp-kanban-create-task.sh "<title>" [--status|--priority|--labels|--assignee] |
| Move task (status) | amp-kanban-move.sh <task-id> <status> |
| Edit task (any field) | amp-kanban-edit.sh <task-id> (--set k=v | --set-json k=<json>)... |
| Archive / delete task | amp-kanban-archive.sh <task-id> |
| Kanban config | aimaestro-teams.sh kanban-config <team-id> --get|--set <json> |
Each CLI auto-detects the team from your agent registration (pass --team <id> to override).
The amp-kanban-* / aimaestro-teams.sh CLIs resolve your agent identity + bearer token internally — no Authorization / X-Agent-Id headers to set by hand. Pass --id <uuid> only to act as a specific agent.
Columns are per-team configurable — status must match a column id in that team's
kanban config, so read the team's real config before moving a card rather than assuming
a vocabulary (aimaestro-teams.sh kanban-config <team-id>).
The ratified vocabulary is the 17 columns — 14 lifecycle:
backburner → todo → design → dispatch → dev → testing → ai_review →
human_review → complete → publish → published → deploy → live → live_auditing
plus 3 orthogonal/terminal: blocked, failed, superseded.
The legacy five (backlog/pending/in_progress/review/completed) are obsolete
and must not be taught as the target vocabulary — but a team whose config was never
migrated may still serve them, which is exactly why you read the config instead of
assuming. Configure a team onto the ratified set with kanban-config --set (see
api-reference).
The server refuses some moves. This is enforced at the write endpoint, so a move you are
not entitled to make fails with 403 rather than silently succeeding:
human_review, complete, publish, deploy, published, live,
failed, or superseded; moving it backward into dev from human_review or
live_auditing; and writing the release-evidence fields publishedVersion / liveSince.reviewResult, or moving it out of ai_review/human_review into complete.
Any other agent, of any title, may.backburner, todo, design, dispatch,
dev (forward), testing, ai_review, blocked, live_auditing.Caveat — teams on a custom column configuration. The gate matches literal column strings, so this guarantee holds only for columns whose names match the ratified 17-column set; a renamed governed column is not yet gated (tracked in TRDD-LY442MKH). A default-board team needs no qualifier.
Enforcement vs. process. The write gate distinguishes only MANAGER-by-AID / owner from
everyone else, plus the self-review ban. The finer per-title routing (todo→design =
ORCHESTRATOR, design→dispatch = ARCHITECT, dispatch→dev = ORCHESTRATOR sets the assignee,
…) is the organizational contract agents follow — it is NOT mechanically enforced. Do not
rely on the server to refuse a contract violation it does not gate; see the
ai-maestro DEP overlay .claude/rules/aimaestro-trdd-approval.md (Part B) for the
routing itself.
{"tasks":[...]} with isBlocked, blocks[], assigneeName{"columns":[{id,label,color}]}| HTTP | Error | Fix |
|---|---|---|
| 400 | Invalid status | Must match a column ID |
| 400 | Circular dependency | blockedBy creates cycle |
| 403 | Access denied | Agent not team member |
| 403 | Governed transition refused (GATE 1) | Move into a governed column, backward into dev from human_review/live_auditing, or a write to publishedVersion/liveSince — needs a MANAGER (by AID) or the human owner. Not a membership problem; do not go debug membership |
| 403 | Self-review refused (GATE 2) | You are the card's assignee — another agent must render the verdict |
| 404 | Not found | Invalid team/task ID |
/team-kanban create a task "Fix login bug" with priority 1 in team abc-123
Creates task via POST, returns task object with generated ID.
/team-kanban show blocked tasks in team abc-123
Lists tasks where isBlocked == true.
/team-kanban link team abc-123 to GitHub project Emasoft/ai-maestro #5
Connects team to GitHub Projects v2.
Copy this checklist and track your progress:
aimaestro-teams.sh list)--id <uuid> to act as another agent)team-governance skill, which
bundles the canonical rules and embeds the full TOC.Skill(skill: "team-governance") — the teams and titles the board's tasks belong to.Skill(skill: "agent-messaging") — notify agents about task changes (AMP).