@eltonssouza/development-utility-kit 0.15.0 → 0.15.1

package/.claude/agents/ux-designer.md

@@ -52,7 +52,7 @@ Never invent a custom component when the declared library has a matching primiti
 
 `impeccable` is the harness's frontend design-quality gate — an external plugin by Paul Bakaus (credited in `README.md §Acknowledgements`), not bundled. It is **gated through `project-manager` §6.6 (ADR-048)**: whenever frontend/ux work is in scope, `project-manager` **offers** impeccable to the user (mandatory offer, the user chooses). On "Sim" the flow is, in order:
 
-1. **Install (if absent)** — terminal, in the selected project: `npx skills add pbakaus/impeccable`.
+1. **Install (if absent)** — prefer the Claude Code plugin (git-based, cross-platform): `/plugin marketplace add pbakaus/impeccable` then `/plugin install impeccable`. The `npx skills add pbakaus/impeccable` route needs `unzip` (breaks on Windows).
 2. **Teach** — Claude Code: `/impeccable teach` (analyzes the project's stack, tokens, patterns).
 3. **Act** — Claude Code: the fitting verb — `/impeccable shape` (from scratch), `polish`, `audit`, `critique`, `harden`, `clarify`, `colorize`, `animate`, …
 

package/.claude/skills/project-manager/SKILL.md

@@ -258,14 +258,15 @@ Options: **Sim** / **Não**.
 - **Não** → deliver the normal `frontend-developer` / `ux-designer` output. Done.
 - **Sim** → run the three ordered gates below (Steps 2→4), then **resume orchestration** (Step 5).
 
-### Step 2 — Install gate (terminal, in the selected project)
-Check whether impeccable is present in the selected project (`.claude/skills/impeccable/` or the `/impeccable` skill is available). If **absent**, install it **into the current project** from the terminal — cwd = the selected project root:
+### Step 2 — Install gate (only if absent)
+Check whether impeccable is present (the `/impeccable` skill is available, or `.claude/skills/impeccable/` exists). If **absent**, install it. Prefer the **Claude Code plugin marketplace** method — it is git-based and cross-platform (the `npx impeccable skills install` / `npx skills add` routes depend on `unzip`, which is absent on Windows and breaks the install):
 
-```bash
-npx skills add pbakaus/impeccable
+```
+/plugin marketplace add pbakaus/impeccable
+/plugin install impeccable
 ```
 
-This lands impeccable in the project's `.claude/skills/`. **Skip** this step if it is already installed. (Per-project install — not global.)
+Fallback (only where `unzip` is on PATH, e.g. macOS/Linux or Git-Bash on Windows): `npx skills add pbakaus/impeccable` (per-project, lands in `.claude/skills/`). **Skip** this step entirely if impeccable is already installed.
 
 ### Step 3 — Teach gate (Claude Code, in-session)
 impeccable must learn the project before it acts. Invoke its project-analysis command:

package/README.md

@@ -28,10 +28,10 @@ npx @eltonssouza/development-utility-kit install
 
 Stands on the best community skills & plugins — recommended, not bundled (the installer prints this too):
 
-- **Impeccable** (frontend design gate) — `npx impeccable skills install`
+- **Impeccable** (frontend design gate) — `/plugin marketplace add pbakaus/impeccable` then `/plugin install impeccable` *(cross-platform; npx route needs `unzip` on Windows)*
 - **Caveman** (token-saving output) — `npm install -g @juliusbrussee/caveman-code`
-- **RTK** (token-killer CLI proxy) — `brew install rtk` *(macOS)*
-- **Grill-me** (discovery interview) — `npx skills@latest add mattpocock/skills`
+- **RTK** (token-killer CLI proxy) — `cargo install rtk` *(or `brew install rtk` on macOS)*
+- **Grill-me** (discovery interview) — `npx skills@latest add mattpocock/skills` *(needs `unzip` on Windows)*
 
 ## What you get
 

package/README.npm.md

@@ -28,10 +28,10 @@ npx @eltonssouza/development-utility-kit install
 
 Stands on the best community skills & plugins — recommended, not bundled (the installer prints this too):
 
-- **Impeccable** (frontend design gate) — `npx impeccable skills install`
+- **Impeccable** (frontend design gate) — `/plugin marketplace add pbakaus/impeccable` then `/plugin install impeccable` *(cross-platform; npx route needs `unzip` on Windows)*
 - **Caveman** (token-saving output) — `npm install -g @juliusbrussee/caveman-code`
-- **RTK** (token-killer CLI proxy) — `brew install rtk` *(macOS)*
-- **Grill-me** (discovery interview) — `npx skills@latest add mattpocock/skills`
+- **RTK** (token-killer CLI proxy) — `cargo install rtk` *(or `brew install rtk` on macOS)*
+- **Grill-me** (discovery interview) — `npx skills@latest add mattpocock/skills` *(needs `unzip` on Windows)*
 
 ## What you get
 

package/README.repo.md

@@ -33,10 +33,10 @@ development-utility-kit stands on the best community skills & plugins. They are
 
 | Companion | What it adds | Install |
 |---|---|---|
-| **Impeccable** | frontend design gate (polish / audit / critique) — wired into `project-manager` §6.6 | `npx impeccable skills install` |
+| **Impeccable** | frontend design gate (polish / audit / critique) — wired into `project-manager` §6.6 | `/plugin marketplace add pbakaus/impeccable` then `/plugin install impeccable` *(git-based, cross-platform; the `npx impeccable skills install` route needs `unzip` and breaks on Windows)* |
 | **Caveman** | token-saving telegraphic output (~75% fewer tokens) | `npm install -g @juliusbrussee/caveman-code` |
-| **RTK** | Rust Token Killer CLI proxy (60–90% savings) — powers the dashboard widget | `brew install rtk` *(macOS; see RTK repo for Windows/Linux)* |
-| **Grill-me** | relentless discovery interview (opens the delivery pipeline) | `npx skills@latest add mattpocock/skills` |
+| **RTK** | Rust Token Killer CLI proxy (60–90% savings) — powers the dashboard widget | `cargo install rtk` *(cross-platform; or `brew install rtk` on macOS)* |
+| **Grill-me** | relentless discovery interview (opens the delivery pipeline) | `npx skills@latest add mattpocock/skills` *(needs `unzip` on PATH on Windows)* |
 
 ---
 

package/bin/cli.js

@@ -491,10 +491,10 @@ function adoptProject(opts) {
  * each is installed separately by the user (per ADR-010 / Acknowledgements).
  */
 const COMPANIONS = [
-  { name: 'Impeccable', what: 'frontend design gate (polish / audit / critique)', cmd: 'npx impeccable skills install' },
+  { name: 'Impeccable', what: 'frontend design gate (polish / audit / critique)', cmd: '/plugin marketplace add pbakaus/impeccable', note: 'in Claude Code, then /plugin install impeccable — git-based, cross-platform' },
   { name: 'Caveman', what: 'token-saving telegraphic output (~75% fewer tokens)', cmd: 'npm install -g @juliusbrussee/caveman-code' },
-  { name: 'RTK', what: 'Rust Token Killer CLI proxy (60-90% savings)', cmd: 'brew install rtk', note: 'macOS; see the RTK repo for Windows/Linux' },
-  { name: 'Grill-me', what: 'relentless discovery interview', cmd: 'npx skills@latest add mattpocock/skills' },
+  { name: 'RTK', what: 'Rust Token Killer CLI proxy (60-90% savings)', cmd: 'cargo install rtk', note: 'cross-platform; or brew install rtk on macOS' },
+  { name: 'Grill-me', what: 'relentless discovery interview', cmd: 'npx skills@latest add mattpocock/skills', note: 'needs unzip on PATH on Windows' },
 ];
 
 /**

package/dashboard/public/content/docs/skills-reference.en.md

@@ -47,7 +47,7 @@ This document covers the 18 official skills of the harness, grouped by purpose.
 
 Reference: **ADR-033** — orchestrate mode fills the fast-lane gap acknowledged in ADR-008 §Consequences ("8 etapas para feature pequena é cerimônia").
 
-**Frontend design gate (§6.6, ADR-048)**: whenever the dispatch touches the `frontend`/`ux` domain, `project-manager` **must offer the external `impeccable` design gate** (mandatory offer; the user chooses). On "Sim" it runs, in order: install if absent (`npx skills add pbakaus/impeccable`, terminal, per-project) → `/impeccable teach` (analyze project) → `/impeccable <verb>` (polish/audit/…) → then resumes orchestration. Impeccable is a tool, not the authority; `project-manager` never auto-runs it and never abdicates control. Extends ADR-010's gate-keeper WARN check.
+**Frontend design gate (§6.6, ADR-048)**: whenever the dispatch touches the `frontend`/`ux` domain, `project-manager` **must offer the external `impeccable` design gate** (mandatory offer; the user chooses). On "Sim" it runs, in order: install if absent (prefer `/plugin marketplace add pbakaus/impeccable` + `/plugin install impeccable` — git-based, cross-platform; the `npx` route needs `unzip` and breaks on Windows) → `/impeccable teach` (analyze project) → `/impeccable <verb>` (polish/audit/…) → then resumes orchestration. Impeccable is a tool, not the authority; `project-manager` never auto-runs it and never abdicates control. Extends ADR-010's gate-keeper WARN check.
 
 **Delegated agent(s)**: variable, per internal routing table. ROUTE dispatches 1; ORCHESTRATE dispatches 2–5 in parallel.
 

package/dashboard/public/content/manual/frontend.en.md

@@ -322,9 +322,10 @@ The harness exposes skills that trigger by **keyword** in Claude Code/Cowork con
 ```
 front detectada → PM pergunta "usar impeccable?"
   └─ Sim:
-       1. [terminal, no projeto]  npx skills add pbakaus/impeccable   (só se ausente)
-       2. [claude code]           /impeccable teach                   (analisa o projeto)
-       3. [claude code]           /impeccable <verbo>                 (polish / audit / …)
+       1. [claude code]  /plugin marketplace add pbakaus/impeccable  (só se ausente)
+                         /plugin install impeccable
+       2. [claude code]  /impeccable teach                           (analisa o projeto)
+       3. [claude code]  /impeccable <verbo>                         (polish / audit / …)
        → project-manager retoma a orquestração
 ```
 
@@ -335,13 +336,14 @@ The offer is mandatory, the use is yours — same gating philosophy as `grill-me
 - Author: Paul Bakaus
 - Repo: `github.com/pbakaus/impeccable`
 
-### Installation (gate 1 — terminal, per-project)
+### Installation (gate 1 — Claude Code, cross-platform)
 
-```bash
-npx skills add pbakaus/impeccable
+```
+/plugin marketplace add pbakaus/impeccable
+/plugin install impeccable
 ```
 
-Installs into the **selected project's** `.claude/skills/` — the `/impeccable *` commands then become available in that project's Claude Code chat. `project-manager` runs this automatically when you accept the offer and impeccable is not yet present.
+Git-based — no `unzip` needed, so it works on Windows. The `/impeccable *` commands then become available in chat. (The `npx skills add pbakaus/impeccable` / `npx impeccable skills install` routes depend on `unzip` and fail on stock Windows.) `project-manager` runs this automatically when you accept the offer and impeccable is not yet present.
 
 ### Available commands (gates 2 & 3 — Claude Code)
 

package/dashboard/public/content/manual/fullstack.en.md

@@ -353,11 +353,14 @@ fullstack project.
 > installs if absent, runs `/impeccable teach` (analyzes the project), then the
 > action verb — and resumes control. See the [frontend manual](frontend) §5.
 
-**Install** (gate 1 — once per project, terminal):
+**Install** (gate 1 — in Claude Code, cross-platform):
 
-```bash
-npx skills add pbakaus/impeccable
 ```
+/plugin marketplace add pbakaus/impeccable
+/plugin install impeccable
+```
+
+Git-based, no `unzip` — works on Windows. (The `npx` install routes need `unzip` and fail on stock Windows.)
 
 **Available commands**:
 
@@ -1424,9 +1427,9 @@ Details: [hooks-reference](../docs/hooks-reference).
 - **Senior+ gate**: set of thresholds (coverage, mutation, a11y,
   Lighthouse, pyramid ratio) that blocks merge.
 - **Vault**: `docs/brain/` in Obsidian format (wiki links + tags + MOC).
-- **Impeccable**: external pack (`npx skills add pbakaus/impeccable`) with
-  `/impeccable polish|audit|harden|typeset|colorize|layout` commands for
-  visual polish.
+- **Impeccable**: external plugin (`/plugin marketplace add pbakaus/impeccable`
+  then `/plugin install impeccable`) with `/impeccable teach|shape|polish|audit|
+  critique|harden` commands for visual polish.
 - **openapi-typescript**: TS type generator from OpenAPI 3.x.
 - **Goal-ready**: explicit, measurable, tied to the objective.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eltonssouza/development-utility-kit",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "npx installer for the development-utility-kit harness",
   "bin": {
     "duk": "bin/cli.js"