Knowledge Wiki Orchestrata Ultimate

Orchestrata Ultimate / RTM / 029-codedirector-volk

RTM: 029-codedirector-volk

Requirement to symbol to test rows for 029-codedirector-volk: CodeDirector Volk (U:Cd).

At a glance

Item Value
Requirement IDs 75
Traced from src/ 73 (97.3%)
Untraced 2
Cited from tests/ 0 (0.0%)
Traced in src/ but not cited from tests/ 73

Reading this matrix

This matrix lists each of the 75 requirement IDs of spec 029-codedirector-volk with the src/ symbols that cite it and the tests that cite it. 73 of them (97.3%) have at least one citing symbol and 2 have none.

0 requirements are also cited from tests/, and 73 are traced in code but never named by a test. A test citation is a @traces on a test function; it shows intent to cover, not that the test runs or reaches the symbol.

Rows showing none in the symbols column are the gaps to close first. The densest untraced groups are REQ-029-* (2).

Requirement to symbols to tests

Requirement Symbols in src/ Tests citing it
REQ-029-001 CodeDirectorVolk sets alias = "U:Cd" and role = "CodeDirector (Coder)" as... orchestrata_ultimate/agents/volks/codedirector/volk CodeDirectorVolk L52 none
REQ-029-002 process() routes packets with subject "implement" to _handle_implement(). orchestrata_ultimate/agents/volks/codedirector/volk process L87 none
REQ-029-003 process() routes packets with subject "implementation_complete" to... orchestrata_ultimate/agents/volks/codedirector/volk process L87 none
REQ-029-004 process() routes packets with subject "fix_issues" to _handle_fix_issues(). orchestrata_ultimate/agents/volks/codedirector/volk process L87 none
REQ-029-005 process() returns None for unrecognised subjects without raising an exception. orchestrata_ultimate/agents/volks/codedirector/volk process L87 none
REQ-029-006 escalation_target is set to "U:Qa" during __init__. orchestrata_ultimate/agents/volks/codedirector/volk __init__ L59 none
REQ-029-007 _handle_implement() calls _init_from_packet() which sets `self.status =... orchestrata_ultimate/agents/volks/codedirector/volk _handle_implement L112
orchestrata_ultimate/agents/volks/codedirector/volk _init_from_packet L140		 none
REQ-029-008 _init_from_packet() reads task_summary from pkt.payload and stores it on the... orchestrata_ultimate/agents/volks/codedirector/volk _init_from_packet L140 none
REQ-029-009 _init_from_packet() reads original_intent from pkt.payload and stores it on the... orchestrata_ultimate/agents/volks/codedirector/volk _init_from_packet L140 none
REQ-029-010 _init_from_packet() reads project_dir from pkt.payload and overrides... orchestrata_ultimate/agents/volks/codedirector/volk _init_from_packet L140 none
REQ-029-011 _init_from_packet() sets self.current_thread to pkt.thread_id. orchestrata_ultimate/agents/volks/codedirector/volk _init_from_packet L140 none
REQ-029-012 _handle_implement() calls extract_design_docs(pkt) to produce the design docs dict... orchestrata_ultimate/agents/volks/codedirector/volk _handle_implement L112 none
REQ-029-013 extract_design_docs() returns a dict with exactly these keys: file_tree,... orchestrata_ultimate/agents/volks/codedirector/implementation extract_design_docs L161 none
REQ-029-014 extract_design_docs() returns empty string for any key absent from the packet... orchestrata_ultimate/agents/volks/codedirector/implementation extract_design_docs L161 none
REQ-029-015 extract_design_docs() reads values only from packet.payload without side effects... orchestrata_ultimate/agents/volks/codedirector/implementation extract_design_docs L161 none
REQ-029-016 generate_skeleton_files() returns an empty list when both file_tree and api_spec... orchestrata_ultimate/agents/volks/codedirector/implementation generate_skeleton_files L186 none
REQ-029-017 generate_skeleton_files() calls `generate_skeleton(workspace, design_docs,... orchestrata_ultimate/agents/volks/codedirector/implementation generate_skeleton_files L186 none
REQ-029-018 ScaffoldGenerator creates the mandatory directories tests/, tests/unit/,... orchestrata_ultimate/agents/volks/codedirector/scaffold/generator _create_directories L200 none
REQ-029-019 ScaffoldGenerator writes __init__.py for tests/, tests/unit/, and... orchestrata_ultimate/agents/volks/codedirector/scaffold/generator _create_directories L200 none
REQ-029-020 ScaffoldGenerator generates pyproject.toml from pyproject.toml.j2 template with... orchestrata_ultimate/agents/volks/codedirector/scaffold/generator _generate_pyproject L260
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_dependencies L628		 none
REQ-029-021 ScaffoldGenerator writes context.json at the project root if it does not already... orchestrata_ultimate/agents/volks/codedirector/scaffold/generator generate_skeleton L75 none
REQ-029-022 ScaffoldGenerator runs uv sync --python 3.14t --all-extras after pyproject.toml... orchestrata_ultimate/agents/volks/codedirector/scaffold/generator generate_skeleton L75 none
REQ-029-023 parse_file_tree() correctly strips tree-drawing characters (├──, └──, │, ─)... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_file_tree L14 none
REQ-029-024 parse_file_tree() reconstructs nested file paths by tracking a directory stack based... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_file_tree L14 none
REQ-029-025 parse_file_tree() handles directory entries ending with / by pushing them onto the... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_file_tree L14 none
REQ-029-026 parse_file_tree() returns an empty list for empty or whitespace-only input without... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_file_tree L14 none
REQ-029-027 parse_api_spec() recognises Module: path.py headers and creates a new ModuleSpec... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _ApiSpecParser L94
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _flush_module L164
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _handle_module_header L171
+2 more		 none
REQ-029-028 parse_api_spec() extracts Imports: section lines that start with from or... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _ApiSpecParser L94
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _handle_imports L190
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse L121
+1 more		 none
REQ-029-029 parse_api_spec() parses class headers matching ClassName: or ClassName(Base):... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _ApiSpecParser L94
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _flush_class L158
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse L121
+1 more		 none
REQ-029-030 parse_api_spec() parses method definitions matching `def name(params) ->... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _ApiSpecParser L94
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse L121
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_api_spec L325		 none
REQ-029-031 parse_api_spec() attaches methods to the current class when a class is active, and... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_api_spec L325 none
REQ-029-032 parse_api_spec() correctly handles Raises: ExceptionType lines by appending the... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_api_spec L325 none
REQ-029-033 parse_code_blocks() extracts complete code from **Module: \pkg.module`**`... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _consume_code_block L352
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _consume_std_module_block L382
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _match_block_header L413
+1 more		 none
REQ-029-034 parse_code_blocks() normalises dotted module paths to src/pkg/module.py file... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _normalize_module_path L61
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser parse_code_blocks L452		 none
REQ-029-035 parse_code_blocks() handles **src/pkg/module.py** path-style headers and extracts... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _consume_code_block L352
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _consume_std_module_block L382
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _match_block_header L413
+2 more		 none
REQ-029-036 _parse_single_block() handles a single fenced block containing multiple modules... orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _extract_fenced_body L515
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _next_module_marker L536
orchestrata_ultimate/agents/volks/codedirector/scaffold/parser _parse_single_block L556		 none
REQ-029-037 get_fan_out_decision() calls prolog.fan_out_decision(slug, file_count) when a... orchestrata_ultimate/agents/volks/codedirector/implementation get_fan_out_decision L242 none
REQ-029-038 get_fan_out_decision() returns the Python fallback dict with allowed=True when... orchestrata_ultimate/agents/volks/codedirector/implementation get_fan_out_decision L242 none
REQ-029-039 get_fan_out_decision() returns allowed=False for file_count < 2 in the Python... orchestrata_ultimate/agents/volks/codedirector/implementation get_fan_out_decision L242 none
REQ-029-040 get_fan_out_decision() caps max_shards at min(file_count, 10) in the Python... orchestrata_ultimate/agents/volks/codedirector/implementation get_fan_out_decision L242 none
REQ-029-041 _handle_implement() chooses the swarm path only when decision["allowed"] == True... none none
REQ-029-042 execute_swarm_path() instantiates SwarmCoordinator with workspace,... orchestrata_ultimate/agents/volks/codedirector/implementation execute_swarm_path L278 none
REQ-029-043 execute_swarm_path() calls... orchestrata_ultimate/agents/volks/codedirector/implementation execute_swarm_path L278 none
REQ-029-044 _swarm_path() appends a formatted swarm artifact string to self.output_artifacts. orchestrata_ultimate/agents/volks/codedirector/implementation _format_swarm_artifact L321
orchestrata_ultimate/agents/volks/codedirector/volk _swarm_path L162		 none
REQ-029-045 _swarm_path() runs _run_self_review() on the aggregated files when files_created... orchestrata_ultimate/agents/volks/codedirector/volk _run_self_review L480
orchestrata_ultimate/agents/volks/codedirector/volk _swarm_path L162		 none
REQ-029-046 _serial_path() dispatches a CXP packet with to_agent="J:Junior",... orchestrata_ultimate/agents/volks/codedirector/volk _serial_path L190 none
REQ-029-047 build_skeleton_prompt() produces a prompt containing "SKELETON FILES TO IMPLEMENT"... orchestrata_ultimate/agents/volks/codedirector/implementation _read_skeleton_contents L430
orchestrata_ultimate/agents/volks/codedirector/implementation build_skeleton_prompt L377		 none
REQ-029-048 build_skeleton_prompt() instructs the junior not to create new files, not to change... orchestrata_ultimate/agents/volks/codedirector/implementation build_skeleton_prompt L377 none
REQ-029-049 build_fallback_prompt() includes the workspace path, task_summary, and requirements... orchestrata_ultimate/agents/volks/codedirector/implementation build_fallback_prompt L460 none
REQ-029-050 append_prompt_extras() appends CODING_STANDARDS to every aider prompt. orchestrata_ultimate/agents/volks/codedirector/implementation append_prompt_extras L503 none
REQ-029-051 append_prompt_extras() appends the original_intent under "ORIGINAL SPEC" heading... orchestrata_ultimate/agents/volks/codedirector/implementation append_prompt_extras L503 none
REQ-029-052 append_prompt_extras() appends monorepo_src_section under "CRITICAL — EXISTING API... orchestrata_ultimate/agents/volks/codedirector/implementation append_prompt_extras L503 none
REQ-029-053 _handle_junior_complete() reads files_created and output from the incoming... orchestrata_ultimate/agents/volks/codedirector/volk _handle_junior_complete L247 none
REQ-029-054 _handle_junior_complete() checks self._pending_fix and routes to... orchestrata_ultimate/agents/volks/codedirector/review _build_fix_failed_response L474
orchestrata_ultimate/agents/volks/codedirector/review _build_qa_packet L440
orchestrata_ultimate/agents/volks/codedirector/review handle_fix_return L401
+1 more		 none
REQ-029-055 _handle_junior_complete() runs _run_self_review() when files_created is... orchestrata_ultimate/agents/volks/codedirector/volk _handle_junior_complete L247
orchestrata_ultimate/agents/volks/codedirector/volk _run_self_review L480		 none
REQ-029-056 _handle_junior_complete() returns _make_ready_packet(pkt, full_output=True) on the... orchestrata_ultimate/agents/volks/codedirector/volk _handle_junior_complete L247 none
REQ-029-057 _log_junior_output() appends the raw junior output and files list to... orchestrata_ultimate/agents/volks/codedirector/volk _log_junior_output L504 none
REQ-029-058 _handle_fix_issues() reads issues, project_dir, and review_cycle from the... orchestrata_ultimate/agents/volks/codedirector/volk _handle_fix_issues L297 none
REQ-029-059 _handle_fix_issues() overrides self.workspace with project_dir from the packet... orchestrata_ultimate/agents/volks/codedirector/volk _handle_fix_issues L297 none
REQ-029-060 _handle_fix_issues() calls prepare_fix_delegation(pkt, workspace) and stores the... orchestrata_ultimate/agents/volks/codedirector/review prepare_fix_delegation L513
orchestrata_ultimate/agents/volks/codedirector/review prioritize_issues L288
orchestrata_ultimate/agents/volks/codedirector/volk _handle_fix_issues L297		 none
REQ-029-061 _handle_fix_issues() returns the delegated J:Junior packet directly, not... orchestrata_ultimate/agents/volks/codedirector/volk _handle_fix_issues L297 none
REQ-029-062 self_review_loop() calls run_deterministic_review() before each LLM review pass. none none
REQ-029-063 self_review_loop() exits the loop immediately when the LLM returns `REVIEW_VERDICT:... orchestrata_ultimate/agents/volks/codedirector/review _run_review_cycle L110
orchestrata_ultimate/agents/volks/codedirector/review parse_issues L370
orchestrata_ultimate/agents/volks/codedirector/review parse_verdict L348
+1 more		 none
REQ-029-064 self_review_loop() exits after MAX_SELF_REVIEW_CYCLES iterations even when the... orchestrata_ultimate/agents/volks/codedirector/review self_review_loop L37 none
REQ-029-065 self_review_loop() returns the updated files_created list after each fix application. orchestrata_ultimate/agents/volks/codedirector/review ReviewContext L89
orchestrata_ultimate/agents/volks/codedirector/review _apply_review_fixes L211
orchestrata_ultimate/agents/volks/codedirector/review self_review_loop L37		 none
REQ-029-066 self_review_loop() passes graph_context to the LLM review when it is provided. orchestrata_ultimate/agents/volks/codedirector/review _run_review L152
orchestrata_ultimate/agents/volks/codedirector/review self_review_loop L37		 none
REQ-029-067 Deterministic check SYNTAX runs ast.parse() on each Python file and produces an... orchestrata_ultimate/agents/volks/codedirector/review_checks run_deterministic_review L1272 none
REQ-029-068 Deterministic check IMPORTS flags any third-party import not found in... orchestrata_ultimate/agents/volks/codedirector/review_checks check_dependency_declaration L294
orchestrata_ultimate/agents/volks/codedirector/review_checks run_deterministic_review L1272		 none
REQ-029-069 _make_ready_packet() always includes files_created, task_summary, and... orchestrata_ultimate/agents/volks/codedirector/volk _make_ready_packet L326 none
REQ-029-070 _make_ready_packet(swarm=True) adds swarm: True to the payload. orchestrata_ultimate/agents/volks/codedirector/volk _make_ready_packet L326 none
REQ-029-071 _make_ready_packet(full_output=True) adds plan and junior_output to the payload. orchestrata_ultimate/agents/volks/codedirector/volk _make_ready_packet L326 none
REQ-029-072 _make_ready_packet() sets to_agent="HUMAN", subject="implementation_ready", and... orchestrata_ultimate/agents/volks/codedirector/volk _make_ready_packet L326 none
REQ-029-073 scan_workspace() returns a sorted list of relative file paths, excluding hidden... orchestrata_ultimate/agents/volks/codedirector/implementation scan_workspace L561 none
REQ-029-074 scan_workspace() returns an empty list when the workspace directory does not exist. orchestrata_ultimate/agents/volks/codedirector/implementation scan_workspace L561 none
REQ-029-075 read_file_contents() returns a concatenated source listing with === filename ===... orchestrata_ultimate/agents/volks/codedirector/implementation read_file_contents L533
orchestrata_ultimate/agents/volks/codedirector/review _read_source_files L274		 none