Knowledge Wiki Orchestrata Ultimate

Orchestrata Ultimate / RTM / 027-junior-volk

RTM: 027-junior-volk

Requirement to symbol to test rows for 027-junior-volk: Junior Developer Volk.

At a glance

Item Value
Requirement IDs 70
Traced from src/ 56 (80.0%)
Untraced 14
Cited from tests/ 0 (0.0%)
Traced in src/ but not cited from tests/ 56

Reading this matrix

This matrix lists each of the 70 requirement IDs of spec 027-junior-volk with the src/ symbols that cite it and the tests that cite it. 56 of them (80.0%) have at least one citing symbol and 14 have none.

0 requirements are also cited from tests/, and 56 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-027-* (14).

Requirement to symbols to tests

Requirement Symbols in src/ Tests citing it
REQ-027-001 JuniorVolk defined as subclass of BaseVolk in orchestrata-agents orchestrata_ultimate/agents/volks/junior/volk JuniorVolk L88 none
REQ-027-002 JuniorVolk alias set to J:Junior orchestrata_ultimate/agents/volks/junior/volk JuniorVolk L88 none
REQ-027-003 JuniorVolk role set to Junior Developer orchestrata_ultimate/agents/volks/junior/volk JuniorVolk L88 none
REQ-027-004 JuniorVolk initialises workspace from PROJECT_WORKSPACE_ROOT orchestrata_ultimate/agents/volks/junior/volk JuniorVolk L88 none
REQ-027-005 JuniorVolk initialises files_created as empty list orchestrata_ultimate/agents/volks/junior/volk JuniorVolk L88 none
REQ-027-006 JuniorVolk initialises junior_output as None orchestrata_ultimate/agents/volks/junior/volk JuniorVolk L88 none
REQ-027-007 process(packet) routes design_review subject to _handle_design_review() orchestrata_ultimate/agents/volks/junior/volk process L119 none
REQ-027-008 process(packet) routes implement subject to _handle_implement() orchestrata_ultimate/agents/volks/junior/volk process L119 none
REQ-027-009 process(packet) returns None for unrecognised subjects orchestrata_ultimate/agents/volks/junior/volk process L119 none
REQ-027-010 process(packet) extracts graph context from packet payload via extract_graph_context() orchestrata_ultimate/agents/volks/junior/volk process L119 none
REQ-027-011 _handle_design_review() sets status = WorkStatus.IN_PROGRESS on entry orchestrata_ultimate/agents/volks/junior/volk _handle_design_review L145 none
REQ-027-012 _handle_design_review() reads design_cycle from packet.payload (default 1) orchestrata_ultimate/agents/volks/junior/volk _handle_design_review L145 none
REQ-027-013 _handle_design_review() sets current_thread from packet.thread_id orchestrata_ultimate/agents/volks/junior/volk _handle_design_review L145 none
REQ-027-014 When design_cycle >= MAX_DESIGN_REVIEW_CYCLES, _auto_ready() is called without... orchestrata_ultimate/agents/volks/junior/volk _handle_design_review L145 none
REQ-027-015 When design_cycle < MAX_DESIGN_REVIEW_CYCLES, LLM is called via... orchestrata_ultimate/agents/volks/junior/volk _handle_design_review L145 none
REQ-027-016 LLM response appended to output_artifacts with section header orchestrata_ultimate/agents/volks/junior/volk _handle_design_review L145 none
REQ-027-017 DESIGN_REVIEW_PROMPT contains checklist items C1 through C7 none none
REQ-027-018 C1 covers Import Paths (exact package path for every file in FILE_TREE) none none
REQ-027-019 C2 covers Function Signatures (complete signature for every public function) none none
REQ-027-020 C3 covers Dependency Graph (implementation order determinable) none none
REQ-027-021 C4 covers pyproject.toml (all third-party dependencies named) none none
REQ-027-022 C5 covers FILE_TREE vs API_SPEC consistency (every file has an API entry) none none
REQ-027-023 C6 covers Error Handling and is labelled NOT blocking none none
REQ-027-024 C7 covers Test Strategy and is labelled NOT blocking none none
REQ-027-025 Convergence rule: Cycle 1 allows max 5 questions on C1-C5 only none none
REQ-027-026 Convergence rule: Cycle 2 allows max 3 questions on C1-C5 only none none
REQ-027-027 Convergence rule: Cycle 3+ forces READY verdict regardless of LLM output none none
REQ-027-028 DESIGN_REVIEW_PROMPT instructs the LLM never to ask about C6 or C7 none none
REQ-027-029 DESIGN_REVIEW_PROMPT instructs the LLM never to re-ask an already-answered question none none
REQ-027-030 LLM called with temperature=0.0 for deterministic review output orchestrata_ultimate/agents/volks/junior/volk _call_design_review_llm L281 none
REQ-027-031 CODING_STANDARDS appended to DESIGN_REVIEW_PROMPT with brace-escaping none none
REQ-027-032 parse_questions() extracts numbered lines after QUESTIONS: as question items orchestrata_ultimate/agents/volks/junior/volk parse_questions L475 none
REQ-027-033 parse_questions() extracts bulleted lines (dash prefix) as question items orchestrata_ultimate/agents/volks/junior/volk _extract_question_line L513
orchestrata_ultimate/agents/volks/junior/volk parse_questions L475		 none
REQ-027-034 parse_questions() stops extraction on first non-question non-empty line orchestrata_ultimate/agents/volks/junior/volk _is_section_break L538
orchestrata_ultimate/agents/volks/junior/volk parse_questions L475		 none
REQ-027-035 _build_review_response() returns READY packet when VERDICT: READY found in response orchestrata_ultimate/agents/volks/junior/volk _build_review_response L312 none
REQ-027-036 _build_review_response() returns READY packet when no questions are parsed orchestrata_ultimate/agents/volks/junior/volk _build_review_response L312 none
REQ-027-037 _build_review_response() returns QUESTIONS packet when questions are parsed and... orchestrata_ultimate/agents/volks/junior/volk _build_review_response L312 none
REQ-027-038 design_feedback packet addressed to U:Ar orchestrata_ultimate/agents/volks/junior/volk _make_feedback_packet L430 none
REQ-027-039 design_feedback payload contains verdict, response, design_cycle orchestrata_ultimate/agents/volks/junior/volk _make_feedback_packet L430 none
REQ-027-040 design_feedback payload contains questions list only when verdict is QUESTIONS orchestrata_ultimate/agents/volks/junior/volk _make_feedback_packet L430 none
REQ-027-041 _auto_ready() sets status = WorkStatus.RESOLVED orchestrata_ultimate/agents/volks/junior/volk _auto_ready L244 none
REQ-027-042 _auto_ready() sets current_thread = None orchestrata_ultimate/agents/volks/junior/volk _auto_ready L244 none
REQ-027-043 _auto_ready() emits design_feedback packet with verdict = READY orchestrata_ultimate/agents/volks/junior/volk _auto_ready L244 none
REQ-027-044 _auto_ready() payload response contains a human-readable auto-READY message orchestrata_ultimate/agents/volks/junior/volk _auto_ready L244 none
REQ-027-045 _handle_implement() sets status = WorkStatus.IN_PROGRESS on entry orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-046 _handle_implement() calls _apply_project_dir() to override workspace if... orchestrata_ultimate/agents/volks/junior/volk _apply_project_dir L359
orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181		 none
REQ-027-047 _handle_implement() resolves driver via `get_driver(volk="J:Junior",... orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-048 Driver execute() receives aider_prompt, files, and is_fix from packet payload orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-049 Driver output stored in self.junior_output and appended to output_artifacts orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-050 scan_workspace() called after driver execution to populate self.files_created orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-051 validate_dependencies() called with workspace and files_created after scan orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-052 Dependency issues logged via _log_deps_issues() at WARNING level orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181
orchestrata_ultimate/agents/volks/junior/volk _log_deps_issues L376		 none
REQ-027-053 implementation_complete packet addressed to U:Cd orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-054 implementation_complete payload contains files_created, output, success,... orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-055 status set to WorkStatus.RESOLVED after implementation completes orchestrata_ultimate/agents/volks/junior/volk _handle_implement L181 none
REQ-027-056 scan_workspace() returns empty list when workspace directory does not exist orchestrata_ultimate/agents/volks/junior/volk scan_workspace L563 none
REQ-027-057 scan_workspace() excludes hidden directories (names starting with .) orchestrata_ultimate/agents/volks/junior/volk scan_workspace L563 none
REQ-027-058 scan_workspace() excludes __pycache__ directories orchestrata_ultimate/agents/volks/junior/volk scan_workspace L563 none
REQ-027-059 scan_workspace() excludes directories with names starting with Module: orchestrata_ultimate/agents/volks/junior/volk scan_workspace L563 none
REQ-027-060 scan_workspace() excludes hidden files (names starting with .) orchestrata_ultimate/agents/volks/junior/volk scan_workspace L563 none
REQ-027-061 scan_workspace() returns paths as relative to workspace orchestrata_ultimate/agents/volks/junior/volk scan_workspace L563 none
REQ-027-062 scan_workspace() returns paths in sorted order orchestrata_ultimate/agents/volks/junior/volk scan_workspace L563 none
REQ-027-063 validate_dependencies() returns empty list when pyproject.toml has no declared... orchestrata_ultimate/agents/volks/junior/volk validate_dependencies L606
orchestrata_ultimate/verification/review/helpers _get_pyproject_deps L84		 none
REQ-027-064 validate_dependencies() skips non-.py files in files_created orchestrata_ultimate/agents/volks/junior/volk validate_dependencies L606 none
REQ-027-065 validate_dependencies() uses _parse_file() to parse each Python file AST orchestrata_ultimate/agents/volks/junior/volk _check_single_file L670
orchestrata_ultimate/agents/volks/junior/volk validate_dependencies L606
orchestrata_ultimate/verification/review/helpers _parse_file L18		 none
REQ-027-066 validate_dependencies() skips files that cannot be parsed (None from _parse_file()) orchestrata_ultimate/agents/volks/junior/volk _check_single_file L670
orchestrata_ultimate/agents/volks/junior/volk validate_dependencies L606		 none
REQ-027-067 validate_dependencies() collects local project modules from src/ subdirectories orchestrata_ultimate/agents/volks/junior/volk _collect_project_modules L651
orchestrata_ultimate/agents/volks/junior/volk validate_dependencies L606		 none
REQ-027-068 validate_dependencies() calls check_dependency_declaration() per file orchestrata_ultimate/agents/volks/junior/volk _check_single_file L670
orchestrata_ultimate/agents/volks/junior/volk validate_dependencies L606
orchestrata_ultimate/verification/review/checks_correctness check_dependency_declaration L151		 none
REQ-027-069 Issue strings formatted as [CHECK_ID] rel_path: description orchestrata_ultimate/agents/volks/junior/volk _check_single_file L670
orchestrata_ultimate/agents/volks/junior/volk validate_dependencies L606		 none
REQ-027-070 JuniorVolk decorated with `@traces(spec="027", story="Volk Identity and Lifecycle",... orchestrata_ultimate/agents/volks/junior/volk JuniorVolk L88 none