Run the compression bundle on one note

Type: kb/types/instruction.md

Review a specific note against the compression criteria without using the review database.

This is deliberately separate from the snapshot-anchored assay pipeline in kb/instructions/run-review-batches.md. Its files retain gate_id and “compression gate” as local historical names, but they are unanchored edit-strategy criteria, not review-system gates: they never enter --all-gates, acquire a persisted result kind, or write freshness-baseline state. Use them when the goal is a disposable report rather than fresh review evidence.

Inputs:

  • first argument: {note-path} — repository-relative note path, for example kb/notes/linking-theory.md
  • optional second argument: {output-path} — repository-relative Markdown path for the sub-agent's report. If omitted, write it next to the target note as <note-name>-compression-bundle-review.md.

Compression criteria

Use these criterion files, in this order:

  1. kb/instructions/compression-bundle/core-claim-obscured.md
  2. kb/instructions/compression-bundle/branch-bloat.md
  3. kb/instructions/compression-bundle/detail-overhang.md
  4. kb/instructions/compression-bundle/marginal-value-redundancy.md

After the four criteria, apply kb/instructions/compression-bundle/high-impact-simplification-synthesis.md to the artifact and the combined findings. This synthesis has no independent verdict; it selects the few structural changes most worth authorial attention.

Do not route these criteria through selectors or review jobs. Do not write review DB state or invoke acknowledgement or ingestion commands.

Roles

The orchestrator prepares the reviewer packet, dispatches one fresh reviewer, and verifies the report. The reviewer applies the packet and writes the report. Only the orchestrator dispatches: if a caller has already handed you the target text, criterion packet, output path, and output contract as a review task, you are the fresh reviewer. Perform the review directly and do not start another sub-agent.

Procedure

  1. Read the target note.
  2. Read the four criterion files above.
  3. Concatenate the criterion definitions and the high-impact synthesis instruction into a reviewer packet. Preserve each criterion's gate_id, name, failure mode, test, and examples; gate_id is part of this bundle's report vocabulary, not a persisted review identity.
  4. As the orchestrator, start one fresh sub-agent and give it:
  5. the target note path and full note text;
  6. the concatenated gate packet;
  7. {output-path};
  8. the output contract below. Tell the reviewer to treat the target artifact as the evidence for its intended contribution. Ambient conversation and the topic alone do not settle an unstated thesis, audience, or purpose.
  9. As the dispatched reviewer, apply every criterion independently, then run the high-impact synthesis over the artifact and combined findings. Write only {output-path}. Do not edit the note or delegate the review again.
  10. As the orchestrator, verify that {output-path} exists and follows the output contract, then close, terminate, or release the reviewer with the harness's lifecycle operation. Do not retain it for a follow-up task.

Output Contract

The sub-agent report should be plain Markdown:

# Compression Bundle Review: <note title>

**Target:** `<note-path>`
**Bundle:** `kb/instructions/compression-bundle/`

## Overall Result

PASS|INFO|WARN

## Gate Results

| Gate | Result | Summary |
|---|---|---|
| compression/core-claim-obscured | PASS|INFO|WARN | ... |
| compression/branch-bloat | PASS|INFO|WARN | ... |
| compression/detail-overhang | PASS|INFO|WARN | ... |
| compression/marginal-value-redundancy | PASS|INFO|WARN | ... |

## Findings

### compression/<gate-id>

- WARN|INFO: <specific location and action>

## High-impact Simplification Opportunities

### 1. <short opportunity name>

- Location: <heading and smallest useful quotation or section range>
- Reader problem: <why this materially obscures the claim, structure, or flow>
- Direction: <possible compression, fold, deletion, or reorganization>
- Combines: <relevant compression findings, or “cross-cutting”>
- Preserve or decide: <meanings, implications, or structural choices that constrain the revision>

Omit per-gate finding sections when a gate has no findings beyond a concise PASS summary. Do not emit PASS-per-paragraph output. Report zero to three high-impact opportunities; write None when no opportunity clears the synthesis threshold.

PASS, INFO, and WARN here are local report labels. They are not review-system decisions, and the report has no REPORT completion marker because it is not finalized into the review store.

Reviewer Bias

The compression bundle is intentionally edit-strategy oriented. It should flag true, coherent, and locally defensible material when the material does not earn its current context cost. Prefer compression, folding, deletion, demotion to open question, or rehoming over additive repair unless extra wording is necessary to preserve the core claim.

The final synthesis is selective rather than exhaustive. It may combine several findings into one larger revision, but it must leave semantic or evidential choices unresolved instead of hiding them inside a cleaner rewrite.

Do Not

  • Do not mutate the target note.
  • Do not create or finalize review jobs for these criteria.
  • Do not write review DB state.
  • Do not skip any gate in the bundle.