@adobe/data-ai 0.9.74 → 0.9.76

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adobe-data-ai",
-  "version": "0.9.74",
+  "version": "0.9.75",
   "description": "Architecture skills for @adobe/data — data-oriented modelling, archetype iteration, hot-path performance, and related conventions.",
   "author": {
     "name": "Adobe"

package/README.md

@@ -4,36 +4,32 @@ Cross-agent architecture skills for [`@adobe/data`](https://www.npmjs.com/packag
 
 Skills version in lockstep with the library: `@adobe/data-ai@x.y.z` describes `@adobe/data@x.y.z`.
 
-## Install (any agent)
+There are two distribution paths, one per agent family — they do **not** overlap:
 
-The installer copies the flat skill folders into whichever skill roots your project's agents scan. It is idempotent and version-stamped — commit the result, and re-run to refresh.
+- **Claude Code → marketplace plugin** (see below). The installer never writes into `.claude/skills/`, so it can't collide with your own Claude skills.
+- **Cursor / Codex / other `.agents`-standard agents → `npx … install`** (below).
+
+## Install (Cursor, Codex, `.agents` agents)
+
+The installer copies the skill folders into a single namespaced bundle directory that agents which recurse `.agents/skills/` discover:
 
 ```sh
 npx @adobe/data-ai@latest install
 ```
 
-This writes:
-
-| Root | Agent | Notes |
-| --- | --- | --- |
-| `.claude/skills/<name>/` | Claude Code | No recursion — skills must be flat. |
-| `.agents/skills/<name>/` | Cursor, Codex | Tool-neutral; other Agent-Skills agents pick these up. |
+This writes `.agents/skills/adobe-data-ai/<name>/SKILL.md` for each skill. The whole `adobe-data-ai/` directory belongs to this package, so a re-run is a clean wipe-and-recopy that never touches skills you authored elsewhere. Commit the result to share it with your team.
 
 Options:
 
 ```sh
-npx @adobe/data-ai@latest install --claude     # only .claude/skills
-npx @adobe/data-ai@latest install --agents     # only .agents/skills (alias: --cursor)
-npx @adobe/data-ai@latest install --global      # into ~/.claude, ~/.agents
-npx @adobe/data-ai@latest install --dir=./sub   # into a specific base dir
-npx @adobe/data-ai@latest list                  # show bundled skills
+npx @adobe/data-ai@latest install --global      # into ~/.agents/skills/adobe-data-ai/
+npx @adobe/data-ai@latest install --dir=./sub    # into a specific base dir
+npx @adobe/data-ai@latest list                   # show bundled skills
 ```
 
-Each root gets a `.data-ai.json` manifest recording which skills this package owns, so a re-run prunes skills we no longer ship without touching skills you added yourself.
-
 ## Install (Claude Code plugin)
 
-Claude users can instead consume the skills as a native plugin from the `adobe/data` marketplace — no npm needed.
+Claude Code does not scan `.agents/`; it consumes the skills as a native plugin from the `adobe/data` marketplace — no npm needed.
 
 Interactive:
 

package/bin/cli.mjs

@@ -1,16 +1,18 @@
 #!/usr/bin/env node
-// Installer for the @adobe/data-ai skill bundle.
+// Installer for the @adobe/data-ai skill bundle (Cursor / Codex / .agents-standard agents).
 //
-// Copies the flat SKILL.md folders shipped in this package into whichever
-// agent-skill roots the consuming project scans, so the same authored-once
-// bundle works across Claude Code, Cursor, and Codex:
+// Copies the SKILL.md folders shipped in this package into a single namespaced
+// bundle directory that agents which recurse `.agents/skills/` will discover:
 //
-//   .claude/skills/<name>/   Claude Code   (no recursion — flat is required)
-//   .agents/skills/<name>/   Cursor, Codex (tool-neutral, future agents)
+//   .agents/skills/adobe-data-ai/<name>/SKILL.md
 //
-// The copy is durable and committable; re-run to refresh to a new version.
-// Ownership is tracked per root in a `.data-ai.json` manifest so re-runs
-// prune skills this package no longer ships without touching skills you added.
+// We own the `adobe-data-ai/` directory outright, so a refresh is a clean
+// wipe-and-recopy — it never touches skills you authored elsewhere.
+//
+// Claude Code is intentionally NOT a target: it does not scan `.agents/`, and
+// copying into `.claude/skills/` could collide with a user's own skills.
+// Claude consumes these as the `adobe-data-ai` marketplace plugin instead
+// (see README).
 
 import {
     cpSync,
@@ -31,11 +33,8 @@ const skillsSrc = join(pkgRoot, "skills");
 const pkg = JSON.parse(readFileSync(join(pkgRoot, "package.json"), "utf8"));
 const { name: PKG_NAME, version: VERSION } = pkg;
 
-// Each target agent's skills root, relative to a base directory.
-const ROOTS = {
-    claude: (base) => join(base, ".claude", "skills"),
-    agents: (base) => join(base, ".agents", "skills"),
-};
+// Namespaced bundle folder — the whole directory belongs to this package.
+const BUNDLE = "adobe-data-ai";
 
 function discoverSkills() {
     if (!existsSync(skillsSrc)) return [];
@@ -45,32 +44,15 @@ function discoverSkills() {
         .sort();
 }
 
-function installTo(rootDir, skills) {
-    mkdirSync(rootDir, { recursive: true });
-    const manifestPath = join(rootDir, ".data-ai.json");
-
-    // Prune skills we previously owned but no longer ship.
-    if (existsSync(manifestPath)) {
-        try {
-            const prev = JSON.parse(readFileSync(manifestPath, "utf8"));
-            for (const name of prev.skills ?? []) {
-                if (!skills.includes(name) && existsSync(join(rootDir, name))) {
-                    rmSync(join(rootDir, name), { recursive: true, force: true });
-                }
-            }
-        } catch {
-            // Unreadable manifest — ignore and re-stamp below.
-        }
-    }
-
+function installTo(bundleDir, skills) {
+    // We own this directory — wipe and recopy for a clean refresh.
+    rmSync(bundleDir, { recursive: true, force: true });
+    mkdirSync(bundleDir, { recursive: true });
     for (const name of skills) {
-        const dest = join(rootDir, name);
-        rmSync(dest, { recursive: true, force: true });
-        cpSync(join(skillsSrc, name), dest, { recursive: true });
+        cpSync(join(skillsSrc, name), join(bundleDir, name), { recursive: true });
     }
-
     writeFileSync(
-        manifestPath,
+        join(bundleDir, ".data-ai.json"),
         JSON.stringify({ package: PKG_NAME, version: VERSION, skills }, null, 2) + "\n",
     );
 }
@@ -81,8 +63,6 @@ function parseArgs(argv) {
     let dir = null;
     for (const a of argv) {
         if (a === "--global" || a === "-g") flags.add("global");
-        else if (a === "--claude") flags.add("claude");
-        else if (a === "--agents" || a === "--cursor") flags.add("agents");
         else if (a === "--help" || a === "-h") flags.add("help");
         else if (a.startsWith("--dir=")) dir = a.slice("--dir=".length);
         else if (!a.startsWith("-")) positional.push(a);
@@ -92,26 +72,22 @@ function parseArgs(argv) {
 
 const HELP = `${PKG_NAME} v${VERSION}
 
-Install cross-agent architecture skills into the current project.
+Install the architecture-skill bundle for Cursor, Codex, and other agents
+that scan .agents/skills/. (Claude Code uses the marketplace plugin instead.)
 
 Usage:
   npx ${PKG_NAME}@latest install [options]
   npx ${PKG_NAME}@latest list
 
 Commands:
-  install   Copy skills into the project's agent-skill roots (default).
+  install   Copy skills into .agents/skills/${BUNDLE}/ (default).
   list      Print the skills bundled in this package.
 
 Options:
-  --claude        Install only into .claude/skills/
-  --agents        Install only into .agents/skills/ (Cursor, Codex)
-  --cursor        Alias for --agents
-  --global, -g    Install into your home directory (~/.claude, ~/.agents)
+  --global, -g    Install into your home directory (~/.agents/skills/${BUNDLE}/)
                   instead of the current project.
   --dir=<path>    Base directory to install into (default: cwd).
   --help, -h      Show this help.
-
-With no target flag, installs into both .claude/skills and .agents/skills.
 `;
 
 function main() {
@@ -143,18 +119,12 @@ function main() {
     }
 
     const base = flags.has("global") ? homedir() : dir ? resolve(dir) : process.cwd();
+    const bundleDir = join(base, ".agents", "skills", BUNDLE);
 
-    const chosen = [];
-    if (flags.has("claude")) chosen.push("claude");
-    if (flags.has("agents")) chosen.push("agents");
-    if (chosen.length === 0) chosen.push("claude", "agents");
+    installTo(bundleDir, skills);
 
-    process.stdout.write(`Installing ${skills.length} skill(s) from ${PKG_NAME} v${VERSION}\n`);
-    for (const key of chosen) {
-        const rootDir = ROOTS[key](base);
-        installTo(rootDir, skills);
-        process.stdout.write(`  ${rootDir}\n`);
-    }
+    process.stdout.write(`Installed ${skills.length} skill(s) from ${PKG_NAME} v${VERSION}\n`);
+    process.stdout.write(`  ${bundleDir}\n`);
     process.stdout.write(`Skills: ${skills.join(", ")}\n`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-ai",
-  "version": "0.9.74",
+  "version": "0.9.76",
   "description": "Cross-agent architecture skills for @adobe/data — installable as a Claude Code plugin or copied into any Agent-Skills-compatible agent (Cursor, Codex).",
   "type": "module",
   "private": false,