183 lines
6.1 KiB
Markdown
183 lines
6.1 KiB
Markdown
# 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
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
Local CCRA is a formal local tuning/review lane.
|
|
Web CCRA is planning alignment plus final review / terminal cross-check.
|
|
```
|
|
|
|
Validation:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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.
|