@adobe/data-ai 0.9.74

package/.claude-plugin/plugin.json

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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Adobe, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# @adobe/data-ai
+
+Cross-agent architecture skills for [`@adobe/data`](https://www.npmjs.com/package/@adobe/data). One skill bundle, authored once, distributed two ways.
+
+Skills version in lockstep with the library: `@adobe/data-ai@x.y.z` describes `@adobe/data@x.y.z`.
+
+## Install (any agent)
+
+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.
+
+```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. |
+
+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
+```
+
+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.
+
+Interactive:
+
+```
+/plugin marketplace add adobe/data
+/plugin install adobe-data-ai@adobe-data-skills
+```
+
+Or declaratively, so collaborators are prompted to auto-install on next launch — commit to your repo's `.claude/settings.json`:
+
+```json
+{
+  "extraKnownMarketplaces": {
+    "adobe-data-skills": {
+      "source": { "source": "github", "repo": "adobe/data" }
+    }
+  },
+  "enabledPlugins": {
+    "adobe-data-ai@adobe-data-skills": true
+  }
+}
+```
+
+The plugin cache is version-hashed and garbage-collected, so it is not a stable path to symlink against — prefer the `npx … install` copy model when you need a durable, cross-agent artifact.
+
+---
+
+# Pragmatic Programming
+
+## Target Audience
+
+Software engineers who want to build high quality applications with a sustainable velocity.
+
+## Goals
+
+The goal of effective software engineers is to generate a high rate of value per unit time.
+
+    rate = value / time
+
+We can improve the rate by either increasing value or decreasing time.
+
+- Quality: Write better applications. ▲value
+- Velocity: Write applications faster. ▼time
+
+### Code Priorities
+
+1. Correct: Does the job. This one is non-negotiable.
+2. Clear: Easily understood by both humans and AI.
+3. Changeable: Quickly and safely modified or extended.
+
+There is occasionally some tension between clarity and changeability. More abstraction or generic parameters may make things more changeable at the cost of some clarity.
+
+### Code Challenges
+
+- Complexity: Undermines every single one of our code priorities.
+
+Complexity is the limiting factor which defines the upper limit on how sophisticated of an application we are able to create and maintain at a practical velocity.
+
+The difficulty of dealing with complexity tends to increase at a greater than linear rate, especially once the short term context window of a human or ai agent is exceeded.
+
+### General Principles
+
+- Separation of Concerns: If two concerns can be separated then do it.
+- Avoid mutation: Immutable values are easier to reason about.
+- Use Small files: Aim for less than 200 loc. Decompose if > 500 loc.
+- Single concern per file: Export only a single declaration per file.
+- Avoid object oriented classes: Combines data concerns with functions.
+- Distinguish services from data: Services do things, data stores things.
+- Use static typing: Finds errors earlier and guides both AI and humans.
+- Avoid side effects: Pure functions are easier to comprehend and test.

package/bin/cli.mjs

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+// Installer for the @adobe/data-ai skill bundle.
+//
+// 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:
+//
+//   .claude/skills/<name>/   Claude Code   (no recursion — flat is required)
+//   .agents/skills/<name>/   Cursor, Codex (tool-neutral, future agents)
+//
+// 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.
+
+import {
+    cpSync,
+    existsSync,
+    mkdirSync,
+    readFileSync,
+    readdirSync,
+    rmSync,
+    writeFileSync,
+} from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = resolve(here, "..");
+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"),
+};
+
+function discoverSkills() {
+    if (!existsSync(skillsSrc)) return [];
+    return readdirSync(skillsSrc, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && existsSync(join(skillsSrc, d.name, "SKILL.md")))
+        .map((d) => d.name)
+        .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.
+        }
+    }
+
+    for (const name of skills) {
+        const dest = join(rootDir, name);
+        rmSync(dest, { recursive: true, force: true });
+        cpSync(join(skillsSrc, name), dest, { recursive: true });
+    }
+
+    writeFileSync(
+        manifestPath,
+        JSON.stringify({ package: PKG_NAME, version: VERSION, skills }, null, 2) + "\n",
+    );
+}
+
+function parseArgs(argv) {
+    const positional = [];
+    const flags = new Set();
+    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);
+    }
+    return { cmd: positional[0] ?? "install", flags, dir };
+}
+
+const HELP = `${PKG_NAME} v${VERSION}
+
+Install cross-agent architecture skills into the current project.
+
+Usage:
+  npx ${PKG_NAME}@latest install [options]
+  npx ${PKG_NAME}@latest list
+
+Commands:
+  install   Copy skills into the project's agent-skill roots (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)
+                  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() {
+    const { cmd, flags, dir } = parseArgs(process.argv.slice(2));
+
+    if (flags.has("help") || cmd === "help") {
+        process.stdout.write(HELP);
+        return;
+    }
+
+    const skills = discoverSkills();
+
+    if (cmd === "list") {
+        process.stdout.write(`${PKG_NAME} v${VERSION} bundles ${skills.length} skill(s):\n`);
+        for (const s of skills) process.stdout.write(`  - ${s}\n`);
+        return;
+    }
+
+    if (cmd !== "install") {
+        process.stderr.write(`Unknown command: ${cmd}\n\n${HELP}`);
+        process.exitCode = 1;
+        return;
+    }
+
+    if (skills.length === 0) {
+        process.stderr.write(`No skills found in ${skillsSrc}\n`);
+        process.exitCode = 1;
+        return;
+    }
+
+    const base = flags.has("global") ? homedir() : dir ? resolve(dir) : process.cwd();
+
+    const chosen = [];
+    if (flags.has("claude")) chosen.push("claude");
+    if (flags.has("agents")) chosen.push("agents");
+    if (chosen.length === 0) chosen.push("claude", "agents");
+
+    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(`Skills: ${skills.join(", ")}\n`);
+}
+
+main();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@adobe/data-ai",
+  "version": "0.9.74",
+  "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,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "bin": {
+    "data-ai": "bin/cli.mjs"
+  },
+  "files": [
+    "skills",
+    "bin",
+    ".claude-plugin",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "adobe",
+    "data",
+    "agent-skills",
+    "claude-code",
+    "cursor",
+    "codex",
+    "skills"
+  ],
+  "devDependencies": {
+    "vitest": "^1.6.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "cp ../../LICENSE .",
+    "test": "vitest --run --passWithNoTests",
+    "publish-public": "pnpm build && pnpm publish --no-git-checks --access public"
+  }
+}

package/skills/bar/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: bar
+description: Sample skill that greets bar. Placeholder demonstrating the @adobe/data-ai skill-bundle wiring; replace with a real architecture skill.
+---
+
+# bar
+
+Say "hello bar".

package/skills/foo/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: foo
+description: Sample skill that greets foo. Placeholder demonstrating the @adobe/data-ai skill-bundle wiring; replace with a real architecture skill.
+---
+
+# foo
+
+Say "hello foo".