Add taskboard CLI tool for kanban orchestration (Phase 1 of plan 13)
This commit is contained in:
72
tools/taskboard/SKILL.md
Normal file
72
tools/taskboard/SKILL.md
Normal file
@@ -0,0 +1,72 @@
|
||||
# Taskboard — Kanban Task Management
|
||||
|
||||
Central orchestration tool for Atomizer HQ. All agents interact with the shared taskboard.
|
||||
|
||||
## Quick Reference
|
||||
|
||||
```bash
|
||||
TB="/home/papa/atomizer/workspaces/shared/skills/taskboard/taskboard.sh"
|
||||
|
||||
# List your tasks
|
||||
CALLER=my-agent-name bash "$TB" list --agent my-agent-name
|
||||
|
||||
# List by status or project
|
||||
bash "$TB" list --status in-progress
|
||||
bash "$TB" list --project gigabit-m2
|
||||
|
||||
# View task details
|
||||
bash "$TB" view TASK-001
|
||||
|
||||
# Update task status (any agent can update their own tasks)
|
||||
CALLER=my-agent-name bash "$TB" update TASK-001 --status in-progress --note "Started research"
|
||||
CALLER=my-agent-name bash "$TB" update TASK-001 --status review --note "Draft posted to #technical"
|
||||
|
||||
# Kanban summary (counts per column)
|
||||
bash "$TB" summary
|
||||
|
||||
# Kanban snapshot (markdown for Discord)
|
||||
bash "$TB" snapshot
|
||||
```
|
||||
|
||||
## Manager-Only Commands
|
||||
|
||||
```bash
|
||||
# Create a task
|
||||
CALLER=manager bash "$TB" create \
|
||||
--title "Research CCZ thermal properties" \
|
||||
--assignee webster \
|
||||
--priority high \
|
||||
--project gigabit-m2 \
|
||||
--description "Full thermal comparison: CTE, conductivity for CCZ HS vs Zerodur" \
|
||||
--deliverable-type analysis \
|
||||
--deliverable-channel technical
|
||||
|
||||
# Complete a task
|
||||
CALLER=manager bash "$TB" complete TASK-001 --note "Deliverable accepted"
|
||||
|
||||
# Cancel a task
|
||||
CALLER=manager bash "$TB" cancel TASK-002 --reason "Superseded by new approach"
|
||||
```
|
||||
|
||||
## Status Flow
|
||||
|
||||
```
|
||||
backlog → todo → in-progress → review → done
|
||||
↓
|
||||
cancelled
|
||||
```
|
||||
|
||||
## For Executor Agents (non-Manager)
|
||||
|
||||
On every session start:
|
||||
1. Check your tasks: `CALLER=<you> bash "$TB" list --agent <you>`
|
||||
2. If you have `todo` tasks: update to `in-progress` and start working
|
||||
3. When work is done: update to `review` and post deliverable to the target Discord channel
|
||||
4. Append progress to `shared/project_log.md`
|
||||
|
||||
## Important
|
||||
|
||||
- **taskboard.json is the single source of truth** — never edit it directly
|
||||
- **Only Manager creates/completes/cancels tasks** — other agents update status
|
||||
- **All writes are atomic** (tmp file + mv) with flock locking
|
||||
- **Set CALLER env var** so your name appears in logs and notes
|
||||
Reference in New Issue
Block a user