# Skills-Vault Request: Review Bundle Audit

Date: 2026-06-19

Requested supplier repository:

```text
C:\Users\wangq\Documents\Codex\skills-vault
```

Requesting CCPE artifacts:

```text
agents/agent-specs/ccra-local-reviewer.agent.md
runtimes/hybrid/ccra-local-review.runtime.md
```

## 1. Capability Name

```text
review-bundle-audit
```

## 2. Product / Runtime Context

Local CCRA review needs a deterministic preflight check for review bundles before the `ccra-local-reviewer` Agent spends judgment budget.

The first consumer is:

```text
C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong
```

The operation should be reusable for other projects that package files for local or Web reviewer handoff.

## 3. Repeated Action Or Friction Point

Review bundles may be missing briefs, manifests, validation sidecars, reports, raw zip files, or changed-file summaries. Human and Agent review quality drops when the bundle structure is incomplete or when the reviewer must discover the file set manually.

## 4. Inputs

Expected input:

```text
bundle_root: path to a review bundle directory
profile: optional bundle profile name
```

For The Mindscape of Bro Tsong, the relevant path pattern is:

```text
ccra_review_bundle/<round-or-pass>/
```

## 5. Expected Outputs

Write or return a deterministic audit report with:

```text
bundle_root
files_discovered
required_files_present
required_files_missing
optional_files_present
manifest_status
zip_status
validation_sidecar_status
report_status
warnings
blocking_errors
machine_readable_summary
```

Preferred output files when called by a runtime:

```text
bundle-audit.md
bundle-audit.json
```

## 6. Allowed Actions

- Read the specified bundle directory.
- Inspect filenames, relative paths, manifest contents, and sidecar JSON/Markdown files.
- Validate zip readability when a zip is present.
- Write audit outputs only to the caller-specified review run directory.

## 7. Forbidden Actions

- Do not modify review bundle source files.
- Do not create or repair bundles.
- Do not edit model cards, selector rules, regression cases, or project docs.
- Do not decide whether a review is accepted.

## 8. Validation Expectation

The Skill should include tests for:

```text
complete bundle
missing required brief
missing manifest
missing validation sidecar
unreadable zip
extra files that should be warnings, not blockers
UTF-8 paths and Chinese filenames
```

## 9. Reusability Rationale

This is a deterministic file/package audit, not a CCRA judgment. It belongs in `skills-vault` and should be named by the reusable operation rather than by one project-specific review context.

Example non-CCRA consumers:

```text
writing-workbench:
  Check article review packages before sending them to outline, structure, or style reviewers.

video-workbench:
  Check script / storyboard / asset handoff packages before production review.

skills-vault:
  Check Skill release packages before installation or publishing.

ccpe-system:
  Check Agent, Runtime, Skill, or review-committee handoff packages before formal participant invocation.

development repositories:
  Check release review bundles that contain diffs, test logs, deployment notes, and rollback plans.
```

## 10. Current Blocked Task

`ccra-local-reviewer` can manually inspect bundles, but official Local CCRA Runtime automation should call this Skill once it exists and is registered.