284 lines
9.0 KiB
Markdown
284 lines
9.0 KiB
Markdown
---
|
|
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/<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
|
|
|
|
```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/<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.
|