release(docs): v2.5.2 — link the Compound V Academy tutorial + bundle 2 fixes

Adds a prominent README link to the gamified tutorial (https://amiainative.dev/
compound-v). Ships alongside two fixes committed while building it: scope-gate
bracketed-segment literals (App Router write scopes) and /v:review-plan schema
resolving from the plugin dir.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: copeus

.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "superpowers-v",
       "description": "Compound V for Superpowers: triple parallel pre-flight (code archaeology + domain-expert + Context7 library validator), disjoint partitioning, manifest-driven multi-backend dispatch (Claude + Codex + Antigravity + Cursor), git-diff scope enforcement, crash-resumable runs, adaptive tier-based routing, epic mode, V-memory local-first semantic+lexical recall over docs/superpowers (opt-in pure-python embeddings + a deterministic recall→action bridge), and batched parallel dispatch (Opus default, narrow Sonnet exception)",
-      "version": "2.5.1",
+      "version": "2.5.2",
       "source": "./",
       "author": {
         "name": "Oleg",

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "superpowers-v",
   "description": "Compound V for Superpowers: triple parallel pre-flight (code archaeology + domain-expert advisor + library/doc validator via Context7), disjoint file partitioning, manifest-driven multi-backend dispatch (Claude + headless Codex + Antigravity + Cursor workers), git-diff scope enforcement, crash-resumable runs, adaptive tier-based routing, epic mode for multi-feature builds, V-memory local-first semantic+lexical recall over docs/superpowers (opt-in pure-python embeddings + a deterministic recall\u2192action bridge), and batched parallel dispatch (Opus default, Sonnet for narrow junior-task carve-out), plus /v:onboard — a project-onboarding command that builds a citation-verified knowledge base + AGENTS.md/CLAUDE.md bridge behind a human gate. Auto-intercepts brainstorming \u2192 writing-plans \u2192 execution transitions.",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "author": {
     "name": "Oleg",
     "email": "copeus@gmail.com"

CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to **superpowers-v (Compound V)** are documented here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project uses semantic versioning.
 
+## [2.5.2] — 2026-07-03
+
+### Added
+- **Compound V Academy** — a gamified 3-episode tutorial (**Developer · Product Owner · Universal Creator**) is now linked prominently from the README: **<https://amiainative.dev/compound-v>**. The fastest way to learn the whole pipeline (onboarding → the three scouts → dispatch → the review gates), with the squad as guides.
+
+### Fixed
+- **Scope gate: bracketed path segments are literal.** `[locale]` / `[uid]` / `[slug]` in a `write_allowed` glob were parsed as fnmatch **character classes** (`[locale]` = "one of `l,o,c,a,e`"), which **falsely BLOCKED** any Next.js App Router write scope (e.g. `app/[locale]/…/[uid]/page.tsx`) and raised a regex `FutureWarning`. Bracketed dynamic segments — the dominant real-world case — now match **literally**; the selftest covers the App Router case positive + negative. (`scripts/compound-v-scope-check.py`)
+- **`/v:review-plan` schema resolves from the plugin, not the reviewed repo.** The cross-model review script defaulted its JSON-schema path to `$REPO/schemas/…` (the **reviewed** repo), so `/v:review-plan` died with "schema not found" in **every project except this one**. It now resolves the default schema next to the script (its install dir); the `--schema` override is unchanged. (`scripts/compound-v-codex-review.sh` + new regression test)
+
 ## [2.5.1] — 2026-07-01
 
 ### Added — MCP / external-tool recommender for `/v:onboard`

README.md

@@ -10,6 +10,12 @@ You describe a feature. Claude plans it, splits it into non-overlapping pieces,
 
 ---
 
+## 🎮 New here? Learn it as a game → **[Compound V Academy](https://amiainative.dev/compound-v)**
+
+The fastest way to *get* what this plugin does. Three gamified episodes — **Developer · Product Owner · Universal Creator** — walk you through the whole pipeline (onboarding → the three scouts → manifest + dispatch → the review gates), with the squad — **The Trench**, **Bootcher**, **Monsieur Contexte**, **Motherboard**, **Git Noir**, **A-Express** — as your guides. 👉 **<https://amiainative.dev/compound-v>**
+
+---
+
 ## Main features
 
 - **Multi-model orchestration** — Claude builds the plan and routes implementation jobs to the right backend (**Claude / Codex / Antigravity / Cursor**). Each worker runs isolated under a scope check, so nothing writes outside the files it was given.