9.0 KiB
| artifact_type | name | author | created | status | source_request | client_repository |
|---|---|---|---|---|---|---|
| ccpe-creation-brief | ccra-local-reviewer-creation-brief | CCPE System | 2026-06-19 | draft | C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong\requirements\ccpe\2026-06-19-ccra-local-reviewer-runtime.md | 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:
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:
The project owner operating The Mindscape of Bro Tsong through Codex.
Secondary users:
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:
Codex local workspace with file-system access and real child session / separate-thread invocation.
Portable target:
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:
Hybrid Artifact
Components:
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:
Project execution records:
local_ccra_reviews/<round>/<pass>/ 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
Hybrid Mode
Reason:
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
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:
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:
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:
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:
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:
Standard now, Full later if multiple reviewer roles or cross-project review governance are added.
10. Human Decision Gates
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:
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:
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
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/<round>/<pass>/` 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.