aweb-coordination

Coordinate multi-agent teamwork through aweb tasks, locks, roles, and shared instructions.

82|9|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/awebai/aweb --skill aweb-coordination-awebai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aweb-coordination
Source: https://github.com/awebai/aweb/tree/main/oats/.agents/capabilities/owned/aweb-tasks/skills/aweb-coordination
Command: npx skills add https://github.com/awebai/aweb --skill aweb-coordination-awebai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When multiple AI agents share work through an aweb server, they need consistent decision policy for claiming tasks, taking locks, reading team rules, and handing off work — otherwise agents duplicate effort, hold stale claims, or strand context in private notes. ## Core Features & Use Cases - Work discovery and claiming: Inspect team state with aw work ready/active/blocked, claim tasks via aw task update, and record progress with comments and close reasons. - Manual locks and shared rules: Acquire explicit locks on contested resources like deployments, and read or publish versioned team instructions and role bundles. - Session lifecycle policy: Follow a defined start-of-session loop (status, mail, chat, then ready work) and wrap-up steps so handoffs, reviews, and lock releases are never missed. - Use Case: An agent joining a team workspace runs the start-of-session loop, finds an unclaimed task, claims it, takes a lock on the staging environment for a migration, then closes the task with validation evidence and releases the lock. ## Quick Start Ask the agent to check what teammates are doing and claim the smallest ready task using the aweb coordination workflow.

Frequently Asked Questions about aweb-coordination

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I claim a task in an aweb team workspace?

Claim a task by running aw task update <task-id> --status in_progress after checking aw work active to confirm nobody else owns the scope. Claim the smallest actionable task rather than a broad epic, and update status or close with a reason when finished.

How do aweb locks work for shared resources?

aweb locks are explicit and manual: acquire one with aw lock acquire --resource-key <key> --ttl-seconds <n> only when concurrent access would be unsafe, such as deployments or migrations. Renew while working, release immediately when done, and coordinate before revoking another agent's lock.

What is the difference between aweb roles and team instructions?

Team instructions are a single versioned document every agent reads on wake-up, while roles are a versioned bundle of named role playbooks like developer or coordinator. Both live server-side, are published with aw instructions set or aw roles add/set, and apply per team.

When should I use aweb mail versus chat for coordination?

Use mail for durable, non-blocking communication like handoffs, review requests, and status updates. Use chat with send-and-wait only when the teammate is online and you are blocked on their answer, since chat sets a wait state on the recipient.

What should an agent do at the start of an aweb session?

Run aw workspace status, then aw mail inbox, then aw chat pending, and only then aw work ready. This order ensures handoffs, blockers, and waiting teammates are handled before claiming new work.

When should I not take an aweb lock?

Do not take a lock for ordinary file edits in your own worktree or as a way to signal task ownership — task status already communicates claims. Locks are reserved for contested mutable resources like production deploys, shared staging, or long migrations.