294 lines
7.7 KiB
Markdown
294 lines
7.7 KiB
Markdown
---
|
|
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
|
|
<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:
|
|
|
|
```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
|
|
<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:
|
|
|
|
```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: <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:
|
|
|
|
```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
|
|
<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:
|
|
|
|
```text
|
|
simulation-only
|
|
excluded-from-synthesis
|
|
not-a-formal-report
|
|
```
|
|
|
|
Simulation-only output cannot be used as the Local CCRA report.
|