Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,24 @@
# Changelog

## 0.1.7 — 2026-09-28

Unfreeze exception (human-written): catalog grows **62 → 65** to add modern specialists `json-render`, `deck-design`, and `pageindex`. **No twin retired.** No silent padding. UI doctrines remain MERGE’d into `impeccable` / `emil-design-eng`. `react-doctor` stays OPTIONAL_TOOL (not a 4th skill). Closed intent set grows by three: `generative_ui`, `slides_pptx`, `longdoc_nav`.

- Power-up existing specialists (no duplicate UI skill folders):
- `impeccable/reference/audit.md`: unified React smell checklist and an explicit “when to run react-doctor” OPTIONAL_TOOL door.
- `impeccable/reference/taste-guard.md`: Delivery Gate liveliness / LCP / leftover-lorem items (net-new only).
- `emil-design-eng/references/interface-feel.md`: contrast boundaries, non-hue state, container-adaptive density (no duplicate hairline section).
- `playwright-qa`: evidence ledger + tracing FACT rows; remains door 1; browser-use not vendored.
- `prototype` + `found-this-design`: schema/JSON UI handoff → `json-render`.
- `smartdoc`: PPTX generation out of scope → `deck-design`.
- `research`: long structured docs → `pageindex`; primary-source rule kept.
- `eval-harness` + `full-audit-keamanan`: `deepteam` OPTIONAL_POINTER tightened (non-vendored, `OPTIONAL_ABSENT` when missing).
- Added three model-invoked skills (catalog 50 model + 15 manual = 65):
- `json-render` — pin `vercel-labs/json-render@c2600d73` (Apache-2.0). Generative UI from typed catalog/JSON. After tokens/direction or internal schema UI. Never bypass Design Bank for marketing. Jev compose not ported.
- `deck-design` — pin `carnot-tech/consulting-pptx-skill@f50edac` (MIT). Consulting PPTX / 16:9 HTML decks. Upstream 62-type packs not vendored.
- `pageindex` — pin `VectifyAI/PageIndex@037a7dba` (MIT). Tree/reasoning long-doc nav. Not Graphiti/Cognee/second CBM. Degrade `NOT_CONFIGURED`. Not a core MCP.
- Re-froze catalog at **65/65**. Product version 0.1.7. No new core MCP. No Jev.

## 0.1.6 — 2026-09-28

- Closed remaining open `UPDATE` dispositions in `docs/source-wave.md` (`scroll-world`, `browser-act`, `impeccable`, `codebase-memory-mcp`):
Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
# OpenCodeHighEnd

OpenCode 2 overlay: 62 frozen routed skills, thin `AGENTS.md`, `opencode-he`.
OpenCode 2 overlay: 65 frozen routed skills, thin `AGENTS.md`, `opencode-he`.

Installer and runtime overlay for [OpenCode 2](https://opencode.ai/v2/docs/).

Version **0.1.6**. The 62-skill catalog is strictly frozen.
Version **0.1.7**. The 65-skill catalog is strictly frozen.

## What it is

- 62 skills: 47 model-invoked, 15 manual slash commands (frozen; see [docs/CATALOG-FREEZE.md](docs/CATALOG-FREEZE.md))
- 65 skills: 50 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
- 12 Universal Design Banks (34,500+ items across Identity, Motion, Section, Atomic) with zero-token local search & Google Drive v2 bootstrap
- Design Bank path resolution via `~/.config/opencode/highend/config/design-bank.json`
- Explicit specialist handoff graph (`found-this-design` pin → `impeccable` → `playwright-qa` verify edge)
- Evidence-blocked done-gate (`FACT:` / `JUDGMENT:`) via verification rules + `/decision-log`
- UI polish checklists merged into `emil-design-eng` + practical a11y into `impeccable` (still 62 skills)
- UI polish checklists merged into `emil-design-eng` + practical a11y into `impeccable` (still not extra skills)
- Core MCP pins: Codebase Memory **0.11.0** (tarball and inner-binary SHA-256) and `shadcn@4.21.0`
- Email design is an Impeccable reference, not a new skill (raw HTML uses tables; React Email / MJML may use framework components)
- Emil motion doctrines live under `emil-design-eng` references (still 62 skills)
- Emil motion doctrines live under `emil-design-eng` references (not extra skills)
- Design Intelligence (lazy, inside Impeccable)
- `opencode-he doctor`, transactional install, uninstall, restore
- Claude Code isolation: `OPENCODE_DISABLE_CLAUDE_CODE=1`
Expand Down
3 changes: 3 additions & 0 deletions THIRD_PARTY_NOTICES.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,9 @@ Machine-readable copy: `vendor/license-audit.json`.
| `humanizer` | [blader/humanizer](https://github.com/blader/humanizer) v3; skill `NOTICE.md` | MIT © 2024-2026 blader contributors | follow MIT |
| `academic` | Original first-party text. Conceptual pipeline (research→write→review→revise) independently implemented. No source copied from Imbad0202/academic-research-skills (CC-BY-NC-4.0). | MIT © 2026 OpenCodeHighEnd contributors | follow MIT |
| `hyperframes` | [heygen-com/hyperframes](https://github.com/heygen-com/hyperframes); skill `NOTICE.md` | Apache-2.0 | follow Apache-2.0 |
| `json-render` | [vercel-labs/json-render](https://github.com/vercel-labs/json-render) `c2600d73`; skill `NOTICE.md`. npm packages not vendored. | Apache-2.0 © 2025 Vercel Inc. | follow Apache-2.0 |
| `deck-design` | [carnot-tech/consulting-pptx-skill](https://github.com/carnot-tech/consulting-pptx-skill) `f50edac`; skill `NOTICE.md`. 62-type packs not vendored. | MIT © carnot-tech contributors | follow MIT |
| `pageindex` | [VectifyAI/PageIndex](https://github.com/VectifyAI/PageIndex) `037a7dba`; skill `NOTICE.md`. SDK/Cloud not vendored. | MIT © 2026 PageIndex AI / VectifyAI | follow MIT |
| `diagram-design` | [cathrynlavery/diagram-design](https://github.com/cathrynlavery/diagram-design); skill `NOTICE.md` | MIT © 2024-2026 Cathryn Lavery contributors | follow MIT |
| Email design doctrine | Merged from [CosmoBlk/email-design](https://github.com/CosmoBlk/email-design) (MIT © 2026 CosmoBlk), [jayesh-bansal/email-pro-max](https://github.com/jayesh-bansal/email-pro-max) (MIT © 2026 Jayesh Bansal), [chunkydotdev/email-skills](https://github.com/chunkydotdev/email-skills) (MIT © 2026 chunkydotdev), and [Olshansk/agent-skills](https://github.com/Olshansk/agent-skills) (MIT © 2026 Olshansk) into `skills/impeccable/reference/email.md` | MIT | follow MIT |
| Emil Kowalski motion doctrines | Merged from [emilkowalski/skills](https://github.com/emilkowalski/skills) (`85e8e2363b71`) into `skills/emil-design-eng/references/` (`motion.md`, `apple-principles.md`, `native-motion.md`, `interface-feel.md`). Text: `vendor/licenses/EMILKOWALSKI-MIT.txt` | MIT © 2026 Emil Kowalski | follow MIT |
Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.1.6
0.1.7
16 changes: 8 additions & 8 deletions docs/CATALOG-FREEZE.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
# Catalog Freeze Contract

This contract defines the immutable boundary and governance for the OpenCodeHighEnd catalog. The 62-skill catalog is strictly frozen.
This contract defines the immutable boundary and governance for the OpenCodeHighEnd catalog. The 65-skill catalog is strictly frozen.

- **Product version**: 0.1.6
- **Catalog**: 62 names. 47 model-invoked under `skills/`. 15 manual under `manual-skills/` + `commands/`.
- **Wave 0.1.6 upgrade**: Body and reference refresh only (`scroll-world`, `browser-act`, `impeccable` delta evaluation); exact 62-skill catalog strictly reaffirmed.
- **Retired in this wave and not to be revived**: `ask-matt`, `grilling`, `wait-what`, `matt-implement`.
- **Product version**: 0.1.7
- **Catalog**: 65 names. 50 model-invoked under `skills/`. 15 manual under `manual-skills/` + `commands/`.
- **Wave 0.1.7 unfreeze exception** (CHANGELOG 0.1.7): catalog grew 62 → 65 to add `json-render`, `deck-design`, `pageindex`. No twin retired. UI doctrines remain MERGE’d. `react-doctor` stays OPTIONAL_TOOL.
- **Retired in prior waves 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, `crawl4ai` 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.**
- **FOREIGN_ON_DEMAND stays out of the overlay**: `ECC`, `noodle`, `serena`, `stitch`, `reticle`, `ui-skills` MCP, `markitdown` MCP, `crawl4ai` MCP, `exa`, `Caliper`, `SkillEvaluator`, PageIndex Cloud MCP. `doctor` must not fail when they are absent.
- **No new allowlist name without retiring one existing name in the same change**, except a human-written CHANGELOG exception (the 0.1.7 growth is that exception; it is spent).
- **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.**
- **Next unfreeze requires a human-written exception in CHANGELOG that names the retired twin, or a new explicit growth exception.**
6 changes: 3 additions & 3 deletions docs/acceptance.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,17 +5,17 @@
`doctor --deep` = is live runtime proven?
`doctor --strict` = treat DEGRADED/WARN as failure.

A successful 0.1.6 install should report approximately:
A successful 0.1.7 install should report approximately:

```text
PASS INSTALLED_PRODUCT opencode-highend
PASS INSTALLED_VERSION 0.1.6
PASS INSTALLED_VERSION 0.1.7
PASS SOURCE_REPOSITORY https://github.com/kuker24/OpenCodeHighEnd

PASS OpenCode (major >= 2.x)
PASS opencode.jsonc parseable
PASS AGENTS.md thin owned-lines=…
PASS skills TOTAL 62/62 MODEL 47/47 MANUAL 15/15
PASS skills TOTAL 65/65 MODEL 50/50 MANUAL 15/15
PASS rules 6 portable; 04-context-guard EXCLUDED_BY_DESIGN

CONFIGURED mcp:codebase-memory-mcp
Expand Down
2 changes: 1 addition & 1 deletion docs/compatibility.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Compatibility

Official target for 0.1.6:
Official target for 0.1.7:

- Linux x86_64
- OpenCode **2.x** (1.x fails closed)
Expand Down
1 change: 1 addition & 0 deletions docs/mcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,3 +43,4 @@ Doctor reports `CONFIGURED` for owned MCP entries present in config. That is not
- **Agent-Reach (`Panniantong/Agent-Reach`)** — Agent-Reach was evaluated and is strictly **REJECTED** as a core MCP or skill. It is not an alternative to Playwright QA eyes, carries ToS/cookie/account risks, and relies on Exa which is already designated `FOREIGN_ON_DEMAND`. Never register Agent-Reach as a core or required tool.
- **TypeSafe MCP (`itsmostafa/typesafe-mcp`)** — Evaluated and **REJECTED** as an extra core MCP. Core MCPs remain strictly `codebase-memory-mcp`, `context7`, and `shadcn`.
- **Graphiti (`getzep/graphiti`) & Cognee (`topoteretes/cognee`)** — Evaluated and **REJECTED** as external memory MCP servers. Complex graph databases and temporal entity graph memory requiring separate backends/services are out of scope. Codebase indexing and symbol memory is strictly owned by `codebase-memory-mcp` (v0.11.0). Core MCPs remain strictly `codebase-memory-mcp`, `context7`, and `shadcn`.
- **PageIndex Cloud MCP (`VectifyAI/PageIndex`)** — Skill `pageindex` is a first-party wrapper for tree/reasoning long-doc navigation. The Cloud/hosted MCP is **REJECTED** as an extra core MCP. Do not register it. Missing local SDK is `NOT_CONFIGURED` on the skill, not a doctor failure.
11 changes: 7 additions & 4 deletions docs/routing.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@ Manual specialists stay behind slash commands. Suggest them when the user names
Every user request is classified into exactly one closed intent:

```text
repo_understand | bug | security | perf | ui_direction | ui_implement
repo_understand | bug | security | perf | ui_direction | ui_implement | generative_ui
motion | scroll_2d | scroll_3d | img3d | docs | ingest_md | prose
academic | browser_qa | architecture | warehouse | ops_data | video_html | demo_id
academic | longdoc_nav | browser_qa | architecture | warehouse | ops_data | video_html | demo_id | slides_pptx
```

| Intent | Primary Route | Handoff Boundary / Rule |
Expand All @@ -31,14 +31,17 @@ academic | browser_qa | architecture | warehouse | ops_data | video_html | demo_
| `perf` | `full-performance-audit` | Measured LCP/INP/CLS/latency/bundle bottlenecks |
| `ui_direction` | `found-this-design` | Stop after writing `.impeccable/found-this-design.json` |
| `ui_implement` | `impeccable` | Requires pinned world or project `DESIGN.md` |
| `generative_ui` | `json-render` | Typed catalog + JSON spec → components; after tokens/direction or internal schema UI; never bypass Design Bank for marketing |
| `motion` | `emil-design-eng` | Micro-interactions, spring physics, touch feel |
| `scroll_2d` | `scroll-craft` | Scrollytelling, pinned 2D timelines, scroll triggers |
| `scroll_3d` | `scroll-world` | Continuous 3D fly-through, camera-scrub worlds |
| `img3d` | `img2threejs` | Procedural Three.js models from reference images |
| `docs` | `smartdoc` | Technical docs, OCR/PDF/DOCX extraction & contracts |
| `slides_pptx` | `deck-design` | Consulting PPTX / 16:9 HTML decks; smartdoc keeps PDF/DOCX; markitdown keeps ingest |
| `ingest_md` | `markitdown` | Structure-preserving Markdown ingest from Office/PDF |
| `prose` | `humanizer` / `/unslop` | Prose AI-tell removal; technical docs stay `technical-writing` |
| `academic` | `academic` | Literature surveys, IMRaD manuscripts, peer critique |
| `longdoc_nav` | `pageindex` | Tree/reasoning nav of long structured docs; not Graphiti/Cognee/second CBM |
| `browser_qa` | `playwright-qa` → `browser-act` → `chrome-devtools-axi` → `click-path-audit` | 4-door hierarchy; isolated verification sessions |
| `video_html` | `hyperframes` | Programmatic HTML-to-MP4 via headless Chrome + FFmpeg |
| `demo_id` | `id-demo-video` (`/demo-video`) | Indonesian narrated app tour; cards via hyperframes |
Expand Down Expand Up @@ -76,11 +79,11 @@ MANUAL_NOT_INVOKED

Never list unused tools as used.

UI direction from the bank routes to `found-this-design` first, which stops before component implementation. Visual UI and UI atoms (buttons, inputs, cards, nav) route to `impeccable` after Design V2 shortlist; BANK_MISS ≠ generate (+ shadcn/Design V2 internal). Stitch MCP is for screen/comp generation only, then found-this-design or impeccable with Design V2 atom shortlisting; never implement production UI from Stitch alone. UI Skills MCP is design-skill lookup only; product UI remains Design Bank + Impeccable + Design V2 atoms + shadcn; BANK_MISS ≠ generate from a random ui-skills document. Motion UI routes to `emil-design-eng`. Still/ads/non-UI surface route to `visual-studio`. Scroll-led stories route to `scroll-craft`, while continuous camera 3D fly-throughs route to `scroll-world`. Procedural Three.js object models from reference images route to `img2threejs`.
UI direction from the bank routes to `found-this-design` first, which stops before component implementation. Visual UI and UI atoms (buttons, inputs, cards, nav) route to `impeccable` after Design V2 shortlist; BANK_MISS ≠ generate (+ shadcn/Design V2 internal). Stitch MCP is for screen/comp generation only, then found-this-design or impeccable with Design V2 atom shortlisting; never implement production UI from Stitch alone. UI Skills MCP is design-skill lookup only; product UI remains Design Bank + Impeccable + Design V2 atoms + shadcn; BANK_MISS ≠ generate from a random ui-skills document. Motion UI routes to `emil-design-eng`. Still/ads/non-UI surface route to `visual-studio`. Scroll-led stories route to `scroll-craft`, while continuous camera 3D fly-throughs route to `scroll-world`. Procedural Three.js object models from reference images route to `img2threejs`. Schema/JSON generative UI from a typed catalog routes to `json-render` (after tokens/direction or internal schema UI; never bypass Design Bank for marketing).

Browser verification follows four explicit doors: exploratory application UI routes to `playwright-qa`, persistent multi-account sessions route to `browser-act`, observed Chromium cause routes to `chrome-devtools-axi`, and button handler sequential undo / shared-store side effects route to `click-path-audit`.

Documents (answer, create, transform, extract, review, PDF/DOCX) route to `smartdoc`. File-to-Markdown ingest routes to `markitdown`. Reusable book/module knowledge routes to `smartbook-ingest`. `/docx` and `/pdf` are missing aliases; nearest is `smartdoc`. `/pptx` is NOT_APPLICABLE. Do not add `commands/pdf.md` or `commands/docx.md`. Impeccable `document` remains DESIGN.md generation.
Documents (answer, create, transform, extract, review, PDF/DOCX) route to `smartdoc`. Consulting PPTX / 16:9 slide decks route to `deck-design`. Long structured document tree/reasoning nav routes to `pageindex`. File-to-Markdown ingest routes to `markitdown`. Reusable book/module knowledge routes to `smartbook-ingest`. `/docx` and `/pdf` are missing aliases; nearest is `smartdoc`. `/pptx` routes to `deck-design`. Do not add `commands/pdf.md` or `commands/docx.md`. Impeccable `document` remains DESIGN.md generation.

Prose AI-tell removal and natural tone polishing route to `humanizer` (`/unslop` is its manual alias). Scholarly research, academic manuscripts, and structured peer critique route to `academic`. Deterministic HTML composition rendered to video routes to `hyperframes`. Demo video aplikasi, walkthrough layar, narasi Indonesia, dan demo lomba route to `id-demo-video` (bukan `hyperframes` untuk durasi panjang utuh, bukan `playwright-qa`, bukan `visual-studio`). Kartu judul HTML→MP4 tetap `hyperframes`. Editorial technical diagrams (HTML/SVG) route to `diagram-design`.

Expand Down
Loading
Loading