recursive-review-bundle

recursive-review-bundle

Use this skill to prepare a canonical review bundle before delegating an audit or review in recursive-mode.

This skill does not replace /.recursive/RECURSIVE.md. It packages the context bundle that delegated reviewers need so the review is durable, reproducible, and acceptable to the workflow.

Canonical Scripts

Use the repo scripts:

• ./.recursive/scripts/recursive-review-bundle.py
• ./.recursive/scripts/recursive-review-bundle.ps1

Prefer the Python script when both toolchains are available. Use the PowerShell wrapper when the delegated path is already PowerShell-oriented.

Minimum Inputs

Provide all of:

• repo root
• run id
• phase name
• reviewer role
• artifact path being reviewed
• exact upstream artifact paths
• relevant audit questions
• required output shape

Add explicit evidence refs or addenda when they matter. The bundle generator will also auto-discover relevant addenda and skill-memory refs when applicable.

Typical Commands

python ./.recursive/scripts/recursive-review-bundle.py \
  --repo-root . \
  --run-id "<run-id>" \
  --phase "03.5 Code Review" \
  --role code-reviewer \
  --artifact-path "/.recursive/run/<run-id>/03.5-code-review.md" \
  --upstream-artifact "/.recursive/run/<run-id>/00-requirements.md" \
  --upstream-artifact "/.recursive/run/<run-id>/02-to-be-plan.md" \
  --routing-config-path ".recursive/config/recursive-router.json" \
  --routing-discovery-path ".recursive/config/recursive-router-discovered.json" \
  --routed-cli "codex" \
  --routed-model "gpt-5.4" \
  --audit-question "Which R# remain incomplete?" \
  --required-output "Findings ordered by severity"

pwsh -NoProfile -File ./.recursive/scripts/recursive-review-bundle.ps1 `
  -RepoRoot . `
  -RunId "<run-id>" `
  -Phase "03.5 Code Review" `
  -Role code-reviewer `
  -ArtifactPath "/.recursive/run/<run-id>/03.5-code-review.md" `
  -UpstreamArtifact "/.recursive/run/<run-id>/00-requirements.md","/.recursive/run/<run-id>/02-to-be-plan.md" `
  -RoutingConfigPath ".recursive/config/recursive-router.json" `
  -RoutingDiscoveryPath ".recursive/config/recursive-router-discovered.json" `
  -RoutedCli "codex" `
  -RoutedModel "gpt-5.4" `
  -AuditQuestion "Which R# remain incomplete?" `
  -RequiredOutput "Findings ordered by severity"

Acceptance Rules

• Record Review Bundle Path in the delegated phase artifact.
• Refresh the bundle after material repairs or scope changes.
• Require the reviewer to cite the bundle path, upstream artifacts reread, relevant addenda, changed files or code refs reviewed, and a final verdict.
• Do not treat a bare bundle file as proof of review quality; the written review still has to use the bundle contents.

Routing Awareness

If the prepared bundle will be handed to a routed reviewer, re-read:

• /.recursive/config/recursive-router.json
• /.recursive/config/recursive-router-discovered.json

immediately before the delegated call, and include the relevant routing-path citations in the review or action-record metadata.

References

• /.recursive/RECURSIVE.md
• /docs/templates/commands/recursive-review-bundle.md
• ../recursive-subagent/SKILL.md