ccpe-system/workbench/analysis/ccra-local-reviewer-work-pl...

6.1 KiB

CCRA Local Reviewer Work Plan

This plan is for CCPE artifact creation, not automation implementation. Script-backed automation belongs in skills-vault.

Goal

Supply The Mindscape of Bro Tsong with a formal Local CCRA review capability that can be invoked through a real child session, inspect local files directly, support repeated tuning loops, and prepare rounds for Web CCRA final review.

Architecture

The Mindscape of Bro Tsong
  owns local review run directories, review bundles, returned reports, accepted work, and project decisions

CCPE System
  owns the Local CCRA Agent Spec, Runtime Spec, report template, review rubric, lifecycle/scope guard rules, and Integration Registrations

skills-vault
  owns deterministic automation Skill source used by the Runtime

Web CCRA
  supports planning discussion and final review / terminal cross-check

Global Constraints

Do not simulate Local CCRA output in the main session.
Do not implement automation Skill source in CCPE.
Do not modify The Mindscape of Bro Tsong files from this CCPE delivery.
Do not treat Local CCRA output as Owner approval.
Do not treat Local CCRA output as Web CCRA final approval.
Do not upgrade lifecycle status from Local CCRA output alone.
Do not add third models, LLM selector, RAG, database, frontend, backend, user system, or platform behavior.

File Responsibilities

workbench/analysis/ccra-local-reviewer-creation-brief.md:
  design brief, classification, boundaries, target files

workbench/analysis/ccra-local-reviewer-work-plan.md:
  implementation sequence and validation checklist

agents/agent-specs/ccra-local-reviewer.agent.md:
  durable Local CCRA reviewer role and authority

runtimes/hybrid/ccra-local-review.runtime.md:
  invocation, state, run directory, workflow, gates, and resume contract

runtimes/hybrid/ccra-local-review-report.template.md:
  report template to be written by the child reviewer

runtimes/hybrid/ccra-local-review-next-review-requirements.template.md:
  planning-turn template for next review requirements and submitted-material package

runtimes/hybrid/ccra-local-review-invocation-packet.template.md:
  invocation packet template for real child-session dispatch

runtimes/hybrid/ccra-local-review-runtime-setup.md:
  client-project setup guide for starting the runtime environment

integrations/skills-vault/ccra-local-review-helpers.integration.md:
  registration for installed skills-vault helper Skills

skills/evaluation/ccra-findings-classification.skill.md:
  severity / finding classification method

skills/evaluation/model-lifecycle-scope-guard.skill.md:
  lifecycle and round-scope guard judgment method

requirements/skills-vault/*.md:
  outbound requests for deterministic automation helpers

Batch 1: Supplier Request Surface

  • Create requirements/README.md.
  • Create requirements/skills-vault/README.md.
  • Create one request document per planned automation helper.
  • Keep all request files implementation-free.

Validation:

requirements directory exists
each skills-vault request names a reusable operation
no script source is placed in CCPE

Batch 2: Planning And Classification

  • Create workbench/analysis/ccra-local-reviewer-creation-brief.md.
  • Create this work plan.
  • Explicitly record the corrected Local CCRA positioning:
Local CCRA is a formal local tuning/review lane.
Web CCRA is planning alignment plus final review / terminal cross-check.

Validation:

Creation Brief classifies the artifact as Hybrid.
Creation Brief names CCPE, project, and skills-vault ownership boundaries.
Creation Brief records The Mindscape of Bro Tsong as the future engineered model-governance system.

Batch 3: CCPE Core Artifacts

  • Create agents/agent-specs/ccra-local-reviewer.agent.md.
  • Create runtimes/hybrid/ccra-local-review.runtime.md.
  • Create runtimes/hybrid/ccra-local-review-report.template.md.
  • Create skills/evaluation/ccra-findings-classification.skill.md.
  • Create skills/evaluation/model-lifecycle-scope-guard.skill.md.

Validation:

Agent is read-only for project files.
Runtime requires child-session or equivalent isolated participant context.
Runtime includes session persistence and resume behavior.
Report template separates findings from Owner decisions and Web final review.
Rubric includes blocker, major, minor, calibration, defer.
Lifecycle guard separates engineering pass from product/lifecycle judgment.

Batch 4: Repository Index Updates

  • Update README.md directory tree and boundary note for requirements/.
  • Update PROJECTS.md if needed to mention outgoing supplier requests.
  • Avoid broad rewrites.

Validation:

new directory is discoverable
project boundary remains unchanged
the-mindscape model-governance replacement note is represented without deprecating CCPE protocol assets

Batch 5: Verification

Run:

git status --short
rg -n "ccra-local-reviewer|ccra-local-review|review-bundle-audit|routing-behavior-diff-audit|regression-validation-gate-runner|lifecycle-status-guard-scan|review-context-builder" .

Manual checklist:

All proposed files exist.
No automation implementation source was added.
No files outside CCPE System were modified.
All filenames are lowercase kebab-case.
All Local CCRA outputs are framed as local review evidence, not Owner/Web approval.

Pilot Plan After skills-vault Implementation

The first real trial should be initiated from The Mindscape of Bro Tsong, not from CCPE.

Recommended pilot:

1. The project main session selects existing Round 03 or Round 04 review materials.
2. The project main session creates local_ccra_reviews/<round>/<local-pass>/.
3. The project main session invokes the CCPE Runtime using a real child session or equivalent isolated context.
4. The child reviewer writes the Local CCRA report.
5. The owner checks:
   - whether a child session was truly invoked
   - whether session continuity can be preserved
   - whether report quality reaches Web CCRA level
   - which Agent/Runtime/tool definitions need tuning
6. Only after tuning should Local CCRA be used for Round 05.

Do not treat the pilot as Round 05 acceptance.