agentica-infrastructure

SKILL.md

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/