--- template_type: agent-invocation-packet runtime_id: ccra-local-review agent_id: ccra-local-reviewer version: 0.1.2 status: draft --- # Local CCRA Agent Invocation Packet ## 1. Invocation Metadata ```yaml packet_id: created_at: client_project_root: knowledge_base_path: review_round: local_pass: review_run_dir: turn_type: review_turn | planning_turn | comparison_turn invocation_mode: prompt_path_reference | full_prompt_paste | native_agent_id | manual_handoff carrier_type: codex_child_session | codex_thread | external_agent_session | manual child_session_id: persistent_child_session_required: true same_child_session_as_review_turn_required: false simulation_allowed: false bundle_audit_profile: ccra_mindscape_review_bundle | generic | not_applicable gate_execution_mode: dry_run | run | owner_waived | not_applicable routing_diff_policy: required | skipped_no_after_evidence | manual_equivalent_required | not_applicable lifecycle_scan_scope: current_review_bundle | changed_files | knowledge_assets | model_library_state | whole_repo ``` ## 2. Canonical Artifacts ```yaml canonical_agent_path: C:\Users\wangq\Documents\Codex\ccpe-system\agents\agent-specs\ccra-local-reviewer.agent.md canonical_runtime_path: C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccra-local-review.runtime.md report_template_path: C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccra-local-review-report.template.md planning_template_path: C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccra-local-review-next-review-requirements.template.md integration_registration_path: C:\Users\wangq\Documents\Codex\ccpe-system\integrations\skills-vault\ccra-local-review-helpers.integration.md ``` ## 3. Role Integrity Requirement The invoked participant must act as `ccra-local-reviewer`. The reviewer must: ```text read local evidence directly cite files actually read use helper outputs only as evidence write the report to the requested output contract respect the requested turn_type preserve Owner/Web CCRA authority boundaries avoid project file edits avoid lifecycle promotion avoid main-session roleplay ``` If this packet cannot be dispatched to a real child session or equivalent isolated participant context, the valid state is: ```text blocked_waiting_for_participant_output ``` ## 4. Task Context ```yaml primary_question: scope_statement: non_goals: local_tuning_stage: web_final_review_target: known_prior_rounds: owner_supplied_notes: first_turn_report_path: owner_decision_path: next_review_target: web_comparison_source: web_comparison_source_range: ``` ## 5. Input Files Required: ```text /README.md /AGENTS.md /knowledge_assets/README.md /knowledge_assets/ /review-context.md /review-file-manifest.json ``` For The Mindscape of Bro Tsong, use: ```text C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong\knowledge_assets ``` This is the Local CCRA knowledge base. Do not duplicate it into the run directory. Project or round-specific evidence: ```text - path: purpose: required: true | false ``` Review bundles: ```text - path: purpose: ``` Helper outputs: ```text /helper-outputs/bundle-audit.md /helper-outputs/bundle-audit.json /helper-outputs/routing-behavior-diff.md /helper-outputs/routing-behavior-diff.json /helper-outputs/gate-run-report.md /helper-outputs/gate-run-report.json /helper-outputs/lifecycle-status-guard-scan.md /helper-outputs/lifecycle-status-guard-scan.json ``` Mark unavailable helper outputs explicitly instead of deleting the slot. Helper policy for this invocation: ```yaml bundle_audit: active_profile: recognized_manifest_path: validation_sidecar_required: yes/no/not_applicable profile_limitations: gate_runner: gate_execution_mode: dry_run | run | owner_waived | not_applicable executed_logs_required_for_pass_claim: true routing_diff: required_when_before_after_exists: true skipped_reason: manual_equivalent_required_if_helper_missing: true required_categories: - target_behavior_changes - non_target_behavior_changes - accepted_collateral_changes - unexpected_regressions - unchanged_expected_behavior - cases_needing_owner_or_web_calibration lifecycle_scan: scope: whole_repo_is_broad_audit_mode: true triage_categories: - current_scope_blocker - owner_decision_needed - historical_or_archive_noise - policy_reference_not_claim - false_positive_or_low_confidence ``` ## 6. Output Contract The reviewer must write or return: ```yaml review_turn_report_path: /04_LOCAL_CCRA_REVIEW_REPORT.md planning_turn_output_path: /next-review-requirements.md comparison_turn_output_path: /05_WEB_LOCAL_CCRA_COMPARISON.md returned_output_path: /returned-output.md required_report_template: C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccra-local-review-report.template.md required_planning_template: C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccra-local-review-next-review-requirements.template.md ``` Output mapping: ```text review_turn -> 04_LOCAL_CCRA_REVIEW_REPORT.md planning_turn -> next-review-requirements.md comparison_turn -> 05_WEB_LOCAL_CCRA_COMPARISON.md or project-defined comparison path ``` The report must include: ```text return metadata review scope inputs actually received files actually read automation outputs used executive summary issue mechanism diagnosis patch scope judgment verification evidence requirements before / after behavior review when post-patch evidence exists calibration-only candidates helper output confidence findings non-target behavior changes engineering pass vs product judgment lifecycle and scope guard local tuning recommendations Web final review readiness final action recommendation Owner decision points limits and uncertainty resume instructions ``` `returned-output.md` must include this compact Owner-facing summary: ```text review_round local_pass turn_type child_session_id main_conclusion final_action_recommendation blocks_web_review blocks_owner_acceptance required_next_action output_paths evidence_limitations ``` ## 7. Continuity Policy ```yaml same_child_session_preferred: true resume_allowed: true planning_turn_requires_same_child_session: true resume_requires: - previous report - owner-decision.md when present - new or changed evidence list - unchanged-evidence statement ``` Follow-up review should inspect changed or newly supplied evidence first. Full rerun is required when invocation evidence is invalid, required evidence was missing, or the Owner requests a full rerun. For `planning_turn`, continue the same `child_session_id`, reference the first-turn report, and do not re-review the full current bundle unless new evidence was added or the Owner explicitly asks. ## 8. Session Logging The project main session must record: ```text dispatch method child session or carrier identifier when available helper commands run helper exit codes active bundle audit profile recognized manifest path gate_execution_mode routing_diff_policy lifecycle_scan_scope turn_type turn prompt path turn output path files written skipped helpers and reason manual approvals for gate-runner --mode run ``` Recommended log path: ```text /run-notes.md ``` ## 9. No-Simulation Requirement Formal Local CCRA output must not be simulated in the project main session. If a simulated dry run is explicitly requested, label it: ```text simulation-only excluded-from-synthesis not-a-formal-report ``` Simulation-only output cannot be used as the Local CCRA report.