Knowledge Wiki Orchestrata Ultimate

Orchestrata Ultimate / RTM / 005-multi-agent

RTM: 005-multi-agent

Requirement to symbol to test rows for 005-multi-agent: Multi-Agent Coordination.

At a glance

Item Value
Requirement IDs 48
Traced from src/ 25 (52.1%)
Untraced 23
Cited from tests/ 0 (0.0%)
Traced in src/ but not cited from tests/ 25

Reading this matrix

This matrix lists each of the 48 requirement IDs of spec 005-multi-agent with the src/ symbols that cite it and the tests that cite it. 25 of them (52.1%) have at least one citing symbol and 23 have none.

0 requirements are also cited from tests/, and 25 are traced in code but never named by a test. A test citation is a @traces on a test function; it shows intent to cover, not that the test runs or reaches the symbol.

Rows showing none in the symbols column are the gaps to close first. The densest untraced groups are REQ-005-NFR2 (1), REQ-005-NFR3 (1), REQ-005-US-007 (1).

Requirement to symbols to tests

Requirement Symbols in src/ Tests citing it
REQ-005-US-001-001 As a developer, I can spawn lightweight Prolog agents that handle specialized tasks... orchestrata_ultimate/agents/exceptions VolkSpawnError L28
orchestrata_ultimate/agents/interfaces spawn L36
orchestrata_ultimate/agents/pool _try_scale_up L84
+7 more		 none
REQ-005-US-002-001 As a system architect, I can define agent escalation paths that automatically promote... orchestrata_ultimate/agents/escalation AgentEscalation L65
orchestrata_ultimate/agents/escalation escalate L107
orchestrata_ultimate/agents/escalation get_escalation_path L93		 none
REQ-005-US-003-001 As a developer, I can configure agent lifespans to automatically terminate agents when... orchestrata_ultimate/agents/lifecycle AgentLifecycle L76
orchestrata_ultimate/agents/lifecycle LifecycleError L63
orchestrata_ultimate/agents/lifecycle LifespanType L30
+3 more		 none
REQ-005-US-004-001 As a system operator, I can monitor agent spawning metrics and performance to ensure... orchestrata_ultimate/agents/lifecycle AgentLifecycle L76
orchestrata_ultimate/agents/runtime VolkRuntime L45
orchestrata_ultimate/agents/runtime get_health L112		 none
REQ-005-US-005-001 As a developer, I can define constitutional constraints that prevent agents from... orchestrata_ultimate/agents/constraints ConstitutionalConstraints L111
orchestrata_ultimate/agents/constraints Constraint L51
orchestrata_ultimate/agents/constraints set_constraints L346		 none
REQ-005-US-006-001 As an agent, I can escalate to a higher-level agent when I encounter situations... orchestrata_ultimate/agents/communication escalate_message L164
orchestrata_ultimate/agents/escalation AgentEscalation L65
orchestrata_ultimate/agents/escalation EscalationResult L30
+1 more		 none
REQ-005-FR1-001 Agent spawn time < 100ms (measured from request to first query execution) orchestrata_ultimate/agents/lifecycle _create_instance L112
orchestrata_ultimate/agents/lifecycle spawn_with_validation L159
orchestrata_ultimate/agents/runtime spawn L202		 none
REQ-005-FR2-001 Escalation path resolution < 10ms (measured from escalation trigger to parent agent... orchestrata_ultimate/agents/escalation get_escalation_path L93
orchestrata_ultimate/agents/hierarchy get_ancestors L211
orchestrata_ultimate/agents/hierarchy get_parent L184		 none
REQ-005-FR3-001 Agent lifecycle management with automatic cleanup when task completes orchestrata_ultimate/agents/interfaces IVolkRuntime L28
orchestrata_ultimate/agents/lifecycle AgentLifecycle L76
orchestrata_ultimate/agents/lifecycle LifecycleError L63
+19 more		 none
REQ-005-FR4-001 Constitutional constraint validation at agent spawn and during execution orchestrata_ultimate/agents/constraints ConstitutionalConstraints L111
orchestrata_ultimate/agents/constraints ConstraintResult L25
orchestrata_ultimate/agents/constraints _check_alias_and_resources L137
+10 more		 none
REQ-005-FR5-001 Hierarchical agent organization with parent-child relationships orchestrata_ultimate/agents/hierarchy AgentHierarchy L61
orchestrata_ultimate/agents/hierarchy HierarchyError L52
orchestrata_ultimate/agents/hierarchy HierarchyNode L26
+15 more		 none
REQ-005-FR6-001 Agent context isolation with controlled fact visibility orchestrata_ultimate/agents/constraints ConstitutionalConstraints L111
orchestrata_ultimate/agents/constraints check_fact_visibility L289		 none
REQ-005-FR7-001 Escalation mechanism with automatic parent notification orchestrata_ultimate/agents/communication escalate_message L164
orchestrata_ultimate/agents/communication send_to_parent L109
orchestrata_ultimate/agents/escalation AgentEscalation L65
+3 more		 none
REQ-005-FR8-001 Performance metrics collection for agent spawn, query, and escalation operations orchestrata_ultimate/agents/escalation get_pending_escalations L256
orchestrata_ultimate/agents/escalation pending_count L275
orchestrata_ultimate/agents/escalation total_escalations L266
+1 more		 none
REQ-005-NFR1-001 System maintains performance with 100+ concurrent lightweight agents orchestrata_ultimate/agents/pool VolkPool L41
orchestrata_ultimate/agents/pool _get_config L66
orchestrata_ultimate/agents/pool acquire L95
+1 more		 none
REQ-005-NFR2-001 Agent spawn overhead < 1MB memory per agent none none
REQ-005-NFR3-001 Constitutional validation adds < 5ms to spawn time none none
REQ-005-NFR4-001 Escalation paths are deterministic and reproducible orchestrata_ultimate/agents/escalation get_escalation_path L93
orchestrata_ultimate/agents/hierarchy get_ancestors L211
orchestrata_ultimate/agents/hierarchy is_ancestor L260		 none
REQ-005-NFR5-001 System remains responsive during agent cleanup operations orchestrata_ultimate/agents/hierarchy get_descendants L232
orchestrata_ultimate/agents/hierarchy remove_agent L164
orchestrata_ultimate/agents/hierarchy remove_child L139
+6 more		 none
REQ-005-AC1-001 Agent spawn time verified < 100ms in benchmark tests orchestrata_ultimate/agents/lifecycle spawn_with_validation L159 none
REQ-005-AC2-001 Escalation path resolution verified < 10ms in benchmark tests orchestrata_ultimate/agents/escalation get_escalation_path L93
orchestrata_ultimate/agents/hierarchy get_ancestors L211		 none
REQ-005-AC3-001 Constitutional constraints validated at spawn and runtime orchestrata_ultimate/agents/constraints ConstitutionalConstraints L111
orchestrata_ultimate/agents/constraints ConstraintResult L25
orchestrata_ultimate/agents/constraints _check_alias_and_resources L137
+6 more		 none
REQ-005-AC4-001 Parent-child relationships maintained correctly during escalation orchestrata_ultimate/agents/communication CommunicationError L26
orchestrata_ultimate/agents/communication send_to_child L120
orchestrata_ultimate/agents/communication send_to_parent L109
+11 more		 none
REQ-005-AC5-001 Automatic cleanup verified for completed agents orchestrata_ultimate/agents/hierarchy get_descendants L232
orchestrata_ultimate/agents/hierarchy remove_agent L164
orchestrata_ultimate/agents/lifecycle AgentLifecycle L76
+2 more		 none
REQ-005-AC6-001 Performance metrics collected and accessible via monitoring interface orchestrata_ultimate/agents/communication _deliver L185
orchestrata_ultimate/agents/communication get_metrics L204
orchestrata_ultimate/agents/escalation get_pending_escalations L256
+10 more		 none
REQ-005-US-007-001 As a senior volk, I can spawn junior volks with configurable ACP drivers so that I can... none none
REQ-005-US-008-001 As a senior volk, I can delegate tasks to junior volks via CXP packets and receive... none none
REQ-005-US-009-001 As a senior volk, I can fan out the same task to multiple junior volks in parallel,... none none
REQ-005-US-010-001 As the system, I can drive browser-based free-tier LLM chat interfaces via automation... none none
REQ-005-FR9-001 Junior volk spawns with driver initialization — CLI driver <500ms, API driver <200ms,... none none
REQ-005-FR10-001 Senior-to-junior delegation uses standard CXP packets routed through Postman,... orchestrata_ultimate/agents/volks/base send L145
orchestrata_ultimate/orchestrator/pipeline_escalation resolve_capability L178		 none
REQ-005-FR11-001 Parallel delegation sends same CXP task packet to N junior volks simultaneously (max 5... none none
REQ-005-FR12-001 Senior volk receives all junior outputs, compares quality, selects best elements, and... none none
REQ-005-FR13-001 Browser driver manages Playwright sessions with login persistence, timeout handling,... none none
REQ-005-FR14-001 Free-tier quota tracking per ACP — system tracks remaining quota and falls back to... none none
REQ-005-FR15-001 Driver interface is uniform — senior volk code is identical regardless of whether... none none
REQ-005-FR16-001 Junior volk output is always a CXP packet with work_status and payload — driver... none none
REQ-005-NFR6-001 CLI/API driver task kickoff response < 500ms (p95) none none
REQ-005-NFR7-001 Browser driver task kickoff response < 5s (p95) including page load none none
REQ-005-NFR8-001 Senior volk synthesis decision < 30s (p95) for comparing up to 5 junior outputs none none
REQ-005-NFR9-001 Browser sessions remain stable for up to 30 minutes of interaction none none
REQ-005-NFR10-001 System degrades gracefully when all free-tier quotas are exhausted — falls back to... none none
REQ-005-AC7-001 Junior volk spawned with CLI driver produces output within 60s for a simple coding task none none
REQ-005-AC8-001 Junior volk spawned with Browser driver produces output within 120s for a simple... none none
REQ-005-AC9-001 Comparison delegation with 3 junior volks produces 3 distinct outputs and senior... none none
REQ-005-AC10-001 Quota exhaustion on one ACP triggers automatic fallback to alternative ACP none none
REQ-005-AC11-001 All junior volk communication uses CXP — no direct ACP-native protocol exposed to... orchestrata_ultimate/agents/volks/base send L145
orchestrata_ultimate/orchestrator/pipeline_escalation resolve_capability L178		 none
REQ-005-AC12-001 Browser driver handles session timeout and re-authenticates without data loss none none