task-queue-by-model-source

# Model Queue Skill

A multi-queue task orchestration system where tasks are routed to queues based on their target model source. Supports task dependencies, context passing between tasks, and configurable failure handling.

---

## Core Concepts

### Model Source Mapping

Models are grouped by their underlying source (e.g., local Ollama, remote Ollama, cloud API). All tasks targeting models on the same source share a single queue.

**Configuration in TOOLS.md:**
```
MODEL_SOURCE_OLLAMA_LOCAL=ollama/llama3,ollama/qwen2.5,ollama/mistral
MODEL_SOURCE_OLLAMA_REMOTE=ollama-remote/qwen3.5:27b,ollama-remote/llama3:70b
MODEL_SOURCE_CLOUD_NVIDIA=nvidia/z-ai/glm5,nvidia/llama3
```

### Queue Isolation

Each model source has its own queue file:
- `${MODEL_QUEUES_DIR}/ollama-local.json`
- `${MODEL_QUEUES_DIR}/ollama-remote.json`

Queues are independent — a blocked task in one queue doesn't affect other queues.

---

## Task Object Schema

```json
{
  "id": "T-001",
  "queue": "ollama-local",
  "model": "ollama/qwen2.5",
  "description": "Analyze the sales data",
  "goal": "Generate a summary of Q1 sales performance",
  "status": "pending",
  "priority": 0,
  "depends_on": null,
  "on_depends_fail": "block",
  "context_input": null,
  "result": null,
  "result_status": null,
  "result_summary": null,
  "retries": 0,
  "maxRetries": 3,
  "subagent_session": null,
  "added_at": "2026-03-04T16:51:00Z",
  "started_at": null,
  "completed_at": null
}
```

---

## Task Statuses

| Status | Description |
|--------|-------------|
| `pending` | Ready to be dispatched (no dependencies or resolved) |
| `waiting` | Has dependency, waiting for it to complete |
| `running` | Currently executing via subagent |
| `done` | Completed successfully |
| `failed` | Failed after max retries |
| `blocked` | Dependency failed, waiting for user action |
| `skipped` | Skipped by user or due to dependency failure |

---

## Two Operating Modes

| Mode | Trigger | Purpose |
|------|---------|---------|
| *...