+ gitignore

+ add boilerplate
2026-07-18 15:03:13 +03:00
parent c2f561fe06
commit d562b07027
26 changed files with 891 additions and 0 deletions
@@ -0,0 +1,44 @@
+# 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.