orchestrata_ultimate.agents.volks

Reference › orchestrata_ultimate › agents › volks

The volks package holds the agent brains of Orchestrata: the specialist agents (volks) that form the software-delivery team. Each volk is a Pydantic subclass of BaseAgent (base), which provides identity, CXP messaging through Postman, an event node, memory recall and the LLM call paths including the tool-calling loop. Shared helpers are persona (the team preamble prepended to every role prompt), memory_context (run-scoped memory recall) and _edit_review (deterministic checks for edit reviews).

The volks, in pipeline order, each with a subpackage:

Data moves between volks as CXP packets whose subjects name the next action (analyze_requirements, scope_review, ux_design, implement, design_review, review_and_test, compliance_check, among others); the kernel pipeline and the task executor (task_executor) instantiate and drive them. Start reading at base, then the volk you care about. The narrative is in volks and agents.

50 modules, 16,405 lines of code.

Subpackages

Package Modules LOC
analyst 4 804
architect 5 1,615
codedirector 10 4,835
compliance 3 857
concierge 2 464
documentor 3 316
junior 2 722
pm 5 1,888
qa 7 3,689
senior_dev 2 168
ux 2 240

Modules

Module Summary LOC
__init__ 0
_edit_review Shared helpers for the review_edit handlers (SPEC-050 P3.1). 168
base Base agent class. 559
memory_context Run-scoped memory-context provider registry (agent-facing re-export). 33
persona Shared volk identity + communication-fabric preamble. 47

Dependency diagram

Package dependency diagram orchestrata_ultimate.agents.volks