---
id: 01-meta-framework-swarm-tree-orchestration
name: swarm-tree-orchestration
source: lara-squads-import
source_path: 01-meta-framework/swarm-tree-orchestration.md
source_sha256: e62d450860e7a500f5dcf25ee3a4f85ccd3b72f220aab4c26ee0cf4641f96220
status: active
---

# swarm-tree-orchestration

> Espelhado de LARA/Squads para o catálogo canônico do OpenLife. Runtime deve ler este arquivo em `.catalog/squads`, não o Obsidian.

---
tags: [lara, squad, swarm-tree-orchestration]
versão: "1.0.0"
engine: "—"
localização: ~/squads/swarm-tree-orchestration/
atualizado: 2026-03-17
---

# Squad: swarm-tree-orchestration

Orquestração de múltiplos agentes em estrutura de swarm tree.

---


## 🤖 Agentes

| Agente | Papel |
|---|---|
| [[context-composer]] | Composes prompts for each tree node using atomic modules (role, task, tools-allowed, tools-denied, guardrails, domain-context, anti-stall, output-form |
| [[node-scorer]] | Evaluates each tree node via Urgency x Impact x Irreversibility scoring to determine model allocation and budget, then constructs the dependency graph |
| [[task-decomposer]] | Applies the Golden Rule recursively: nodes with <=2 sub-tasks become executor leaves, nodes with >2 sub-tasks become coordinators that delegate to chi |
| [[tree-integrator]] | Final integration validator — verifies completeness of all artifacts, fixes cross-leaf integration issues (imports, references), detects placeholder c |
| [[tree-orchestrator]] | Pure router — decomposes tasks into domains (WBS level 1), coordinates the full planning-then-execution lifecycle, monitors via unified polling with r |
| [[tree-validator]] | Pre-launch gatekeeper — validates WBS structural integrity, runs circuit breaker checks before each TaskCreate, and audits existing trees for anti-pat |
| [[wave-dispatcher]] | Launches tree execution in waves — parallel TaskCreate for independent leaves, sequential for dependent ones — with unified polling, reactive dispatch |


## 📋 Templates

- `coordinator-prompt.md`
- `executor-prompt.md`
- `integrator-prompt.md`
- `tree-presentation.md`


---

## 📁 squad.yaml

```yaml
name: swarm-tree-orchestration
version: "1.0.0"
description: "Recursive tree decomposition orchestrator squad — decomposes complex tasks into a tree where each leaf has max 2 sub-tasks, plans the complete tree before execution, launches waves via TaskCreate, and integrates results. Inherits Context Factory, UxIxR scoring, circuit breaker, and fitToBudget."
author: "nirvana-squads-creator-lite"
license: MIT
slashPrefix: sto

openlife:
  minVersion: "2.1.0"
  type: squad

components:
  agents:
    - tree-orchestrator.md
    - task-decomposer.md
    - node-scorer.md
    - context-composer.md
    - wave-dispatcher.md
    - tree-validator.md
    - tree-integrator.md
  tasks:
    - decompose-task.md
    - group-subtasks.md
    - score-nodes.md
    - build-dependency-graph.md
    - generate-tree-plan.md
    - compose-context.md
    - validate-circuit-breaker.md
    - dispatch-wave.md
    - integrate-tree.md
    - analyze-tree.md
    - resume-tree.md
  workflows:
    - tree-planning-flow.yaml
    - tree-execution-flow.yaml
    - tree-analysis-flow.yaml
    - tree-resume-flow.yaml
  checklists: []
  templates:
    - templates/executor-prompt.md
    - templates/coordinator-prompt.md
    - templates/integrator-prompt.md
    - templates/tree-presentation.md
    - templates/instructions/base.md
    - templates/instructions/executor.md
    - templates/instructions/coordinator.md
    - templates/instructions/integrator.md
  shared:
    - shared/macros.md
  tools: []
  scripts: []

config:
  extends: none
  coding-standards: config/coding-standards.md
  tech-stack: config/tech-stack.md
  source-tree: config/source-tree.md

dependencies:
  node: []
  squads: []

tags:
  - "orchestration"
  - "recursive-decomposition"
  - "task-tree"
  - "multi-agent"
  - "wbs"
  - "context-factory"
  - "wave-execution"
  - "circuit-breaker"

```

---
*Fonte: `~/squads/swarm-tree-orchestration/` · 59 arquivos*
