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:
- concierge (
U:Cx): clarifies the human's intent. - analyst (
U:BA): writes stories and requirements. - pm (
U:PM): validates scope and routes. - ux (
U:Ux): UI design, only for UI projects. - architect (
U:Ar): designs, with review by the Junior. - junior (
J:Junior): design reviewer and code generator. - codedirector (
U:Cd): builds the code. - qa (
U:Qa): reviews and tests. - compliance (
U:Cp): deterministic traceability check. - documentor (
U:Do): documentation. - senior_dev (
U:SD): out-of-band root-cause analysis for oscillating runs.
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 |