agentica infrastructure
- Repo stars 3,783
- Author repo Continuous-Claude-v3
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @parcadei · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- Python
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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?")
# 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
```python
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/`
Sections and files
Listed in source order.
sections -> When to Use → Quick Reference → 11 Pattern Classes → Core Infrastructure → Primitives → Full API Spec
terms -> Complete API specification for Agentica multi-agent coordination infrastructure.
files/cmd -> Swarm · .execute(query) · Pipeline · .run(initial_state) · Hierarchical · .execute(task) · Jury · .decide(return_type, question)
body sha256 -> 87fef76567df
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
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)Core Infrastructure
Component · File · Purpose
CoordinationDB·coordination.py· SQLite trackingtracked_spawn·tracked_agent.py· Agent with trackingHandoffAtom·handoff_atom.py· Universal handoff formatBlackboardCache·blackboard.py· Hot tier communicationPrimitives
Primitive · Purpose
Consensus· Voting (MAJORITY, UNANIMOUS, THRESHOLD)Aggregator· Combine results (MERGE, CONCAT, BEST)HandoffState· Structured agent handoffbuild_premise· Structured premise builderFull API Spec
See:
API_SPEC.mdin this skill directory