baldart 4.81.0 → 4.83.0

package/CHANGELOG.md

@@ -5,6 +5,65 @@ All notable changes to BALDART will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.83.0] - 2026-07-01
+
+**Versioned root-file primitives — BALDART now generates `AGENTS.md` + `CLAUDE.md` from SOTA skeletons.** Previously `AGENTS.md` was a bulk symlink into the framework payload (not customizable without losing auto-update) and `CLAUDE.md` was not shipped at all. Now both are **generated real files**, produced on every install/update from **versioned skeletons** under `framework/templates/primitives/`.
+
+Each skeleton mixes three tiers: **STATIC** (universal SOTA prose, shipped verbatim) · **`{{ slot }}`** (project facts filled *deterministically* at write-time from `baldart.config.yml` + `package.json`/README probes — concrete values, so Codex/Cursor/Aider read real commands, never raw `${…}`) · **`[OVERLAY]`** (project opinions authored in `.baldart/overlays/{AGENTS,CLAUDE}.md`, merged via the existing OVERRIDE/APPEND/PREPEND engine). This split follows the 2026 research consensus (short hand-authored skeleton + project depth in the overlay; auto-generating a whole file with an LLM measurably reduces agent task success).
+
+**`AGENTS.md` is the cross-tool SSOT** (read natively by Claude Code + Codex + others). **`CLAUDE.md` is a thin Claude-native stub** that deliberately does **not** import `AGENTS.md` (Claude Code loads both automatically → an `@AGENTS.md` would double-load the protocol) — it holds only Claude-only mechanics (Plan Mode / `AskUserQuestion` / Task tool / output-style / hooks). The writer (`src/utils/root-primitives.js`) reuses `overlay-merger.js` and the same `baldart-generated` marker, so the `framework-edit-gate` already blocks direct edits to the generated files (edit the overlay).
+
+**Existing hand-written files are adopted zero-loss:** a consumer's hand-authored `AGENTS.md`/`CLAUDE.md` (no marker) is preserved **verbatim** into `.baldart/overlays/<name>.md`, then the root is regenerated as skeleton + overlay. Adoption is **interactive-gated** — in autonomous/CI mode a hand-written file is never mutated (the writer emits a blocker and skips it). Wired into `add` (post-configure), `update` (aligned + post-pull paths, idempotent + byte-stable), `doctor` (`regenerate-root-primitives` / `adopt-root-primitives` actions), and `migrate` (legacy symlink → generated file). Each skeleton carries its own `primitive_version` + a sibling `*.CHANGELOG.md` kept out of the generated file.
+
+**MINOR** — additive capability. **No new `baldart.config.yml` key** (slots resolve from existing config + repo probes) → the schema-change propagation rule does NOT apply. Degrades safely: missing commands omit rows, non-multimodal/Codex consumers ignore `CLAUDE.md`, autonomous runs never mutate hand-written files. Authoritative design: [`framework/docs/ROOT-PRIMITIVES.md`](framework/docs/ROOT-PRIMITIVES.md).
+
+### Added
+
+- **`framework/templates/primitives/AGENTS.md` + `CLAUDE.md`** — the versioned SOTA skeletons (STATIC + `{{slot}}` + `[OVERLAY]` hook), each with a `primitive_version` banner.
+- **`framework/templates/primitives/AGENTS.CHANGELOG.md` + `CLAUDE.CHANGELOG.md`** — internal per-primitive changelogs (kept out of the generated file).
+- **`src/utils/root-primitives.js`** — the writer: slot resolver + minimal zero-dep template engine (`{{ }}` / `{{#flag}}` / `{{> partial}}`) + overlay merge + `baldart-generated` marker + state machine (generated / symlink / handwritten / absent) + `rootPrimitiveStatus()` for doctor.
+- **`framework/docs/ROOT-PRIMITIVES.md`** — consumer-facing design/lifecycle/adoption doc.
+
+### Changed
+
+- **`src/utils/symlinks.js`** — `createBulkSymlinks()` no longer symlinks `AGENTS.md`; `createAllSymlinks()` calls the new `writeRootPrimitives()`; `verifySymlinks()` no longer expects `AGENTS.md` to be a symlink.
+- **`src/commands/add.js`** — writes root primitives after `configure` populates the config (final concrete values).
+- **`src/commands/update.js`** — regenerates root primitives on both the aligned-install and post-pull paths (`reconcileRootPrimitives`); adds `CLAUDE.md` to `BALDART_MANAGED_PATTERNS`.
+- **`src/commands/doctor.js`** — detects stale/adoptable root primitives and offers `regenerate-root-primitives` / `adopt-root-primitives`.
+- **`src/commands/migrate.js`** — converts a legacy `AGENTS.md` symlink into the generated file (Step 2b), idempotent.
+- **`README.md`** — install description + repo-tree updated (AGENTS.md/CLAUDE.md generated, not symlinked).
+
+### Removed
+
+- **`framework/AGENTS.md`** — the old bulk-symlink source; its STATIC content now lives in `framework/templates/primitives/AGENTS.md` (single SSOT).
+
+## [4.82.0] - 2026-07-01
+
+**Mockup→code extracted into a dedicated self-verifying skill `/ui-implement` + skills are now versioned.** The mockup→code fidelity knowledge (v4.73→v4.78) was **inlined inside `/new`**: the "Design Reference" briefing (image/HTML/code-src branching), the design-source declaration + Step 7b grounding, and the Phase 2.6 `/e2e-review` invocation. This release **externalizes** it into one specialized, self-verifying skill and, separately, introduces **per-skill versioning + a canonical structure** across all skills.
+
+`/ui-implement` takes an ALREADY-APPROVED mockup and (1) **dispatches on the input channel** via `references/playbook.md` — a Claude Design handoff link (→ pull the screen's source read-only via the DesignSync MCP into `mockups/_src/`, then build-from-code — the primary standalone channel), finished code already on disk (`links.design_src`/`mockups/_src/` → build-from-code, reuse-first), image (→ load-image, pixels are the target), HTML (→ read-html, decode a Claude Design offline bundle via `extract-mockup-design.mjs`); **no Figma channel** (this project never uses Figma); (2) runs the registry-first cascade + component reconciliation; (3) builds via the **`ui-expert`** agent + grounds the design-source declaration; (4) reconciles the Post-Intervention Coherence; (5) **self-verifies fidelity** by folding in `/e2e-review` (structural + visual + design-quality trio + its own self-heal). A **THIN orchestrator** that cites `design-system-protocol.md`, `ui-expert.md`, `/e2e-review` and the verifier trio, never duplicating them (no dual-SSOT). Its scope is **fidelity ONLY** — `/new` still owns code-quality/doc/QA/ownership for a mixed card (no review hole); a pure-graphics card already skips those. `/new` **delegates** a UI card's implement+fidelity to it (programmatic, COMPACT JSON, same `status` contract as `/e2e-review`), retiring `implement.md`'s mockup detail to a thin pointer + **coarse inline fallback** (delegate-or-else-inline, the `/prd`→`/ds-handoff` model). Usable standalone (`/ui-implement <mockup-path-or-CARD-ID>`). `new2.js` keeps its inline path this release (parity is a follow-up after the context-economy measurement).
+
+Every shipped skill now carries a **`version:` SemVer** (starting `1.0.0`, the skill's own line of evolution) + a **separate per-skill `CHANGELOG.md`** (deliberately NOT a `SKILL.md` section, so version history never burns context on load). Canonical structure: `SKILL.md` + `CHANGELOG.md` required; `references/`/`assets/`/`scripts/` on demand only. `skill-creator` is the SSOT (`init_skill.py` scaffolds `version` + `CHANGELOG.md` and drops placeholder-dir noise; `quick_validate.py` allows `effort`/`version` and warns non-fatally on missing `version`/`effort`/`CHANGELOG.md`; full rule in `references/skill-structure.md`).
+
+**MINOR** — adds a skill (40 → 41) + a skill-metadata convention. No new `baldart.config.yml` key (`version` is skill-frontmatter metadata, `/ui-implement` rides on `features.has_design_system` + `features.has_e2e_review`) → the schema-change propagation rule does NOT apply. Additive + degrades to no-op / coarse fallback everywhere it can't run.
+
+### Added
+
+- **`framework/.claude/skills/ui-implement/`** — new skill: `SKILL.md` (thin orchestrator), `references/playbook.md` (input-type → build-workflow dispatch), `references/integration.md` (delegation contract from `/new`/`new2` + standalone), `CHANGELOG.md`.
+- **`framework/.claude/skills/skill-creator/references/skill-structure.md`** — the canonical-structure + versioning SSOT.
+- **`framework/.claude/skills/*/CHANGELOG.md`** — a per-skill changelog for all 41 skills (baseline `1.0.0`).
+
+### Changed
+
+- **`framework/.claude/skills/*/SKILL.md`** — added/normalized `version: 1.0.0` in every skill's frontmatter.
+- **`framework/.claude/skills/new/references/implement.md`** — the Design-Reference block now leads with a **delegation gate** to `/ui-implement` and compresses the mockup-specific detail into a coarse fallback that cites the playbook + `ui-expert.md`; registry-first cascade + Post-Intervention Coherence left intact (they apply to every UI card).
+- **`framework/.claude/skills/new/references/review-cycle.md`** — Phase 2.6 skips when the card was delegated to `/ui-implement` (the skill already ran the fidelity verify) + a maintainers' drift note (new2 keeps the inline path).
+- **`framework/.claude/skills/skill-creator/scripts/init_skill.py`** — template frontmatter gains `effort` + `version`; generates `CHANGELOG.md`; no longer scaffolds placeholder `scripts/`/`references/`/`assets/` dirs; updated next-steps.
+- **`framework/.claude/skills/skill-creator/scripts/quick_validate.py`** — `effort`/`version` are allowed frontmatter keys; non-fatal warnings when `version`/`effort`/`CHANGELOG.md` are missing.
+- **`framework/.claude/skills/skill-creator/SKILL.md`** — `CHANGELOG.md` is now the documented exception to "what not to include" (required); Step 3/4 describe the new scaffold behaviour; frontmatter section adds `version` + the no-angle-brackets rule.
+- **`framework/agents/skills-mapping.md`** — new `### ui-implement` entry (UI/UX Skills) + a "Skill Versioning & Canonical Structure" section.
+- **`CLAUDE.md`**, **`README.md`** — skill count 40 → 41, `ui-implement` in the inventory, two new convention entries (the dedicated skill + skill versioning).
+
 ## [4.81.0] - 2026-06-29
 
 **Playwright capture is CLI-only — no Playwright MCP anywhere in the framework.** BALDART already used the **Playwright Test CLI** for its main capture pipeline (`/e2e-review` Phase 3→4, `playwright-skill`, `webapp-testing`'s headless Python scripts), but three surfaces still drove the **Playwright MCP** interactively: the `bug` skill (Phase 1 UI reproduction via `browser_navigate`/`browser_take_screenshot`/`browser_console_messages`/`browser_network_requests`/`browser_evaluate`), the `/design-review` command (`allowed-tools` declared the four `mcp__playwright__*` tools + relied on `localhost:9221`), and the `/qa` DEEP tier ("Use MCP Playwright if available"). For **deterministic capture** the MCP is pure token overhead — every action round-trips a result (often a full a11y-tree snapshot) into context, accumulating per-step; a headless CLI script enters context once and writes screenshots/console/network to disk, read back only when needed. This release converts those three surfaces to the CLI so **no Playwright MCP is ever loaded into the agent context**.

package/README.md

@@ -66,7 +66,8 @@ npx baldart status
 ### What `add` (first install) does
 
 - Downloads the framework via Git subtree into `.framework/`
-- Creates symlinks for auto-updateable files (AGENTS.md, agents/)
+- Creates a symlink for the cross-tool `agents/` reference dir
+- Generates the root-file primitives `AGENTS.md` (cross-tool SSOT) + `CLAUDE.md` (Claude entry) from versioned skeletons — filling project facts from `baldart.config.yml` and merging `.baldart/overlays/{AGENTS,CLAUDE}.md`
 - Per-item-merges framework agents/commands/skills into `.claude/` (real directories where your own files coexist)
 - Detects Codex on the machine and mirrors skills into `.agents/skills/` if found
 - Copies customizable templates (hooks, UI guidelines, backlog cards)
@@ -212,14 +213,16 @@ Skills always-ask when required keys are missing — never silently default.
 never overwrites your file. Full guide:
 [`framework/docs/PROJECT-CONFIGURATION.md`](framework/docs/PROJECT-CONFIGURATION.md).
 
-### Skills (40 portable skills)
+### Skills (41 portable skills)
 
-Skills live under `.claude/skills/` and are auto-discovered by Claude Code.
+Skills live under `.claude/skills/` and are auto-discovered by Claude Code. Every
+skill is **versioned** (`version:` in frontmatter) and ships a per-skill
+`CHANGELOG.md` (v4.82.0 — see [skill-structure.md](framework/.claude/skills/skill-creator/references/skill-structure.md)).
 Bundled skills:
 
 - **Workflow**: `new`, `new2` (v4.16.0 — EXPERIMENTAL workflow-hosted `/new`, Claude-only, for A/B testing context economy), `prd`, `prd-add`, `bug`, `simplify`, `worktree-manager`, `issue-review`, `context-primer`
 - **Code quality**: `skill-creator`, `find-skills`, `webapp-testing`, `playwright-skill`, `lsp-bootstrap` (v3.10.0), `graphify-bootstrap` (v4.21.0 — code knowledge graph), `graph-align` (v4.21.0 — doc↔graph alignment), `toolchain-bootstrap` (v4.41.0 — curated dev toolchain), `e2e-review` (v3.18.0)
-- **Design**: `frontend-design`, `ui-design`, `motion-design`, `gamification-design`, `design-system-init` (v3.11.0 — bulk registry bootstrap/upgrade), `ds-new` (v4.69.0 — single-element guided creation: one component or token, reuse-first → optional scaffold → document + register + govern + verify; the on-the-fly twin of `design-system-init`), `ds-edit` (v4.70.0 — deliberate edit of one existing element: resync / extend-variant / breaking / re-govern; regenerates the spec preserving agentic fields + prose, same canonical template), `ds-render` (v4.76.0 — render primitives in isolation to PNG via Storybook+Playwright), `design-sync` (v4.76.0 — mirror the registry to its Claude Design satellite), `ds-handoff` (v4.79.0 — field-level 1:1 Claude Design handoff brief: grounds every screen's fields in the real data schemas + coverage-gates before emitting; the SSOT for the Claude Design prompt, delegated from `/prd`)
+- **Design**: `frontend-design`, `ui-design`, `ui-implement` (v4.82.0 — implement an approved mockup end-to-end + self-verify fidelity; the mockup→code playbook SSOT, delegated from `/new`), `motion-design`, `gamification-design`, `design-system-init` (v3.11.0 — bulk registry bootstrap/upgrade), `ds-new` (v4.69.0 — single-element guided creation: one component or token, reuse-first → optional scaffold → document + register + govern + verify; the on-the-fly twin of `design-system-init`), `ds-edit` (v4.70.0 — deliberate edit of one existing element: resync / extend-variant / breaking / re-govern; regenerates the spec preserving agentic fields + prose, same canonical template), `ds-render` (v4.76.0 — render primitives in isolation to PNG via Storybook+Playwright), `design-sync` (v4.76.0 — mirror the registry to its Claude Design satellite), `ds-handoff` (v4.79.0 — field-level 1:1 Claude Design handoff brief: grounds every screen's fields in the real data schemas + coverage-gates before emitting; the SSOT for the Claude Design prompt, delegated from `/prd`)
 - **Product**: `seo-audit`, `copywriting`, `api-design-principles`
 - **Knowledge**: `doc-writing-for-rag`, `capture` (LLM wiki overlay)
 - **Internationalization**: `i18n` (v4.52.0 — audit the context registry + context-aware translation into native locale files), `i18n-adopt` (v4.52.0 — one-shot migration that externalizes all hardcoded strings on an existing codebase); both gated on `features.has_i18n`
@@ -363,7 +366,8 @@ npx baldart routines disable wiki-review   # remove the schedule
 ```
 your-project/
 ├── .framework/              # Framework source (via Git subtree)
-├── AGENTS.md               # Symlink → .framework/AGENTS.md
+├── AGENTS.md               # Generated from skeleton + config + overlay (cross-tool SSOT)
+├── CLAUDE.md               # Generated Claude Code entry (Claude-native mechanics)
 ├── agents/                  # Symlink → .framework/agents/
 ├── .claude/
 │   ├── agents/             # Symlink → .framework/.claude/agents/

package/VERSION

@@ -1 +1 @@
-4.81.0
+4.83.0

package/framework/.claude/hooks/agent-discovery-gate.js

@@ -15,8 +15,10 @@
  *            as BROKEN in some scenarios (files ignored at session start)
  *
  * This hook covers the filesystem-detectable subset of the problem
- * (missing/broken symlinks). The model-side defense (the MUST rule in
- * `framework/AGENTS.md`) covers the rest. The two are inseparable:
+ * (missing/broken symlinks). The model-side defense (the MUST rule in the
+ * generated root `AGENTS.md`, shipped from
+ * `framework/templates/primitives/AGENTS.md`) covers the rest. The two are
+ * inseparable:
  * without the MUST rule, a `permissionDecision: deny` from this hook
  * would likely be worked around by the model trying a different
  * `subagent_type` — the very failure mode this hook exists to prevent.

package/framework/.claude/skills/api-design-principles/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — api-design-principles
+
+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/api-design-principles/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: api-design-principles
 effort: medium
+version: 1.0.0
 description: Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.
 ---
 

package/framework/.claude/skills/baldart-push/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — baldart-push
+
+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/baldart-push/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: baldart-push
 effort: medium
+version: 1.0.0
 description: "Guidance for contributing local framework improvements upstream to the BALDART repository. Use when the user says /baldart-push, 'contribuisci al framework', 'push del framework', 'manda upstream', 'pusha le modifiche al framework', or wants to share local improvements made to .framework/. The skill walks the user through the contribution flow and hands off to `npx baldart push` (which must run in the user's terminal because the CLI is interactive). Never pushes baldart.config.yml, .baldart/overlays/, or .claude/hooks/ customizations — only generic framework payload."
 contamination_scan: skip
 ---

package/framework/.claude/skills/baldart-update/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — baldart-update
+
+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/baldart-update/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: baldart-update
 effort: medium
+version: 1.0.0
 description: "Guidance for updating BALDART framework to the latest version in a consumer repo. Use when the user says /baldart-update, 'aggiorna baldart', 'aggiorna framework', 'update del framework', 'pull baldart latest', or wants to bring the framework up-to-date. The update is SEAMLESS (v4.8.0+): a single `npx baldart update --yes` auto-stashes non-framework work, auto-resolves divergence (overlay-covered edits → clean reinstall that re-applies overlays; uncovered edits → auto-captured into overlays and verified), reconciles + commits BALDART-managed artifacts, and re-applies the stash — zero prompts in the happy path. The skill only narrates and reports; it never re-implements the CLI or replicates its prompts. Two modes, auto-detected: INTERACTIVE (a human is present) and AUTONOMOUS (unattended — CI / scheduled routine, signalled by BALDART_AUTONOMOUS / CI / GITHUB_ACTIONS env, uses --json). The CLI stops ONCE only when an edit cannot be captured+verified (a section deletion, a frontmatter/preamble change, a src/ change) — the skill surfaces that single pause. Always asserts post-flight that .framework/VERSION actually changed. For non-update drift, defers to `npx baldart` (smart doctor)."
 contamination_scan: skip
 ---

package/framework/.claude/skills/bug/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — bug
+
+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/bug/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: bug
 effort: medium
+version: 1.0.0
 description: >
   Structured bug investigation and resolution workflow (framework-agnostic; project-specific entry points are loaded from `.baldart/overlays/bug.md`).
   Use when: the user says /bug, 'debug', 'c e un bug', 'non funziona', 'errore', 'broken',

package/framework/.claude/skills/capture/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — capture
+
+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/capture/SKILL.md

@@ -2,7 +2,7 @@
 name: capture
 effort: medium
 description: Distilla una sintesi cross-document della conversazione recente in una synthesis page riusabile del wiki overlay (path da `paths.wiki_dir`/syntheses/ in `baldart.config.yml`). Usare quando l'utente invoca `/capture`, dice "capture synthesis", "salva sintesi", "distilla conversazione", "save this as wiki", "questa conversazione in wiki", o quando chiede di trasformare un ragionamento cross-document appena fatto in una pagina stabile. Due modalità — manual (sempre funzionante) e proactive (conditional sui candidati in `.claude/capture-queue/`). Implementa il loop query→wiki file-back di Karpathy.
-version: 0.1.0
+version: 1.0.0
 ---
 
 # /capture — Synthesis Capture Skill

package/framework/.claude/skills/context-primer/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — context-primer
+
+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/context-primer/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: cont
 effort: medium
+version: 1.0.0
 description: >
   Load codebase context silently before starting work, optimized for LLM
   comprehension using research-backed structured formatting.

package/framework/.claude/skills/copywriting/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — copywriting
+
+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/design-sync/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — design-sync
+
+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/design-sync/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: design-sync
 effort: high
+version: 1.0.0
 description: >
   Keep the in-repo design system (the SSOT) and its Claude Design satellite
   "mirror" project in sync — the code→design half of the closed loop. Three modes:

package/framework/.claude/skills/design-system-init/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — design-system-init
+
+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/design-system-init/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: design-system-init
 effort: medium
+version: 1.0.0
 description: >
   Bootstrap OR upgrade a component registry / design system. GREENFIELD: scaffolds
   ${paths.design_system}/INDEX.md (a thin generated router), a DTCG

package/framework/.claude/skills/doc-writing-for-rag/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — doc-writing-for-rag
+
+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/doc-writing-for-rag/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: doc-writing-for-rag
 effort: medium
+version: 1.0.0
 description: "Writes high-density reference documentation optimized for RAG indexing. Uses compact templates, minimal frontmatter, cross-references to schemas.md/errors.md (paths from `paths.api_schemas`/`paths.api_errors` in `baldart.config.yml`). Load this skill when creating or rewriting files in `${paths.references_dir}`, `${paths.prd_dir}`, or when you hear 'endpoint template', 'compact docs', 'doc for RAG', 'dense documentation', 'signal/noise ratio'."
 ---
 

package/framework/.claude/skills/ds-edit/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — ds-edit
+
+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/ds-edit/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: ds-edit
 effort: medium
+version: 1.0.0
 description: >
   Update ONE existing canonical design-system element correctly — the deliberate
   edit twin of /ds-new. Classifies the change (resync the spec to changed source /

package/framework/.claude/skills/ds-handoff/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — ds-handoff
+
+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/ds-handoff/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: ds-handoff
 effort: medium
+version: 1.0.0
 description: >
   Produce a FIELD-LEVEL, 1:1, interaction-complete handoff brief for Claude Design
   — every screen's real fields (label, control type, required, validation, default,

package/framework/.claude/skills/ds-new/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — ds-new
+
+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/ds-new/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: ds-new
 effort: medium
+version: 1.0.0
 description: >
   Create ONE canonical design-system element — a component OR a token — end to
   end with the full discipline: reuse-first research, (optional) scaffold, then

package/framework/.claude/skills/ds-render/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — ds-render
+
+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/ds-render/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: ds-render
 effort: medium
+version: 1.0.0
 description: >
   Render the design-system primitives in ISOLATION (one component × variant at a
   time) and capture a PNG per entry — the render harness BALDART never had (today

package/framework/.claude/skills/e2e-review/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — e2e-review
+
+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/e2e-review/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: e2e-review
 effort: medium
+version: 1.0.0
 description: >
   Deterministic, BLOCKING end-to-end review run after a feature is implemented.
   Combines functional E2E (Playwright spec written by `coder`, executed via

package/framework/.claude/skills/find-skills/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — find-skills
+
+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/find-skills/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: find-skills
 effort: medium
+version: 1.0.0
 description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
 ---
 

package/framework/.claude/skills/frontend-design/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — frontend-design
+
+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/frontend-design/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: frontend-design
 effort: medium
+version: 1.0.0
 description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
 license: Complete terms in LICENSE.txt
 ---

package/framework/.claude/skills/gamification-design/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — gamification-design
+
+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/graph-align/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — graph-align
+
+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/graph-align/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: graph-align
 effort: medium
+version: 1.0.0
 description: >
   On-demand documentation alignment via the Graphify code knowledge graph.
   Rebuilds the graph offline (graphify update .), then cross-checks graph

package/framework/.claude/skills/graphify-bootstrap/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — graphify-bootstrap
+
+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/graphify-bootstrap/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: graphify-bootstrap
 effort: medium
+version: 1.0.0
 description: >
   Install, verify, and wire the Graphify code-knowledge-graph layer for this
   project. Installs the Graphify CLI (pipx install graphifyy), builds the graph

package/framework/.claude/skills/i18n/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — i18n
+
+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/i18n/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: i18n
 effort: medium
+version: 1.0.0
 description: >
   On-demand internationalization audit + context-aware translation. Audits the
   i18n context registry against the t() calls and native locale files (drift

package/framework/.claude/skills/i18n-adopt/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — i18n-adopt
+
+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/i18n-adopt/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: i18n-adopt
 effort: medium
+version: 1.0.0
 description: >
   One-shot migration that ADOPTS the i18n layer on an existing codebase: scans
   the whole project for hardcoded user-facing strings, methodically replaces each

package/framework/.claude/skills/issue-review/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — issue-review
+
+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/issue-review/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: issue-review
 effort: medium
+version: 1.0.0
 description: Run the GitHub issue review workflow for triage and planning. Use when the user asks to review or triage a GitHub issue, requests the /issue-review slash command, or needs an issue summary with priority/plan/tests.
 ---
 

package/framework/.claude/skills/kie-ai/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — kie-ai
+
+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/kie-ai/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: kie-ai
 effort: medium
+version: 1.0.0
 description: >
   Generate images, videos, and audio using Kie.ai's unified AI API platform (80+ models).
   Use when: (1) generating images from text or editing images (Nano Banana 2, Imagen 4, Flux Kontext,

package/framework/.claude/skills/lsp-bootstrap/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — lsp-bootstrap
+
+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/lsp-bootstrap/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: lsp-bootstrap
 effort: medium
+version: 1.0.0
 description: >
   Install, verify, and document the LSP symbol-search layer for this project.
   Detects languages (TypeScript, Python, Go, Rust, Ruby), installs the matching

package/framework/.claude/skills/motion-design/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — motion-design
+
+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/motion-design/SKILL.md

@@ -10,7 +10,7 @@ description: >
 license: MIT
 metadata:
   author: LottieFiles
-  version: "1.0.0"
+version: 1.0.0
 ---
 
 # Motion Design Skill

package/framework/.claude/skills/new/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog — new
+
+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/new/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: new
 effort: medium
+version: 1.0.0
 description: >
   Orchestrate a team of specialized agents to implement one or more backlog cards
   end-to-end inside a dedicated worktree, with code review, doc review, QA, and