@kondeio/kdf 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to KDF are documented here. Format loosely follows
 [Keep a Changelog](https://keepachangelog.com); versions follow semver.
 
+## [0.1.2] - 2026-06-22
+
+### Changed
+- Renamed package documentation files to shorter names:
+  `docs/doc.md` and `docs/skill.md`.
+- Updated README and package references to the new documentation filenames.
+
+## [0.1.1] - 2026-06-22
+
+### Changed
+- Documentation now keeps the KDF install flow npm-focused: default install is
+  `npm install @kondeio/kdf`, skip scaffolding with `--ignore-scripts` or
+  `KDF_SKIP_INIT=1`, and run manual initialization with
+  `npm exec -- kdf init`.
+- CLI help now shows the npm-based manual initialization command.
+
 ## [0.1.0] - 2026-06-18
 
 Initial public release candidate.
@@ -20,7 +36,7 @@ Initial public release candidate.
 - `dedupeClasses()`, `composeClasses()`, `cx()`, and
   `createClassComposer({ merge })`.
 - Documented the **server-only** constraint (resolver uses Node `fs`) across
-  README, `docs/kdf-doc.md`, and `docs/kdf-skill.md`, with the
+  README, `docs/doc.md`, and `docs/skill.md`, with the
   resolve-on-server / pass-className-as-prop pattern.
 - `CONTRIBUTING.md`, `SECURITY.md`, `CHANGELOG.md`.
 

package/README.md

@@ -73,16 +73,16 @@ npm install @kondeio/kdf --ignore-scripts
 Run initialization manually later:
 
 ```bash
-npx kdf init
+npm exec -- kdf init
 ```
 
-`npx kdf init` uses the local package binary when `@kondeio/kdf` is already
+`npm exec -- kdf init` uses the local package binary when `@kondeio/kdf` is already
 installed in the project.
 
 Initialize a custom design directory:
 
 ```bash
-KDF_DIR=./designs npx kdf init
+KDF_DIR=./designs npm exec -- kdf init
 ```
 
 ## File Structure
@@ -349,8 +349,8 @@ export default withKDF({ dir: "./my-design" })(nextConfig);
 
 ## Documentation and Skills
 
-- [`docs/kdf-doc.md`](./docs/kdf-doc.md) - KDF concept, architecture, conventions, and operating model.
-- [`docs/kdf-skill.md`](./docs/kdf-skill.md) - agent-facing implementation and review checklist.
+- [`docs/doc.md`](./docs/doc.md) - KDF concept, architecture, conventions, and operating model.
+- [`docs/skill.md`](./docs/skill.md) - agent-facing implementation and review checklist.
 
 ## Contributing
 

package/SECURITY.md

@@ -37,7 +37,7 @@ KDF_SKIP_INIT=1 npm install @kondeio/kdf
 You can scaffold manually later with:
 
 ```bash
-npx kdf init
+npm exec -- kdf init
 ```
 
 ## Reference resolution safety

package/dist/cli.js

@@ -52,7 +52,7 @@ if (!command || !commands[command]) {
     console.log("  init       Scaffold kdf/ folder + konde.css");
     console.log("");
     console.log("Usage:");
-    console.log("  npx @kondeio/kdf init");
+    console.log("  npm exec -- kdf init");
     process.exit(command ? 1 : 0);
 }
 commands[command]();

package/docs/{kdf-doc.md → doc.md}

@@ -631,13 +631,13 @@ folder does not already exist. Existing files are never overwritten.
 Manual initialization:
 
 ```bash
-npx kdf init
+npm exec -- kdf init
 ```
 
 Custom design directory:
 
 ```bash
-KDF_DIR=./designs npx kdf init
+KDF_DIR=./designs npm exec -- kdf init
 ```
 
 Next.js config:

package/docs/{kdf-skill.md → skill.md}

@@ -34,7 +34,7 @@ npm install @kondeio/kdf --ignore-scripts
 Manual init:
 
 ```bash
-npx kdf init
+npm exec -- kdf init
 ```
 
 Do not document fake custom npm flags such as `--noinit`. Use `--ignore-scripts`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kondeio/kdf",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Agent-first design consistency for Node-powered web apps. KDF gives AI agents a JSON source of truth for consistent UI.",
   "license": "MIT",
   "type": "module",