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:

• ../../scripts/recursive-review-bundle.py
• ../../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 ../../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" \
  --audit-question "Which R# remain incomplete?" \
  --required-output "Findings ordered by severity"

pwsh -NoProfile -File ../../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" `
  -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.

References

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