MCP HubMCP Hub
SKILL·DB2546

scale-colony

pjt222
Actualizado 1 month ago
9 vistas
26
3
26
Ver en GitHub
Otroai

Acerca de

Esta habilidad proporciona estrategias para escalar sistemas y equipos distribuidos modelándolos a semejanza de colonias biológicas, utilizando mecanismos como la gemación y la diferenciación de roles. Ayuda a reconocer fases de crecimiento e implementar transiciones arquitectónicas para evitar fallos de coordinación a medida que aumenta el tamaño. Úsala cuando la sobrecarga de comunicación supere la producción productiva o cuando un sistema que funcionaba a pequeña escala falle al crecer.

Instalación rápida

Claude Code

Recomendado
Principal
npx skills add pjt222/agent-almanac -a claude-code
Comando PluginAlternativo
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternativo
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/scale-colony

Copia y pega este comando en Claude Code para instalar esta habilidad

Documentación

Scale Colony

Scale distributed sys|teams|orgs → budding (split), role diff (age polyethism), growth-triggered arch transitions — maintain coord quality as colony grows beyond initial design.

Use When

  • Worked @ 10 agents, breaks @ 50
  • Comms overhead > productive output
  • Implicit coord patterns need explicit
  • Plan growth → scale proactive
  • Coord fails correlate w/ size (lost msgs, dup work, unclear ownership)
  • Existing sys needs split → semi-autonomous sub-colonies

In

  • Required: Current size + target growth
  • Required: Current coord mechanisms + stress points
  • Optional: Structure (flat|hierarchical|clustered)
  • Optional: Role diff already in place
  • Optional: Growth timeline + constraints
  • Optional: Inter-colony coord needs (if splitting)

Do

Step 1: Recognize Growth Phase

Identify scaling phase → apply right strategy.

  1. Classify phase:
Colony Growth Phases:
┌───────────┬──────────────┬───────────────────────────────────────────┐
│ Phase     │ Size Range   │ Characteristics                           │
├───────────┼──────────────┼───────────────────────────────────────────┤
│ Founding  │ 1-7 agents   │ Everyone does everything, direct comms,   │
│           │              │ implicit coordination, high agility       │
├───────────┼──────────────┼───────────────────────────────────────────┤
│ Growth    │ 8-30 agents  │ Roles emerge, some specialization, comms  │
│           │              │ overhead increases, need for structure     │
├───────────┼──────────────┼───────────────────────────────────────────┤
│ Maturity  │ 30-100 agents│ Formal roles, layered coordination,       │
│           │              │ sub-groups form, inter-group coordination  │
├───────────┼──────────────┼───────────────────────────────────────────┤
│ Fission   │ 100+ agents  │ Colony too large for single coordination  │
│           │              │ framework, must bud into sub-colonies     │
└───────────┴──────────────┴───────────────────────────────────────────┘
  1. Stress signals:
    • Comms overload: msgs/agent/day grows faster than colony size
    • Decision latency: proposal→decision time ↑
    • Coord failures: dup work, dropped tasks, conflicting actions ↑
    • Knowledge dilution: newcomers slow to productive
    • Identity loss: agents can't describe purpose consistently
  2. About to cross phase boundary or already crossed?

→ Clear phase ID + stress signals indicating approach|cross.

If err: phase unclear → measure 3 metrics: comm vol/agent, decision latency, coord fail rate. Plot over time. Inflection points = phase transitions. No metrics → likely Founding (where metrics not yet needed).

Step 2: Role Differentiation (Age Polyethism)

Progressive specialization → roles by experience + colony needs.

  1. Role progression:
    • Newcomers: observation, learning, simple (low autonomy, high guidance)
    • Workers: standard exec, signal following (mod autonomy)
    • Specialists: domain expertise, complex tasks, mentor newcomers (high autonomy)
    • Foragers/Scouts: exploration, innovation, external interface (see forage-resources)
    • Coordinators: inter-group comms, conflict resolution, quorum mgmt
  2. Role transitions:
    • Triggered by experience thresholds, not appointment
    • Agent done threshold tasks successfully → next role (calibrate by complexity + growth rate — 5-10 simple, 20-30 specialist)
    • Reverse possible (specialist → worker in new domain)
    • Distribution adapts to needs:
      • Growing → more newcomer slots, active mentoring
      • Stable → balanced across all roles
      • Threatened → more defenders, fewer scouts (see defend-colony)
  3. Preserve flexibility:
    • No agent permanently locked
    • Emergency protocols can temp reassign any agent any role
    • Cross-training → cover adjacent roles

→ Roles where agents progress simple→complex, distribution reflects needs+phase.

If err: rigid silos → ↑cross-training + rotation freq. Newcomers struggle progress → mentoring insufficient — pair w/ specialist for first N tasks. Too many in one role → triggers miscalibrated — adjust by colony-wide demand.

Step 3: Restructure Coord for Scale

Adapt mechanisms from coordinate-swarm for size.

  1. Replace direct comms → layered signaling:
    • Founding: everyone→everyone (N×N)
    • Growth: cluster squads of 5-8; direct in squad, signal between
    • Maturity: squads → departments; intra-squad direct, inter-squad signal, inter-dept broadcast
  2. Coord layers:
    • Local: in squad, direct signal exchange (stigmergy)
    • Regional: between squads same dept, aggregated signals
    • Colony: between depts, broadcast only for colony-wide decisions
  3. Inter-layer interfaces:
    • Each squad has 1 designated communicator who aggregates+relays
    • Communicators filter noise: not every local signal relayed up
    • Colony broadcasts rare → quorum, alarm escalation, major state changes
  4. Comms overhead budget:
    • Target: each agent <20% capacity on coord
    • Measure actual; exceed → add layer or split oversized squad

→ Layered coord, comms overhead grows logarithmic (not linear) w/ size. Local fast direct; colony-wide slower but functional.

If err: layers create info bottlenecks (communicators overloaded) → add redundant communicators or ↓relay freq. Layers create isolation (squads don't know others) → ↑inter-layer signal freq or cross-squad liaison roles.

Step 4: Execute Budding (Fission)

Split colony → semi-autonomous sub-colonies when exceeds single-coord capacity.

  1. Fission triggers:
    • 100 agents (or coord layer count >3)

    • Comms overhead >30% capacity despite layering
    • Decision latency exceeds time-sensitive thresholds
    • Subgroups have distinct identities + can operate independent
  2. Plan fission:
    • Identify natural split lines (existing clusters, domain bounds, geo)
    • Each daughter has viable role distribution (can't split all specialists into one)
    • Each must have: ≥1 coordinator, sufficient workers, access to shared resources
    • Define inter-colony interface: what shared, what independent
  3. Execute split:
    • Announce plan + timeline (consensus required — see build-consensus)
    • Transfer agents → daughters by existing cluster membership
    • Establish inter-colony channels (lightweight, async)
    • Each daughter bootstraps own local coord (inheriting from parent)
  4. Post-fission stabilization:
    • Monitor each for viability (sustains itself?)
    • Inter-colony coord minimal (quarterly sync, not daily)
    • Failed daughter → reabsorb into nearest viable

→ ≥2 viable daughters semi-autonomous w/ own coord, connected by lightweight interfaces.

If err: daughters too small → fission premature; remerge + retry larger. Inter-colony coord as heavy as pre-fission → split lines wrong, too interdependent. Re-draw on natural independence.

Step 5: Monitor Limits + Adapt

Continuous assess: structure matches size+needs?

  1. Scaling health metrics:
    • Coord overhead ratio: time coord/time produce
    • Decision throughput: decisions/time (↑ or steady w/ growth)
    • Agent satisfaction: engagement, retention, purpose (drops on fail)
    • Err rate: coord fails/time (not linear w/ growth)
  2. Limit indicators:
    • Overhead ratio >25% → more automation or layer
    • Throughput declining → governance needs revision
    • Turnover spiking → cultural|structural issues
    • Err rate accelerating → coord failing
  3. Trigger adapt:
    • Phase transition → apply Step 1 strategy
    • Limit reached → escalate (role diff → coord restructure → fission)
    • External change (market, tech) → may need transformation (see adapt-architecture)

→ Colony monitors own health + proactively adapts before stress = failure.

If err: no metrics → lacks observability — build measurement before more structure. Metrics show problems but can't adapt → resistance cultural not technical — address human factors (fear, ownership, trust) before restructure.

Check

  • Phase ID'd w/ specific stress signals
  • Role diff defined w/ progressive specialization
  • Coord layered for size
  • Comms overhead <20-25% capacity
  • Fission plan exists for >single-coord capacity
  • Health metrics tracked + thresholds trigger adapt
  • Daughter colonies (post-fission) viable distribution

Traps

  • Scale structure pre-needed: Premature layering = overhead w/o benefit. 10-team doesn't need dept coordinators. Stress signals guide.
  • Preserve founding culture at all costs: 5-agent ways break @ 50. Scaling needs evolution; nostalgia prevents adaptation.
  • Fission w/o independence: Sub-colonies still depend daily → worst of both — coord overhead + separation overhead.
  • Uniform role distribution: Not every sub-colony needs same ratios. Research → more scouts; production → more workers.
  • Ignore remerge: Sometimes fission fails; remerge best move. Treating fission irreversible prevents recovery.

  • coordinate-swarm — foundational patterns this skill scales
  • forage-resources — scales diff than production; role diff affects scout alloc
  • build-consensus — must adapt for larger groups
  • defend-colony — defense scales w/ colony
  • adapt-architecture — morphic skill for structural transformation
  • plan-capacity — capacity planning for growth
  • conduct-retrospective — identify stress before failure

Repositorio GitHub

pjt222/agent-almanac
Ruta: i18n/caveman-ultra/skills/scale-colony
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams
FAQ

Frequently asked questions

What is the scale-colony skill?

scale-colony is a Claude Skill by pjt222. Skills package instructions and resources that Claude loads on demand, so Claude can perform scale-colony-related tasks without extra prompting.

How do I install scale-colony?

Use the install commands on this page: add scale-colony to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does scale-colony belong to?

scale-colony is in the Other category, tagged ai.

Is scale-colony free to use?

Yes. scale-colony is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.

Habilidades relacionadas

llamaguard
Otro

LlamaGuard es el modelo de Meta de 7-8B parámetros para moderar las entradas y salidas de LLM en seis categorías de seguridad como violencia y discurso de odio. Ofrece una precisión del 94-95% y puede implementarse usando vLLM, Hugging Face o Amazon SageMaker. Utiliza esta skill para integrar fácilmente filtrado de contenido y barreras de seguridad en tus aplicaciones de IA.

Ver habilidad
cost-optimization
Otro

Esta Skill de Claude ayuda a los desarrolladores a optimizar los costes en la nube mediante el ajuste de tamaño de recursos, estrategias de etiquetado y análisis de gastos. Proporciona un marco para reducir los gastos en la nube e implementar una gobernanza de costes en AWS, Azure y GCP. Úsala cuando necesites analizar los costes de infraestructura, ajustar el tamaño de los recursos o cumplir con restricciones presupuestarias.

Ver habilidad
sports-betting-analyzer
Otro

Esta habilidad de Claude analiza los mercados de apuestas deportivas, incluyendo spreads, over/unders y apuestas de propuestas, mediante el examen de tendencias históricas y estadísticas situacionales para identificar apuestas de valor. Proporciona una salida en markdown estructurado con recomendaciones accionables con fines educativos. Los desarrolladores deben utilizar esto para herramientas de análisis de apuestas deportivas, teniendo en cuenta que está diseñado únicamente para entretenimiento/educación.

Ver habilidad
quantizing-models-bitsandbytes
Otro

Esta habilidad cuantiza LLMs a precisión de 8 o 4 bits utilizando bitsandbytes, logrando una reducción de memoria del 50-75% con pérdida mínima de precisión. Es ideal para ejecutar modelos más grandes en memoria GPU limitada o para acelerar la inferencia, admitiendo formatos como INT8, NF4 y FP4. La habilidad se integra con HuggingFace Transformers y permite entrenamiento QLoRA y optimizadores de 8 bits.

Ver habilidad