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/