How tsubasa-kaede/runtime-neutral-agent-engineering works
dual-agent is a runtime-neutral orchestration layer for coding-agent CLIs. Its principal workflow discovers runtimes, qualifies them with evidence, selects verified capabilities, and executes bounded single- or multi-agent work with structured handoffs and provenance. The README also documents a live collaboration cockpit for monitoring and steering runs. Edges reflect the README and sampled source; some subsystem wiring is not shown in the excerpts, so uncertain links are omitted.
Main entry points: cli.py CLI commands · execution_engine.py Execution gates · collaboration_session.py Collaboration session · collaboration_orchestrator.py Collaboration routing
Components 20
Host and CLI
- Host composition
dual-agent-development/scripts/host_entry.py - CLI commands
dual-agent-development/scripts/cli.py
Qualification and Selection
- Runtime discovery
dual-agent-development/scripts/runtime_discovery.py - Runtime validation
dual-agent-development/scripts/real_validation_executor.py - Qualification evidence
dual-agent-development/scripts/evidence_store.py - Verified runtime pool
dual-agent-development/scripts/verified_runtime_pool.py - Verified stage selection
dual-agent-development/scripts/verified_stage_selector.py
Orchestration and Execution
- Collaboration routing
dual-agent-development/scripts/collaboration_orchestrator.py - Verified orchestration
dual-agent-development/scripts/verified_orchestrator.py - Execution gates
dual-agent-development/scripts/execution_engine.py - Budget control
dual-agent-development/scripts/task_budget.py - Loop protection
dual-agent-development/scripts/loop_guard.py
Collaboration and Control
- Collaboration session
dual-agent-development/scripts/collaboration_session.py - Structured packets
dual-agent-development/scripts/structured_packets.py - Handoff transport
dual-agent-development/scripts/remote_transport.py - Live cockpit
dual-agent-development/scripts/cockpit_entry.py - Content safety
dual-agent-development/scripts/content_safety.py
Runtime Integrations
- Runtime adapters
dual-agent-development/scripts/external_agent_adapter.py - Agent CLIs
Other components
- User
Connections 23
- User → Host composition: invokes
- Host composition → CLI commands: injects facade
- CLI commands → Runtime discovery: discovers runtimes
- CLI commands → Runtime validation: qualifies
- Runtime validation → Qualification evidence: persists evidence
- CLI commands → Qualification evidence: reads evidence
- Qualification evidence → Verified runtime pool: admits verified
- Verified runtime pool → Verified stage selection: provides candidates
- CLI commands → Collaboration routing: runs task
- Collaboration routing → Verified orchestration: delegates single path
- Collaboration routing → Collaboration session: runs dual path
- Verified orchestration → Verified stage selection: plans stages
- Verified orchestration → Execution gates: executes plan
- Execution gates → Budget control: reserves calls
- Execution gates → Loop protection: checks loops
- Execution gates → Runtime adapters: invokes agents
- Runtime adapters → Agent CLIs: drives runtime
- Collaboration session → Runtime adapters: invokes agents
- Collaboration session → Structured packets: validates handoffs
- Collaboration session → Handoff transport: sends handoffs
- CLI commands → Live cockpit: opens cockpit
- Live cockpit → Collaboration routing: controls collaboration
- Live cockpit → Content safety: scans content