orchestrata_ultimate.agents.volks.codedirector.scaffold

Reference › orchestrata_ultimate › agents › volks › codedirector › scaffold

Project scaffold generator for CodeDirector code generation.

The scaffold package turns the Architect's design output into a project skeleton on disk, so the code-writing stage starts from real files with the right names, imports and signatures. The CodeDirector's implementation module calls it before choosing the swarm or serial path.

It has three working modules. types defines the dataclasses MethodSpec, ClassSpec, ModuleSpec and ProjectSpec. parser reads the FILE_TREE and API_SPEC sections, including the dependency list and any complete code blocks, into those specs. generator renders them: directories, pyproject.toml, conftest.py, package __init__.py files and module stubs through Jinja templates. init re-exports the public names.

Data flows one way: design text, then build_project_spec in the parser, then generate_skeleton in the generator, which returns the list of files written. Start reading at generate_skeleton in generator, then follow build_project_spec into parser. The parent package is described on the codedirector page.

4 modules, 1,312 lines of code.

Modules

Module Summary LOC
__init__ Project scaffold generator for CodeDirector code generation. 23
generator Generate project skeleton from parsed design output. 455
parser Parse architect design output into structured specs. 780
types Data structures for parsed design output. 54

Dependency diagram

Package dependency diagram orchestrata_ultimate.agents.volks.codedirector.scaffold