AST Diagram — Package Dependencies
Component-level dependency graph of src/orchestrata_ultimate — each node is a
top-level package, each edge a real import found in the source AST (tests
excluded). For per-module class maps see the individual module pages.
29 nodes, 113 edges. Extracted with Python ast.
Generated from the live source AST by scripts/gen-ast-project-diagrams.py (re-run it, then scripts/render-diagrams.py, to refresh).
Structure tree (visual AST)
Real directory/module tree of src/orchestrata_ultimate, walked directly off disk
(find ... -name "*.py") and cross-checked against docs/CODEBASE_MAP.md. Every
node below is a path that exists on disk right now — no invented names.
Package overview — src root → all 27 top-level packages, each leaf carrying its true .py module count.
Deep tree 1/3 — agents/ (76 modules): 24 top-level files + swarm/ (3) + volks/ (49 across 5 shared files and 11 volk sub-packages).
Deep tree 2/3 — factory/ (72 modules): only __init__.py at top level, all else in 16 sub-packages.
Deep tree 3/3 — verification/ (64 modules): 6 top-level files + 16 sub-packages (includes a nested verification/verification/ engine+feedback pair).
Class-level diagrams — kernel, volks, factory scheduler
Hand-verified against the live source (grep/AST, 2026-07-24) — every class,
method, and inheritance edge below exists in src/orchestrata_ultimate as shown.
Kernel core — OrchestrataKernel/OrchestrationKernel implementing the component protocol, plus MessageDispatcher's dispatch-result model
Volks — BaseAgent (Pydantic BaseModel) and its concrete per-role subclasses, all overriding process()
Thin *Agent aliases (QualityAssuranceAgent(QaVolk), ProjectManagerAgent(PMVolk),
CodeDirectorAgent(CodeDirectorVolk), JuniorAgent(JuniorVolk),
UserExperienceAgent(UXVolk), ConciergeAgent(ConciergeVolk),
DocumentorAgent(DocumentorVolk), ComplianceAgent(ComplianceVolk)) exist as
one-line pass-body subclasses of the volks above and are omitted here for
readability.
Factory build scheduler (SPEC-033 §9, B9) — function/call ownership, not OO (run_pipeline is a free function)