cluster-agent-setup

Structures multi-agent engineering units with roles, write boundaries, briefs, and continuity plans.

Updated Aug 6, 2021
One-click install
npx skills add https://github.com/the-homeless-god/dotfiles --skill cluster-agent-setup-the-homeless-god
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cluster-agent-setup
Source: https://github.com/the-homeless-god/dotfiles/tree/main/skills/cluster-agent-setup
Command: npx skills add https://github.com/the-homeless-god/dotfiles --skill cluster-agent-setup-the-homeless-god

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Running many concurrent agents on one engineering initiative causes duplicated work, silent file overwrites on shared accounts, lost measurements when sessions die in batches, and unverifiable reports. This Skill defines an operating structure that prevents those failures. ## Core Features & Use Cases - Role and boundary design: Splits work into one overagent, two lead agents, and worker pools, with every contested file assigned exactly one owner. - Task briefs and reporting contract: Generates RCTF briefs (role, context, task, key results) so every worker returns falsifiable, threshold-scored reports with provenance. - Continuity and failure review: Plans for batch session death with on-disk state, resumption briefs, rotation rules, and a failure catalogue used to review results before declaring success. - Use Case: An initiative spans two repositories and needs 40 concurrent agents; use this Skill to produce the stack split, work matrix, dispatchable briefs, and a tracker for standing work. ## Quick Start Use the cluster-agent-setup skill to structure this cross-repository initiative into an overagent, lead agents, and worker pools with write boundaries, briefs, and a continuity plan.

Frequently Asked Questions about cluster-agent-setup

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

FAQPage Schema
How do I coordinate multiple AI agents on one engineering project?

Split the initiative into stacks defined by the files each writes, assign every contested file exactly one owner, and give each worker a single cell of a measure/change/verify/publish matrix. One overagent holds priorities and merges while two lead agents own non-overlapping stacks.

How to write a task brief for a worker agent?

Use the RCTF format: role, verified context with provenance (KNOWN, NEIGHBOURS, BOUNDARIES), one concrete task with a stated falsifier, and three to six key results with numeric thresholds written before work starts. A brief missing any of these returns an unverifiable answer.

When should I not use a multi-agent cluster setup?

Do not use it when one agent can finish the work in a single session. Spawning agents costs real budget, so the cluster should be sized to the work, and small one-off tasks gain nothing from roles, pools, and continuity planning.

How do agents recover when sessions die on account limits?

Write state to disk as it is produced, record outcomes in the task record immediately, and relaunch with a resumption brief carrying the predecessor's measurements inline. Splitting the overagent and leads across separate limit pools prevents total standstill.

Why do multi-agent reports turn out wrong or unverifiable?

Common causes are numbers measured in the wrong tree, two variables changed at once, decorative checks that never fail, and watchers matching only success markers. The failure catalogue lists these modes with guards, and every report must include provenance and a what-I-did-not-do section.