Orchestrata Ultimate › Plans › plan_subphase_1_6 › subplan-agents-2026-04-12
Subplan: Sub-phase 1.6 — Agent Implementations (Steps 74-96)
Source: plans/plan_subphase_1_6/subplan-agents-2026-04-12.md at 8a2cb42ad · last changed 2026-07-27 · first committed 2026-04-12 · 68 lines.
Prose pending.
Plan text
Subplan: Sub-phase 1.6 — Agent Implementations (Steps 74-96)
Context
Sub-phases 1.3-1.5 complete. 1522 tests pass. This subplan ports the agent framework (~22 files) and 9 volk packages (~38 files) — the largest sub-phase in Tier 1.
Source:
- Framework:
/home/mohamed/workspace/orchestrata/packages/orchestrata-agents/src/orchestrata/agents/ - Volks:
/home/mohamed/workspace/orchestrata/packages/orchestrata-{analyst,architect,codedirector,compliance,concierge,junior,qa,ux,pm}/
Target: /home/mohamed/workspace/orchestrata-ultimate/src/orchestrata_ultimate/agents/
Coverage gate: --cov-fail-under=90 on agents/ package.
Traceability: @traces("REQ-1.6-XXX") on all public classes.
Rename: Volk -> Agent in all class names, constants, function names.
Steps
Steps 74-76: Port base framework
- types.py, constants.py, exceptions.py, communication.py, hierarchy.py, constraints.py
- Rename VOLK_ -> AGENT_ in constants
- @traces("REQ-1.6-001")
Step 77: Unified BaseAgent (CXPMixin + Pydantic)
- Replace existing base_agent.py stub with full implementation
- CXPMixin: send, emit_event, set_postman, set_kg
- BaseAgent: Pydantic BaseModel + CXPMixin
- @traces("REQ-1.6-002")
Step 78: Port interfaces.py -> protocols.py
- Convert ABC to Protocol
- @traces("REQ-1.6-002")
Step 79: Create volks/ + port swarm/
- swarm/coordinator.py, swarm/types.py
- @traces("REQ-1.6-003")
Steps 80-89: Port all 9 volks + senior_dev
- analyst (3 files), architect (5+ files), codedirector (6 files + scaffold/), compliance (2 files), concierge (1 file), junior (1 file), qa (1 file), ux (1 file), pm (3 files), senior_dev (1 file)
- Each: XxxVolk -> XxxAgent, BaseVolk -> BaseAgent
- @traces("REQ-1.6-004") through REQ-1.6-006
Steps 91-94: Port utility modules
- prompt_builder.py, spec_writer.py, uml_generator.py, cxp_adapter.py, postman_adapter.py, di.py
- @traces("REQ-1.6-007")
Step 95: Update agents/init.py
Step 96: Keep existing stubs (tests reference them)
Gate check — imports, tests >=1522, coverage >=90%
Requirements
| REQ ID | Description |
|---|---|
| REQ-1.6-001 | Framework types/constants/exceptions import |
| REQ-1.6-002 | BaseAgent with CXPMixin works |
| REQ-1.6-003 | Swarm coordinator imports |
| REQ-1.6-004 | All 9 volks import with Agent names |
| REQ-1.6-005 | Volk->Agent rename complete |
| REQ-1.6-006 | os.environ safe, Python 2 syntax fixed |
| REQ-1.6-007 | Utility modules import |
| REQ-1.6-008 | Tests pass (>=1522), coverage >=90% |