wantsong
/
ccpe-system
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ccpe-system/runtimes/hybrid/ccra-local-review-invocatio...

7.7 KiB
Raw Blame History

template_type runtime_id agent_id version status
agent-invocation-packet ccra-local-review ccra-local-reviewer 0.1.2 draft

Local CCRA Agent Invocation Packet

1. Invocation Metadata

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

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:

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:

blocked_waiting_for_participant_output

4. Task Context

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:

<client-project-root>/README.md
<client-project-root>/AGENTS.md
<client-project-root>/knowledge_assets/README.md
<client-project-root>/knowledge_assets/
<review-run-dir>/review-context.md
<review-run-dir>/review-file-manifest.json

For The Mindscape of Bro Tsong, use:

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:

- path:
  purpose:
  required: true | false

Review bundles:

- path:
  purpose:

Helper outputs:

<review-run-dir>/helper-outputs/bundle-audit.md
<review-run-dir>/helper-outputs/bundle-audit.json
<review-run-dir>/helper-outputs/routing-behavior-diff.md
<review-run-dir>/helper-outputs/routing-behavior-diff.json
<review-run-dir>/helper-outputs/gate-run-report.md
<review-run-dir>/helper-outputs/gate-run-report.json
<review-run-dir>/helper-outputs/lifecycle-status-guard-scan.md
<review-run-dir>/helper-outputs/lifecycle-status-guard-scan.json

Mark unavailable helper outputs explicitly instead of deleting the slot.

Helper policy for this invocation:

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:

review_turn_report_path: <review-run-dir>/04_LOCAL_CCRA_REVIEW_REPORT.md
planning_turn_output_path: <review-run-dir>/next-review-requirements.md
comparison_turn_output_path: <review-run-dir>/05_WEB_LOCAL_CCRA_COMPARISON.md
returned_output_path: <review-run-dir>/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:

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:

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:

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

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:

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:

<review-run-dir>/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:

simulation-only
excluded-from-synthesis
not-a-formal-report

Simulation-only output cannot be used as the Local CCRA report.