45 lines
1.9 KiB
Markdown
45 lines
1.9 KiB
Markdown
# Codebase Review Swarm Skill v8.2
|
|
|
|
Portable Agent Skill for OpenCode, Codex, and Claude Code. It converts the v7 codebase-review swarm prompt into a progressive-disclosure skill package with a short routing-focused `SKILL.md`, detailed protocol references, parseable schemas, report template, optional Codex metadata, and deterministic helper scripts.
|
|
|
|
## Contents
|
|
|
|
```text
|
|
codebase-review-swarm/
|
|
SKILL.md
|
|
INSTALL.md
|
|
README.md
|
|
agents/
|
|
openai.yaml
|
|
assets/
|
|
jsonl-schemas.md
|
|
review-report-template.md
|
|
references/
|
|
compatibility-and-research-notes.md
|
|
full-v7-source-prompt.md
|
|
review-protocol-v8.2.md
|
|
scripts/
|
|
init-review-run.py
|
|
validate-skill-package.py
|
|
```
|
|
|
|
## Design summary
|
|
|
|
- Canonical opencode-swarm repo path: `.opencode/skills/codebase-review-swarm/`.
|
|
- Claude path: `.claude/skills/codebase-review-swarm/` as a thin adapter to the canonical OpenCode skill.
|
|
- Codex path: `.agents/skills/codebase-review-swarm/` as a thin adapter with `agents/openai.yaml`.
|
|
- Portable user install paths may still use `.agents/skills/`, `.opencode/skills/`, or `.claude/skills/` depending on host.
|
|
- Frontmatter is intentionally portable: required `name` and `description`, plus harmless metadata.
|
|
- Long instructions are split into references/assets to preserve routing quality and context budget.
|
|
- Focused track selections expand depth inside the selected domain; multi-track/all-track selections add waves rather than sacrificing per-track quality.
|
|
- The full v7 prompt is preserved verbatim for detailed track checklists.
|
|
- Standards are current as of 2026-06-08: ASVS 5.0.0, OWASP LLM Top 10 2025, SLSA v1.2, WCAG 2.2 AA, OpenTelemetry.
|
|
|
|
## Primary command
|
|
|
|
```text
|
|
$codebase-review-swarm
|
|
```
|
|
|
|
Begin at repository root. The skill runs Phase 0 inventory, stops for review mode selection unless preselected, then performs selected exhaustive tracks with coverage closure, review-depth planning, non-diluting multi-track execution, and critic validation.
|