Openclaw Orchestration

# Orchestration Skill

Multi-agent task orchestration framework. Agents delegate tasks via a shared SQLite queue, with .md interchange files for visibility.

## Quick Start
```bash
cd skills/orchestration
npm install
node src/cli.js agent register my-agent --capabilities "coding,research"
node src/cli.js task create "Build feature X" --desc "..." --priority high
node src/cli.js task claim <task-id> --agent my-agent
node src/cli.js task complete <task-id> --summary "Done"
node src/cli.js refresh
```

## Design
- **DB is source of truth** — .md files are read-only projections
- **Atomic claims** — only one agent can claim a pending task
- **Dependencies** — tasks can depend on other tasks
- **Timeout + retry** — `sweep` handles stale tasks
- **Interchange** — `refresh` generates .md files via @openclaw/interchange

# @openclaw/orchestration

[![Tests](https://img.shields.io/badge/tests-13%20passing-brightgreen)]() [![Node](https://img.shields.io/badge/node-%3E%3D18-blue)]() [![License: MIT](https://img.shields.io/badge/license-MIT-yellow)]()

> Multi-agent task queue with collision-safe claiming and dependency chains.

A SQLite-backed task orchestration system designed for multi-agent environments. Agents register capabilities, claim tasks atomically, and chain dependencies — all with automatic timeout detection, retry logic, and `.md` interchange output.

## Features

- **Task queue** — create, claim, complete, fail, and retry tasks
- **Collision-safe claiming** — atomic SQLite transactions prevent double-claims
- **Dependency chains** — tasks can depend on other tasks completing first
- **Timeout & retry** — configurable timeouts with automatic sweep and retry
- **Agent registry** — register agents with capabilities and concurrency limits
- **Priority levels** — high, medium, low task prioritization
- **Interchange output** — regenerate `.md` files for cross-skill visibility
- **Backup & restore** — full database backup and recovery

## Quick Start

```bash
cd skills/orchestration
npm install

# Register an agent
node src/cli.js agent register researcher --capabilities "search,summarize" --max-concurrent 3

# Create a task
node src/cli.js task create "Research competitor pricing" --priority high --timeout 30

# Claim and complete
node src/cli.js task claim <task-id> --agent researcher
node src/cli.js task complete <task-id> --summary "Found 5 competitors"

# Sweep stale tasks
node src/cli.js sweep
```

## CLI Reference

### Task Management

```bash
orch task create <title> [options]
  --desc <description>       Task description
  --priority <high|medium|low>  Priority (default: medium)
  --timeout <minutes>        Timeout in minutes (default: 60)
  --depends-on <ids>         Comma-separated dependency task IDs
  --created-by <agent>       Creating agent (default: cli)
  --ma...