--- artifact_type: ccpe-creation-brief name: ccra-local-reviewer-creation-brief author: CCPE System created: 2026-06-19 status: draft source_request: C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong\requirements\ccpe\2026-06-19-ccra-local-reviewer-runtime.md client_repository: C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong --- # CCPE Creation Brief: CCRA Local Reviewer Runtime ## 1. Intended Use Create a Local CCRA review capability for The Mindscape of Bro Tsong. The capability is not a low-grade preliminary reviewer. It is a formal local review and tuning lane that uses Codex's local file access, high-context execution channel, child-session isolation, and local tool support to reduce repeated Web CCRA transfer work. The intended operating split is: ```text Web CCRA: planning alignment with the owner final review / terminal cross-check for major rounds Local CCRA: full local evidence inspection direct use of the project knowledge base at knowledge_assets/ repeated tuning-loop review regression / diff / validation-supported review pre-Web-finalization quality gate Owner: final acceptance lifecycle promotion decisions routing of unresolved product judgment ``` ## 2. Target User Primary user: ```text The project owner operating The Mindscape of Bro Tsong through Codex. ``` Secondary users: ```text Codex main project sessions that need to invoke a formal local reviewer before continuing work. Future CCPE-supplied project review runtimes that need the same no-simulation pattern. ``` ## 3. Target Platform Primary target: ```text Codex local workspace with file-system access and real child session / separate-thread invocation. ``` Portable target: ```text Platform-neutral Markdown runtime packets for manual or future agentic execution. ``` The Runtime must not depend on Web ChatGPT upload constraints. It should exploit local file access while preserving invocation authenticity. ## 4. Artifact Classification Primary classification: ```text Hybrid Artifact ``` Components: ```text CCPE-Agent: ccra-local-reviewer CCPE-Runtime: ccra-local-review CCPE-Skill specs: ccra-findings-classification model-lifecycle-scope-guard Runtime report template: ccra-local-review-report.template.md Integration Registrations: review-bundle-audit routing-behavior-diff-audit regression-validation-gate-runner lifecycle-status-guard-scan review-context-builder ``` Non-CCPE-owned components: ```text Project execution records: local_ccra_reviews/// in the client project Project knowledge base: C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong\knowledge_assets used directly by Local CCRA; not duplicated into CCPE or the run directory Automation Skill source: skills-vault implementation of deterministic helpers ``` ## 5. Operating Mode ```text Hybrid Mode ``` Reason: ```text The core review is judgment-heavy and adversarial. The support layer is automation-heavy and deterministic. The run requires file operations, child-session invocation, durable outputs, and human gates. ``` ## 6. Depth vs Automation Orientation ```text Hybrid: depth-oriented: product-governance judgment lifecycle overclaim detection round-scope interpretation engineering-pass versus product-judgment separation next-action recommendation automation-supported: bundle completeness audit before/after routing behavior diff regression and validation gate execution lifecycle status scan round context pack construction ``` ## 7. Cognitive Models Involved The Local CCRA reviewer must preserve these model-governance distinctions: ```text engineering pass != product judgment local CCRA report != Owner approval local CCRA report != Web CCRA final approval regression pass != lifecycle promotion selector calibration != user-facing intervention QPI remains front-routing / misframing-diagnostic, not intervention logic ``` The Mindscape of Bro Tsong is the long-term cognitive model governance system. CCPE's existing `model-cards/` and `model-index/` directories remain CCPE protocol/template/reference assets and historical CCPE model artifacts. They are not the future canonical governance store for The Mindscape of Bro Tsong model library. ## 8. Skills Needed CCPE-owned Skill specs: ```text ccra-findings-classification: reusable findings classification and report severity method model-lifecycle-scope-guard: lifecycle and round-scope judgment rules used by Local CCRA ``` Installed skills-vault automation: ```text review-bundle-audit: deterministic review bundle completeness audit routing-behavior-diff-audit: before/after routing result comparison regression-validation-gate-runner: declared gate command runner and log recorder lifecycle-status-guard-scan: deterministic scan for status overclaims review-context-builder: deterministic file-first context index and manifest builder ``` These are public automation helpers. Local CCRA consumes their outputs, but the helpers must remain usable outside Local CCRA by article review, video review, Skill release review, code/release review, Agent/Runtime review, and manual Web upload preparation workflows. ## 9. Runtime Need Runtime is required. Evidence: ```text The work must run in a real child session or equivalent isolated participant context. The reviewer must read files directly, not depend on main-session summaries. The process needs run directories, invocation packets, returned outputs, resume state, and acceptance rules. The workflow includes deterministic tool outputs plus judgment Agent output. The output affects downstream project work but cannot itself approve lifecycle or Web CCRA status. ``` Runtime maturity: ```text Standard now, Full later if multiple reviewer roles or cross-project review governance are added. ``` ## 10. Human Decision Gates ```text Gate 1: approve Local CCRA run start and target round/pass. Gate 2: accept or reject child-session invocation evidence. Gate 3: decide which Local CCRA findings become accepted work. Gate 4: decide whether a repaired round is ready for Web CCRA final review. Gate 5: decide whether any lifecycle status changes are allowed. Gate 6: approve routing of new deterministic automation capabilities to skills-vault. ``` ## 11. Proposed Files Create in CCPE System: ```text workbench/analysis/ccra-local-reviewer-creation-brief.md workbench/analysis/ccra-local-reviewer-work-plan.md agents/agent-specs/ccra-local-reviewer.agent.md runtimes/hybrid/ccra-local-review.runtime.md runtimes/hybrid/ccra-local-review-invocation-packet.template.md runtimes/hybrid/ccra-local-review-report.template.md runtimes/hybrid/ccra-local-review-next-review-requirements.template.md runtimes/hybrid/ccra-local-review-runtime-setup.md skills/evaluation/ccra-findings-classification.skill.md skills/evaluation/model-lifecycle-scope-guard.skill.md integrations/skills-vault/ccra-local-review-helpers.integration.md requirements/README.md requirements/skills-vault/README.md requirements/skills-vault/2026-06-19-review-bundle-audit.md requirements/skills-vault/2026-06-19-routing-behavior-diff-audit.md requirements/skills-vault/2026-06-19-regression-validation-gate-runner.md requirements/skills-vault/2026-06-19-lifecycle-status-guard-scan.md requirements/skills-vault/2026-06-19-review-context-builder.md ``` Do not create implementation source for the automation helpers in CCPE System. ## 12. Acceptance Criteria The first CCPE delivery is acceptable when: ```text Agent role is defined as formal local review/tuning reviewer, not low-grade preliminary reviewer. Runtime requires real child-session invocation or equivalent isolated participant context. Runtime rejects main-session roleplay as formal Local CCRA output. File-first local review run contract is specified. Findings rubric includes blocker, major, minor, calibration, defer. Lifecycle/scope guard rules distinguish engineering evidence from lifecycle approval. Report template separates evidence, findings, risks, recommended actions, Owner decisions, and Web final-review readiness. Skills-vault requests exist for deterministic automation helpers. Installed skills-vault helpers are registered as external capabilities. CCPE records that The Mindscape of Bro Tsong is the future model-governance system for the user's engineered cognitive model library. ``` ## 13. Open Questions ```text Which exact Codex child-session mechanism will be used for the first pilot? Should the first pilot inspect Round 03 or Round 04 materials? What exact `local_ccra_reviews///` naming pattern should The Mindscape of Bro Tsong adopt? Should Web CCRA final review receive the Local CCRA report as part of the upload bundle by default, or only after Owner approval? ``` ## 14. Next Action Generate the Agent Spec, Runtime Spec, report template, CCPE evaluation Skill specs, and skills-vault request documents. After these exist, the owner can implement the deterministic helpers in `skills-vault`, then return to CCPE for Integration Registration and a pilot-run protocol check.