1.8.6: catalog freeze at 62 (#29)

* chore: cut 1.8.6 and freeze catalog at 62

* fix(id-demo-video): validate demo directory before checking ffmpeg in compose.sh

Author: kuker24

.gitignore

@@ -29,3 +29,6 @@ __pycache__/
 # local install/test debris
 .home-fixture/
 .scratch/
+demos/
+*.mp4
+*.webm

CHANGELOG.md

@@ -2,7 +2,37 @@
 
 ## Unreleased
 
-None.
+## 1.8.6 — 2026-09-18
+
+Catalog modernization (Wave A): retire obsolete twins, compress primitives, and tighten routing. Totals reduced to **62** (47 model-invoked, 15 manual slash commands).
+
+- **Catalog Retirement & Compression**:
+  - Retire model specialist `ask-matt`; workflow selection is handled directly by `AGENTS.md` and `rules/00-routing.md` without an extra specialist. Category checklist and phase boundary decision trees preserved in `skills/writing-for-agents/references/`.
+  - Compress `grilling` primitive into `grill-with-docs`; delete model skill `grilling`.
+  - Retire manual skill `/wait-what`; fold re-pitch instruction into `rules/03-prose-discipline.md`.
+  - Retire manual skill `/matt-implement`; spec-driven implementation and tracer-bullet tickets from `/to-tickets` execute directly in-session with `tdd`.
+  - Retain `wizard` for interactive human-only bash procedures (OAuth, secrets, cutover).
+  - Clarify mutual boundaries between `codebase-design` (single-module depth/seam design) and `/improve-codebase-architecture` (codebase scan and visual zero-network HTML report).
+- **Survivor Upgrades**:
+  - `impeccable`: add 4-tier Taste Gate checklist (Hard Gate, Purpose-Gate, Quality Locks, Delivery Gate) into `reference/taste-guard.md`. Explicitly note that filter ≠ style guide, `BANK_MISS ≠ generate`, and dials in `taste/direction.md` apply after direction exists.
+  - `humanizer`: add During-Generation vs After-Audit copy check modes adapted from anti-slop copy rules; add explicit refusal boundaries for UI implementation and Oxlint installation.
+  - `scroll-world`: clarify user-chosen camera styles, seam QA (composition/continuity over raw PSNR), and graceful `NOT_CONFIGURED` degradation when paid video backends are absent.
+  - `markitdown`: update Microsoft markitdown pin to v0.1.7 (`945314a`); reaffirm output is Markdown data while SmartDoc retains QA/contract/render.
+  - `gh-axi` & `chrome-devtools-axi`: update command surfaces from upstream `kunchenguid/axi` (`fb75216`); enforce 4-door browser hierarchy.
+  - `browser-act`: document supported modes (`chrome`, `stealth-fresh`, `stealth-fixed`); reiterate `--type chrome-direct` ban and that `playwright-qa` remains the default verifier.
+  - `found-this-design`: allow referencing external DESIGN.md patterns (e.g. `awesome-design-md`) without cloning or vendoring; product UI direction stays Design Bank → Impeccable.
+  - `code-tour` & `why`: add "How it works" and "Where it lives" tour scaffolding to `code-tour`; add optional critique step to `/why`.
+- **Policy & Boundary Integrity**:
+  - Reconcile `vendor/skill-allowlist.txt`, `vendor/skill-policy.json`, `vendor/license-audit.json`, and `vendor/provenance.json` to exactly 62 skills.
+  - Reject foreign control planes (ECC), standalone 3D anatomy apps (`human-atlas`), and auto-mutator loops (`ralph-loop`, `orchestrate`, `continual-learning`).
+
+## 1.8.5 — 2026-09-16
+
+Feature release. Totals now **66** (49 model-invoked, 17 manual slash commands).
+
+- Add model-invoked specialist `id-demo-video` and manual slash command `/demo-video` (`manual-skills/demo-video`).
+- Orchestrate end-to-end Indonesian application walkthrough videos, beat sheet timing (target duration ±15s), spoken oral Indonesian narration (130–150 wpm, anti-slop jargon ban), Edge TTS synthesis (`id-ID-GadisNeural` / `id-ID-ArdiNeural`) with SHA-256 caching and 429 backoff, Playwright/Chromium per-scene capture (1920x1080, human typing cadence), and FFmpeg composition/concat with 90s executive preview.
+- Boundary enforcement: `id-demo-video` acts as demo pipeline director; `hyperframes` handles short title/end HTML cards only; `playwright-qa` remains functional browser QA; `visual-studio` remains photoreal non-UI media.
 
 ## 1.8.4 — 2026-09-16
 

README.md

@@ -1,14 +1,14 @@
 # OpenCodeBestFriend
 
 Production-ready capability layer for OpenCode:
-64 routed skills (core + Wave 2/3 warehouse specialists), MCP, Codebase Memory,
+62 routed skills (core + Wave 2/3 warehouse specialists), MCP, Codebase Memory,
 Design Bank, Design Intelligence, SmartDoc, browser and verification tooling.
 
 OpenCodeBestFriend is an installer and runtime overlay for [OpenCode](https://opencode.ai). It is **not** Claude Code, **not** a model provider, and **not** a dump of a developer home directory.
 
 ## What it is
 
-- 64 skills: 48 model-invoked, 16 manual slash commands
+- 62 skills: 47 model-invoked, 15 manual slash commands (frozen; see [docs/CATALOG-FREEZE.md](docs/CATALOG-FREEZE.md))
 - A thin `AGENTS.md` router (lazy, one primary specialist)
 - Core MCP: Codebase Memory, Context7, shadcn
 - Design Bank discovery or download (media is **not** in git)
@@ -61,8 +61,8 @@ Restart OpenCode after install. Config is not hot-reloaded.
         ┌───────────────────┼────────────────────┐
         ▼                   ▼                    ▼
       Skills               MCP                 Rules
-      48 automatic       Codebase Memory        Verification
-     16 manual          Context7              Engineering
+      47 automatic       Codebase Memory        Verification
+      15 manual          Context7              Engineering
                        shadcn
         │
         ▼
@@ -86,27 +86,32 @@ Default: repository evidence first. Then at most one specialist.
 | Intent | Route |
 | --- | --- |
 | Repo understanding | Codebase Memory MCP |
+| How it works / where it lives | Codebase Memory then `code-tour` |
+| Repo rationale | `/why` (manual) |
 | Hard unknown bug | `diagnosing-bugs` |
 | Security-sensitive work | `full-audit-keamanan` |
 | Measured performance regression | `full-performance-audit` |
 | Current library docs | Context7 |
 | UI registry | shadcn MCP |
 | Visual direction | `found-this-design` |
 | UI implementation after a direction | `impeccable` |
+| Generic AI UI look | `impeccable` taste-gate (not `install-anti-slop`) |
 | Motion | `emil-design-eng` |
 | Photoreal / media | `visual-studio` |
 | Scroll-led storytelling | `scroll-craft` |
 | Scroll-driven 3D / camera world | `scroll-world` |
 | Procedural Three.js object from image | `img2threejs` |
 | Deterministic HTML composition video | `hyperframes` |
+| Demo video aplikasi & narasi ID | `id-demo-video` (`/demo-video`) |
+| Browser | `playwright-qa` → `browser-act` → `chrome-devtools-axi` → `click-path-audit` |
 | Documents (PDF/DOCX/answer/extract/review) | `smartdoc` |
 | File to Markdown ingest | `markitdown` |
 | Reusable book/module knowledge | `smartbook-ingest` |
 | Scholarly literature & manuscripts | `academic` |
-| Prose AI-tell removal & humanizing | `humanizer` (`/unslop`) |
+| Generic AI prose | `humanizer` / `/unslop` |
 | Editorial HTML/SVG diagrams | `diagram-design` |
+| TS Oxlint install | `install-anti-slop` (explicit only) |
 | Architecture bake-off | `/architect` (manual) |
-| Repo rationale | `/why` (manual) |
 
 Warehouse: `api-design`, `contract-first`, `automation-audit-ops`, `code-tour`, `click-path-audit` (plus Wave 2 diagnostics).
 

THIRD_PARTY_NOTICES.md

@@ -16,7 +16,7 @@ Machine-readable copy: `vendor/license-audit.json`.
 | --- | --- | --- | --- |
 | `adhd` | vendored frontmatter | MIT | follow MIT |
 | `impeccable` | vendored frontmatter | Apache-2.0 | follow Apache-2.0 |
-| Matt Pocock selected skills (`diagnosing-bugs`, `domain-modeling`, `codebase-design`, `writing-for-agents`, `research`, `prototype`, `grilling`, `improve-codebase-architecture`, `wizard`, `wait-what`, `ask-matt`, `grill-with-docs`, `to-spec`, `to-tickets`, `tdd`, `matt-code-review` ← `code-review`, `matt-implement` ← `implement`) | mattpocock/skills MIT LICENSE — `vendor/licenses/MATT-POCOCK-MIT.txt` | MIT | follow MIT |
+| Matt Pocock selected skills (`diagnosing-bugs`, `domain-modeling`, `codebase-design`, `writing-for-agents`, `research`, `prototype`, `improve-codebase-architecture`, `wizard`, `grill-with-docs`, `to-spec`, `to-tickets`, `tdd`, `matt-code-review` ← `code-review`) | mattpocock/skills MIT LICENSE — `vendor/licenses/MATT-POCOCK-MIT.txt` | MIT | follow MIT |
 | Pstack selected skills (`blast-radius`, `unslop`, `create-verification-skill`, `maintain-verification-skill`, `technical-writing`, `arena`, `interrogate`, `architect`, `decision-log`, `why`, `reflect`, `figure-it-out`) | cursor/plugins pstack `60c641e` | MIT — `vendor/licenses/PSTACK-MIT.txt` | follow MIT |
 | Snapshot skills (`browser-act`, `chrome-devtools-axi`, `emil-design-eng`, `found-this-design`, `full-audit-keamanan`, `full-performance-audit`, `gh-axi`, `scroll-world`, `visual-studio`) | GrokBestFriend 1.3.1 snapshot + `vendor/licenses/GROKBESTFRIEND-MIT.txt`; skill wrappers MIT. Separate CLIs follow their own packages. | MIT | follow MIT |
 | `scroll-craft` | [nateherkai/scroll-craft](https://github.com/nateherkai/scroll-craft) `0b81622` — `vendor/licenses/NATEHERK-SCROLL-CRAFT-MIT.txt`; skill `NOTICE.md` | MIT © 2026 Nate Herk | follow MIT |

VERSION

@@ -1 +1 @@
-1.8.4
+1.8.6

commands/demo-video.md

@@ -0,0 +1,24 @@
+---
+description: "Manual specialist: demo-video"
+---
+
+Load and follow the OpenCode-adapted manual specialist `demo-video` (alias for `id-demo-video`).
+
+Plan and produce an application walkthrough demo video with Indonesian narration using the `id-demo-video` specialist.
+
+Collect the following parameters from user arguments or context:
+1. Application target URL (e.g. `http://localhost:3000`)
+2. Start command (how to start if offline, e.g. `npm run dev`)
+3. Target duration (default: `10:00` / 600 seconds)
+4. Voice: `id-ID-GadisNeural` (default, female) or `id-ID-ArdiNeural` (male)
+5. Output directory: `demos/<slug>/`
+
+Then load and follow the canonical `id-demo-video` specialist:
+- In repository tree: `skills/id-demo-video/SKILL.md`
+- After installation: `~/.config/opencode/skills/id-demo-video/SKILL.md`
+
+User arguments:
+
+$ARGUMENTS
+
+Do not substitute another specialist. Do not load this via the skill tool.

commands/matt-implement.md

@@ -0,0 +1,15 @@
+# Catalog Freeze Contract (1.8.6)
+
+This contract defines the immutable boundary and governance for the OpenCodeBestFriend catalog following the 1.8.6 modernization closeout.
+
+- **Product version**: 1.8.6
+- **Catalog**: 62 names. 47 model-invoked under `skills/`. 15 manual under `manual-skills/` + `commands/`.
+- **Retired in this wave and not to be revived**: `ask-matt`, `grilling`, `wait-what`, `matt-implement`.
+- **Kept on purpose**: `wizard` (target-app bash wizard), `codebase-design` (new module), `/improve-codebase-architecture` (scan + HTML report).
+- **Name collision remains**: `install-anti-slop` = Oxlint; UI/copy filter lives in `impeccable` taste-gate + `humanizer`; `/unslop` = `humanizer`.
+- **FOREIGN_ON_DEMAND stays out of the overlay**: `ECC`, `noodle`, `serena`, `stitch`, `reticle`, `ui-skills` MCP, `markitdown` MCP, `exa`, `Caliper`, `SkillEvaluator`. `doctor` must not fail when they are absent.
+- **No new allowlist name without retiring one existing name in the same change.**
+- **No padding back to 64.**
+- **No `/how`, `/poteto-mode`, `/antislop`, `taste-skill`, `axi-core`, `human-atlas`, `awesome-design-md` vendor.**
+- **No auto-edit of skills/rules from a learning log. No silent `--auto`.**
+- **Next unfreeze requires a human-written exception in CHANGELOG Unreleased that names the retired twin.**

commands/wait-what.md

@@ -10,8 +10,8 @@
         ┌───────────────────┼────────────────────┐
         ▼                   ▼                    ▼
       Skills               MCP                 Rules
-      48 automatic       Codebase Memory        Verification
-      16 manual          Context7              Engineering
+      47 automatic       Codebase Memory        Verification
+      15 manual          Context7              Engineering
                        shadcn
         │
         ▼