What problem does it solve? When multiple autonomous agents work on the same project, they can overwrite each other's files, duplicate work, or lose track of task ownership. This Skill makes the agent act as a single gateway that records all claims, heartbeats, blockers, handoffs, and completions in one append-only CSV ledger, so folder ownership and task state stay consistent. ## Core Features & Use Cases - Append-only ledger writes: A helper script creates the CSV header, normalizes folder paths, generates task and run IDs, and enforces single-line fields and UTC timestamps. - Conflict and stale-lease handling: Overlapping non-stale claims produce a conflict event, while expired leases are reclaimed with a stale_reclaim event before a new claim is recorded. - State snapshots: A snapshot command derives current active, blocked, stale, handoff, closed, and conflict states plus folder ownership from the latest row per task. - Use Case: A dispatcher agent assigns a worker to the python folder with an exclusive claim, receives heartbeats every 15 minutes, records a blocker when a fixture is missing, and closes the task with done when the work completes. ## Quick Start Ask the agent to claim a folder for a task in your project root using the gateway ledger, then send heartbeat, progress, blocked, handoff, or done updates with the same task ID until the work is closed.
