# Amia Kanban Orchestration

> Use when managing GitHub Kanban boards. Trigger with board state, card move, or completion requests. Loaded by ai-maestro-integrator-agent-main-agent.

- Skill: `emasoft-ai-maestro-integrator-agent/amia-kanban-orchestration` (Agent Skill, multi-file: 35 files)
- Install (CLI): `npx skillmds@latest add emasoft-ai-maestro-integrator-agent/amia-kanban-orchestration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/emasoft-ai-maestro-integrator-agent/amia-kanban-orchestration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: Emasoft (https://skillmd.com/u/emasoft-ai-maestro-integrator-agent)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/emasoft-ai-maestro-integrator-agent/amia-kanban-orchestration

---


# GitHub Kanban Core

## Overview

GitHub Projects V2 Kanban provides the display layer for task tracking. AI Maestro's task system (`backlog`, `pending`, `in_progress`, `review`, `completed`) is the authoritative status source. GitHub columns map onto these 5 statuses.

## Prerequisites

- GitHub CLI authenticated (`gh auth status`) with Projects V2 enabled
- GraphQL API access and Python 3.8+
- AI Maestro installed

## Instructions

1. **Initialize** - Verify `gh auth status` and Projects V2 access
2. **Query state** - Run `amia_kanban_get_board_state.py OWNER REPO PROJECT_NUMBER`
3. **Create & assign** - 1 issue per module, set assignees, add to Backlog
4. **Track transitions** - Move cards through columns, handle blockers with `--reason`
5. **Verify completion** - Run `amia_kanban_check_completion.py` (exit 0 = all done)

### Checklist

Copy this checklist and track your progress:

- [ ] `gh auth status` passes and Projects V2 verified
- [ ] Board state queried successfully
- [ ] Module issues created and added to Backlog
- [ ] Issues moved Backlog -> Todo -> In Progress
- [ ] Agents assigned via issue assignees
- [ ] Blockers handled with reason
- [ ] Completion verified (exit code 0)

## Output

| Output | Format | Script |
|--------|--------|--------|
| Board State | JSON (items by column) | `amia_kanban_get_board_state.py` |
| Transition Result | JSON (success/fail + validation) | `amia_kanban_move_card.py` |
| Completion Status | Exit code: 0=done, 1=pending, 2=blocked | `amia_kanban_check_completion.py` |

> **Output discipline:** All scripts support `--output-file <path>`. Use it from agents to minimize tokens.

## Reference Documents

See `references/` directory for all reference documents.

## Error Handling

Check exit code and stderr: 1=invalid params, 2-4=GitHub API errors. See the detailed guide in Resources.

## Resources

Full reference: [detailed-guide](references/detailed-guide.md):
  - The Iron Rule
  - Board Columns Quick Reference
  - Python Scripts Detailed Usage
    - Get Board State (scripts/amia_kanban_get_board_state.py)
    - Move Card (scripts/amia_kanban_move_card.py)
    - Check Completion (scripts/amia_kanban_check_completion.py)
  - Error Handling
  - Integration Points Summary
  - Proactive Kanban Monitoring Summary
  - Skill File Structure
  - Related Skills
  - When to Use This Skill

## Examples

### Example: Move Card and Check Completion

```bash
# Get board state
python3 scripts/amia_kanban_get_board_state.py owner repo 1

# Move issue #42 to In Progress
python3 scripts/amia_kanban_move_card.py owner repo 1 42 in-progress --reason "Starting work"

# Verify all items complete
python3 scripts/amia_kanban_check_completion.py owner repo 1
# Exit: 0=all done, 1=pending, 2=blocked
```