# 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