rubicanjr/agentica-infrastructure

Agentica Infrastructure Reference

Complete API specification for Agentica multi-agent coordination infrastructure.

When to Use

• Building multi-agent workflows with Agentica patterns
• Need exact constructor signatures for pattern classes
• Want to understand coordination database schema
• Implementing custom patterns using primitives
• Debugging agent tracking or orphan detection

Quick Reference

11 Pattern Classes

| Pattern | Purpose | Key Method | |---------|---------|------------| | Swarm | Parallel perspectives | .execute(query) | | Pipeline | Sequential stages | .run(initial_state) | | Hierarchical | Coordinator + specialists | .execute(task) | | Jury | Voting consensus | .decide(return_type, question) | | GeneratorCritic | Iterative refinement | .run(task) | | CircuitBreaker | Failure fallback | .execute(query) | | Adversarial | Debate + judge | .resolve(question) | | ChainOfResponsibility | Route to handler | .process(query) | | MapReduce | Fan out + reduce | .execute(query, chunks) | | Blackboard | Shared state | .solve(query) | | EventDriven | Event bus | .publish(event) |

Core Infrastructure

| Component | File | Purpose | |-----------|------|---------| | CoordinationDB | coordination.py | SQLite tracking | | tracked_spawn | tracked_agent.py | Agent with tracking | | HandoffAtom | handoff_atom.py | Universal handoff format | | BlackboardCache | blackboard.py | Hot tier communication | | MemoryService | memory_service.py | Core + Archival memory | | create_claude_scope | claude_scope.py | Scope with file ops |

Primitives

| Primitive | Purpose | |-----------|---------| | Consensus | Voting (MAJORITY, UNANIMOUS, THRESHOLD) | | Aggregator | Combine results (MERGE, CONCAT, BEST) | | HandoffState | Structured agent handoff | | build_premise | Structured premise builder | | gather_fail_fast | TaskGroup-based parallel execution |

Full API Spec

See: API_SPEC.md in this skill directory

Usage Example

from scripts.agentica_patterns.patterns import Swarm, Jury
from scripts.agentica_patterns.primitives import ConsensusMode
from scripts.agentica_patterns.coordination import CoordinationDB
from scripts.agentica_patterns.tracked_agent import tracked_spawn

# Create tracking database
db = CoordinationDB(session_id="my-session")

# Swarm with tracking
swarm = Swarm(
    perspectives=["Security expert", "Performance expert"],
    db=db
)
result = await swarm.execute("Review this code")

# Jury with consensus
jury = Jury(
    num_jurors=3,
    consensus_mode=ConsensusMode.MAJORITY,
    premise="You evaluate code quality",
    db=db
)
verdict = await jury.decide(bool, "Is this code production ready?")

Location

API spec: .claude/skills/agentica-infrastructure/API_SPEC.md Source: scripts/agentica_patterns/