baldart 4.80.1 → 4.82.0

package/framework/.claude/skills/webapp-testing/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — webapp-testing
+
+Formato: [Keep a Changelog](https://keepachangelog.com/) · [SemVer](https://semver.org/).
+
+## 1.0.0 — 2026-07-01
+
+- Baseline: versioning per-skill introdotto al framework v4.82.0.

package/framework/.claude/skills/webapp-testing/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: webapp-testing
 effort: medium
+version: 1.0.0
 description: Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
 license: Complete terms in LICENSE.txt
 ---

package/framework/.claude/skills/worktree-manager/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — worktree-manager
+
+Formato: [Keep a Changelog](https://keepachangelog.com/) · [SemVer](https://semver.org/).
+
+## 1.0.0 — 2026-07-01
+
+- Baseline: versioning per-skill introdotto al framework v4.82.0.

package/framework/.claude/skills/worktree-manager/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: worktree-manager
 effort: medium
+version: 1.0.0
 description: >
   Manage fully independent git worktrees for parallel coding agents.
   Commands: /nw (new worktree) creates an isolated workspace with its own

package/framework/agents/skills-mapping.md

@@ -191,6 +191,25 @@ Map Claude Code skills to project domains and provide guidance on when to use ea
 > standalone invocable BALDART skill. Route UI work through `ui-design` /
 > `ui-expert`, not to `ui-ux-pro-max` directly.
 
+### ui-implement
+
+**When to use**:
+
+- Implementing an ALREADY-APPROVED mockup into code + self-verifying its fidelity
+- Any mockup channel: a Claude Design link (pulled to source), finished source code (`mockups/_src/`), image, HTML — no Figma
+- The implementation twin of `ui-design` (which GENERATES the mockup); the SSOT of
+  the mockup→code build playbook that `/new` delegates a UI card to
+
+**Triggers**:
+
+- "/ui-implement"
+- "implementa il mockup" / "costruisci lo schermo dal design" / "build from mockup"
+
+> `ui-implement` OWNS a UI card's implement + **fidelity** verify (it spawns
+> `ui-expert` and folds in `/e2e-review`). It does NOT own code-quality / doc / QA —
+> those stay with `/new` for a mixed card. NOT `/ui-design` (generates) and NOT the
+> `ui-expert` agent (builds). Gated on `features.has_design_system`.
+
 ### motion-design
 
 **When to use**:
@@ -689,3 +708,13 @@ Document how to create custom skills:
 2. Follow skill template format
 3. Document when to use
 4. Add to this mapping file
+
+## Skill Versioning & Canonical Structure
+
+Every BALDART skill is **versioned** (`version:` SemVer in frontmatter, starting at
+`1.0.0`) and ships a per-skill **`CHANGELOG.md`** (a SEPARATE file, so version
+history never burns context when `SKILL.md` loads). The canonical layout is
+`SKILL.md` + `CHANGELOG.md` (required) plus `references/` / `assets/` / `scripts/`
+only when the skill needs them. Bump `version` + add a `CHANGELOG.md` entry in the
+same edit whenever a skill changes. Full convention:
+`framework/.claude/skills/skill-creator/references/skill-structure.md`.

package/framework/docs/MCP-INTEGRATION.md

@@ -25,7 +25,7 @@ Tre opzioni per integrare un sistema esterno in un agent BALDART. Scegli il più
 Non è un'imposizione: BALDART non installa MCP, non li valida, non li richiede. È una lista curata di MCP che hanno senso nei deployment dove BALDART è già in uso.
 
 ### Browser automation
-- **Playwright MCP** (`@modelcontextprotocol/server-playwright`) — usato da [bug](../.claude/skills/bug/SKILL.md) e [webapp-testing](../.claude/skills/webapp-testing/SKILL.md) per cattura visiva, network, console.
+- **Playwright CLI** (`@playwright/test` / `playwright`) — BALDART usa la **CLI**, non un MCP, per ogni cattura browser (screenshot, console, network). Le skill [playwright-skill](../.claude/skills/playwright-skill/SKILL.md), [webapp-testing](../.claude/skills/webapp-testing/SKILL.md) e [bug](../.claude/skills/bug/SKILL.md) scrivono script headless che salvano gli artefatti su disco e li rileggono, così **nessun MCP Playwright resta fisso nel contesto dell'agente**. Scelta deliberata per l'economia di token: la cattura deterministica non ha bisogno del modello-nel-loop, quindi la CLI evita gli accumuli di snapshot/a11y-tree per-azione tipici dell'MCP. (Il Playwright MCP che il broker Codex può spawnare dal `~/.codex/config.toml` dell'utente resta gestito dal reaper orfani in `baldart doctor` — è indipendente da BALDART.)
 
 ### Code knowledge graph (Graphify)
 - **Graphify** (`pipx install graphifyy` → CLI `graphify` + MCP server `graphify-mcp`) — code knowledge graph (tree-sitter, locale/offline, Leiden nativo). Gatato da `features.has_code_graph`. Usato da [codebase-architect](../.claude/agents/codebase-architect.md) e dalle skill di esplorazione per query **strutturali/relazionali** (`graphify query`/`path`/`explain`/`affected`), e dal layer wiki (`wiki-curator`, `/capture`, routine `doc-graph-align`) che si alimenta del `GRAPH_REPORT.md` nativo. **CLI-first** (sempre disponibile post-install); l'MCP `graphify-mcp` è opt-in (`graph.register_mcp`, best-effort `claude mcp add`). Fallback: degrada a LSP→Grep→Git. Vedi [code-graph-protocol.md](../agents/code-graph-protocol.md) e [CODE-GRAPH-LAYER.md](CODE-GRAPH-LAYER.md).
@@ -77,7 +77,7 @@ Subito dopo la sezione `## Project Context` (o, in mancanza, subito dopo il fron
 
 ### Regole
 
-1. **Sii specifico**: cita il prefisso del tool (`mcp__playwright__browser_navigate`), non il "concetto" (`Playwright MCP`). Aiuta il consumer a fare grep.
+1. **Sii specifico**: cita il prefisso del tool (es. `mcp__plugin_firebase_firebase__firestore_get_document`), non il "concetto" (`Firebase MCP`). Aiuta il consumer a fare grep.
 2. **Required vs Optional**: required = la skill non può completare il proprio task senza il MCP (o degrada gravemente). Optional = la skill ha un fallback funzionante.
 3. **Fallback espliciti**: per ogni `Optional`, descrivi il fallback in una frase ("se MCP unavailable, usa `rg` su `docs/` per trovare pattern noti").
 4. **Niente nuovo schema in `baldart.config.yml`**: non aggiungere `mcp.required` o `mcp.optional` nel config — è solo convenzione testuale finché non c'è una skill che ha bisogno di gatearne il comportamento a runtime.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baldart",
-  "version": "4.80.1",
+  "version": "4.82.0",
   "description": "Claude Agent Framework - Reusable framework for coordinating AI agents and humans in software projects",
   "bin": {
     "baldart": "./bin/baldart.js"