ecosystem-orchestration
🤖 Orchestration & Agentic Ecosystem
Welcome to the orchestration domain ecosystem. Unlike typical domains (which focus on specific tech stacks like frontend or databases), this meta-ecosystem defines the rules, workflows, and connectivity for how AI autonomous agents interact, plan, recover from errors, and evaluate themselves and each other.
For Orchestrator Agents (
task-decomposer,parallel-planner): This document is your internal operating manual. Use these workflows when structuring complex reasoning tasks, coordinating multiple AI models, or building secure entry points for external agentic integrations.
🔄 Standard Workflows & Handoffs
1. The Agent Connectivity Flow (The Foundation)
When the user asks to "integrate an LLM bot", "give an external agent access", or "design an AI pipeline into the app":
@claw-integration-design-> (MANDATORY) Designs the API endpoints, sets up{action}:{resource}OAuth scopes, and builds the generictools.jsonmanifest. (This must always be the first step for agent connectivity).@tool-selector-> Analyzes the available tooling landscape (APIs, generic scripts) and selects the optimal set of actions for the incoming agent.@context-compressor-> Steps in when agents retrieve massive payloads (logs, raw DB dumps) to compress the context window before it overwhelms the LLM.
2. Task Orchestration & Execution Flow
When given a large, ambiguous objective (e.g., "build an app", "migrate the server"):
@task-decomposer-> Breaks the massive goal into a step-by-step dependency graph.@parallel-planner-> Analyzes the decomposed steps to find where tasks can be run concurrently (saving time and tokens).@memory-ledger-> Used consistently throughout execution to maintain state across different sub-agents.@error-recovery-> Automatically takes over if an executed step fails (retries, attempts alternate tools, or safely escalates to a human).
3. Multi-Brain (Consensus & Quality) Flow
When the user asks to "find the best approach", "debate these two libraries", or "give me a robust solution":
- Choose the synthesis model based on user intent:
@multi-brain-> General 3-perspective synthesis.@multi-brain-experts-> Specialized perspective synthesis based on strict domain personas (e.g., Security vs UX).@multi-brain-debate-> Used when two distinct choices clash; forces a 2-round adversarial debate.
@assumption-checker-> Runs parallel to validate if the underlying facts driving the perspectives are hallucinated or real.@output-critic-> Acts as the final tollgate to score the proposed synthesis before showing it to the user. (For advanced scoring structures,@multi-brain-scorecan be used).
4. Safety & Review Flow
When autonomous agents are operating on sensitive codebases or production databases:
@checkpoint-guardian-> A mandatory tollgate activated right before any destructive steps (e.g., Drop Table, Push to Main) are executed.@agent-reviewer-> An oversight entity that retrospectively audits what the execution agents did, looking for logic holes or skipped steps.
🧠 Core Philosophy
Agentic orchestration is about reliability, oversight, and fallback mechanisms. Unlike standard script execution, agents can hallucinate or fail unexpectedly. Every skill in this ecosystem is designed to bound agent behavior within safe limits (claw-integration, checkpoint-guardian), ensure high-quality reasoning (multi-brain, critic), and provide resilient recovery (error-recovery). Never trust a single "one-shot" output for a complex scenario without decomposition and review.
🚀 Installation & Orchestration Instructions
As an AI Agent reading this ecosystem file, you must actively guide the user to install the missing skills for the selected workflow.
To install all skills within this ecosystem at once, you must execute or instruct the user to execute the provided installation script:
python skills/ecosystem-orchestration/scripts/install_all.py
Execution Rule: Do not attempt to perform the tasks of these skills yourself. Your job is to install them and hand off the execution to the appropriate skill, or instruct the user to trigger the newly installed skills in order.
More from fatih-developer/fth-skills
task-decomposer
Break down large, complex, or ambiguous tasks into independent subtasks with dependency maps, execution order, and success criteria. Plan first, then execute step by step. Triggers on 'how should I do this', 'where do I start', 'plan the project', 'break it down', 'implement' or whenever a task involves multiple phases.
24context-compressor
Compress long conversation histories, large code files, research results, and documents by 70% without losing critical information. Triggers when context window fills up, when summarizing previous steps in multi-step tasks, before loading large files into context, or on 'summarize', 'compress', 'reduce context', 'save tokens'.
18multi-brain-debate
Two-round debate protocol where perspectives challenge each other before consensus. Round 1 presents independent positions, Round 2 allows counter-arguments and rebuttals. Produces battle-tested decisions for high-stakes choices.
17multi-brain-score
Confidence scoring overlay for multi-brain decisions. Each perspective rates its own confidence (1-10) with justification. Consensus uses scores as weights, flags low-confidence areas, and surfaces uncertainty explicitly.
15checkpoint-guardian
Automatic risk assessment before every critical action in agentic workflows. Detects irreversible operations (file deletion, database writes, deployments, payments), classifies risk level, and requires confirmation before proceeding. Triggers on destructive keywords like deploy, delete, send, publish, update database, process payment.
14parallel-planner
Analyze multi-step tasks to identify which steps can run in parallel, build dependency graphs, detect conflicts (write-write, read-write, resource contention), and produce optimized execution plans. Triggers on 3+ independent steps, 'speed up', 'run simultaneously', 'parallelize', 'optimize' or any task where sequential execution wastes time.
14