@directive-run/claude-plugin 1.16.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "directive",
+  "version": "0.1.0",
+  "description": "Coding guidance for Directive — the constraint-driven TypeScript runtime. 12 skills covering modules, constraints, systems, testing, AI orchestrators, agents, guardrails, code review, scaffolding, and migration from Redux/Zustand/XState.",
+  "skills_dir": "../skills"
+}

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 Sizls ∞ Jason Comes
+
+This project is dual-licensed under MIT OR Apache-2.0. You may choose
+either license. See LICENSE-APACHE for the Apache License, Version 2.0.
+
+---
+
+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,113 @@
+# `@directive-run/claude-plugin`
+
+Claude Code plugin providing coding guidance for the [Directive](https://directive.run) runtime. Delivers 12 skills that Claude automatically invokes when you're working with Directive code.
+
+The package has two install paths: **Claude Code's plugin marketplace** for end users (the canonical path), and **npm** for tool authors who want to consume the skill bundles programmatically.
+
+## Install for Claude Code (canonical)
+
+Two steps in a Claude Code session — first register the marketplace, then install the plugin:
+
+```
+/plugin marketplace add directive-run/directive
+/plugin install directive@directive-plugins
+```
+
+After install, verify the plugin is active with `/plugins` — you should see `directive` in the list.
+
+## Install for tool authors (npm)
+
+```bash
+npm install @directive-run/claude-plugin
+```
+
+The npm package ships the pre-built `skills/` directory and exposes it through a small programmatic API. Use this when you're building a custom skill registry, doc-generation pipeline, evals harness, or AI orchestrator that wants to expose Directive skills via its own routing layer.
+
+```typescript
+import {
+  listSkills,
+  getSkill,
+  getAllSkills,
+  getSkillFile,
+  type Skill,
+} from "@directive-run/claude-plugin";
+
+// All skill names, alphabetical
+const names = listSkills();
+// → ["building-ai-agents", "building-ai-orchestrators", ...]
+
+// One skill — manifest + supporting files
+const skill = getSkill("building-ai-orchestrators");
+skill?.manifest;            // SKILL.md (with YAML frontmatter)
+skill?.files.get("examples"); // examples.md contents
+
+// All skills, keyed by name
+const all = getAllSkills(); // Map<string, Skill>
+
+// One supporting file
+const ex = getSkillFile("building-ai-orchestrators", "examples");
+```
+
+The npm install path is not a replacement for the Claude Code plugin install — it does not register the skills with Claude Code itself. It only exposes the same `skills/` directory as a typed module so other tools can read it.
+
+## What happens after install
+
+Skills are **model-invoked**: Claude reads each skill's description and automatically loads the relevant skill when your task matches. There is nothing to invoke manually. You write code, Claude pulls in the right skill.
+
+Each of the 12 skills bundles:
+
+- A concise `SKILL.md` with a decision tree and quick-reference patterns
+- Supporting knowledge `.md` files copied from [`@directive-run/knowledge`](../knowledge)
+- Working code examples extracted from the [`examples/`](../../examples) directory
+
+When Claude invokes a skill, the skill name appears in the response (`/<plugin>:<skill>` namespaced). You can also call a skill directly:
+
+```
+/directive:writing-directive-modules
+/directive:writing-directive-constraints
+/directive:hardening-ai-systems
+```
+
+## Skills
+
+| Skill | Description |
+|-------|-------------|
+| `getting-started-with-directive` | Understand Directive fundamentals and mental model |
+| `writing-directive-modules` | Write modules with correct schema, type builders, naming |
+| `writing-directive-constraints` | Write constraints and resolvers with error boundaries |
+| `building-directive-systems` | Build multi-module systems with plugins and React |
+| `testing-directive-code` | Test with createTestSystem, mockResolver, time-travel |
+| `building-ai-orchestrators` | Build single and multi-agent AI orchestrators |
+| `building-ai-agents` | Create agents with streaming, adapters, communication |
+| `hardening-ai-systems` | Add guardrails, budgets, security to AI systems |
+| `testing-ai-systems` | Test AI systems with mock runners and evaluations |
+| `reviewing-directive-code` | Review code for anti-patterns and naming violations |
+| `scaffolding-directive-modules` | Generate module scaffolds with matching test files |
+| `migrating-to-directive` | Migrate from Redux, Zustand, XState, MobX to Directive |
+
+## Development
+
+```bash
+# Build skills from knowledge package
+pnpm --filter @directive-run/claude-plugin build
+
+# Run tests
+pnpm --filter @directive-run/claude-plugin test
+
+# Test locally with Claude Code
+claude --plugin-dir packages/claude-plugin
+```
+
+Skills are built from `@directive-run/knowledge` + hand-authored templates in `templates/`. The build script (`scripts/build-skills.ts`) assembles the `skills/` directories.
+
+## Not using Claude Code?
+
+The same knowledge ships through [`@directive-run/cli`](../cli) as rules files for every other AI assistant. Run it from your project:
+
+```bash
+npx directive ai-rules init
+```
+
+Generates `.cursorrules`, `.clinerules`, `copilot-instructions.md`, `windsurf.md`, OpenAI Codex `AGENTS.md`, and `CLAUDE.md` files tuned to each assistant's ingestion conventions.
+
+See [/docs/ide-integration](https://directive.run/docs/ide-integration) for the full decision tree across Claude Code, Cursor, Copilot, Windsurf, Cline, and Codex.

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var fs=require('fs'),path=require('path'),url=require('url');var _documentCurrentScript=typeof document!=='undefined'?document.currentScript:null;var L=path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))),m=path.resolve(L,"..");function M(t){let r=path.join(m,t);if(fs.existsSync(r))return r;let n=path.join(m,"..",t);return fs.existsSync(n)?n:r}var S=M("skills"),i=null;function l(){if(i)return i;let t=new Map,r;try{r=fs.readdirSync(S);}catch(n){if(n.code==="ENOENT")return i=t,t;throw n}for(let n of r){let s=path.join(S,n);if(!fs.statSync(s).isDirectory())continue;let f=path.join(s,"SKILL.md");if(!fs.existsSync(f))continue;let d=fs.readFileSync(f,"utf-8"),a=new Map;for(let o of fs.readdirSync(s)){if(!o.endsWith(".md")||o==="SKILL.md")continue;let p=o.replace(/\.md$/,"");a.set(p,fs.readFileSync(path.join(s,o),"utf-8"));}t.set(n,{name:n,manifest:d,files:a});}return i=t,t}function K(){return Array.from(l().keys()).sort()}function N(t){return l().get(t)}function _(){return new Map(l())}function v(t,r){return l().get(t)?.files.get(r)}function A(){i=null;}exports.clearCache=A;exports.getAllSkills=_;exports.getSkill=N;exports.getSkillFile=v;exports.listSkills=K;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["__dirname","dirname","fileURLToPath","PKG_ROOT","resolve","resolveAsset","name","fromDist","join","existsSync","fromSrc","SKILLS_DIR","skillCache","loadSkills","cache","entries","readdirSync","err","dir","statSync","manifestPath","manifest","readFileSync","files","file","baseName","listSkills","getSkill","getAllSkills","getSkillFile","skillName","fileName","clearCache"],"mappings":"+JAqBA,IAAMA,CAAAA,CAAYC,YAAAA,CAAQC,iBAAAA,CAAc,2PAAe,CAAC,CAAA,CAClDC,CAAAA,CAAWC,YAAAA,CAAQJ,CAAAA,CAAW,IAAI,CAAA,CAOxC,SAASK,CAAAA,CAAaC,CAAAA,CAAsB,CAC1C,IAAMC,CAAAA,CAAWC,SAAAA,CAAKL,CAAAA,CAAUG,CAAI,CAAA,CACpC,GAAIG,aAAAA,CAAWF,CAAQ,CAAA,CACrB,OAAOA,CAAAA,CAGT,IAAMG,CAAAA,CAAUF,SAAAA,CAAKL,CAAAA,CAAU,IAAA,CAAMG,CAAI,CAAA,CACzC,OAAIG,aAAAA,CAAWC,CAAO,CAAA,CACbA,EAGFH,CACT,CAEA,IAAMI,CAAAA,CAAaN,CAAAA,CAAa,QAAQ,CAAA,CAgBpCO,CAAAA,CAAwC,IAAA,CAE5C,SAASC,CAAAA,EAAiC,CACxC,GAAID,CAAAA,CACF,OAAOA,CAAAA,CAGT,IAAME,CAAAA,CAAQ,IAAI,GAAA,CACdC,CAAAA,CACJ,GAAI,CACFA,CAAAA,CAAUC,cAAAA,CAAYL,CAAU,EAClC,CAAA,MAASM,CAAAA,CAAc,CACrB,GAAKA,CAAAA,CAA8B,IAAA,GAAS,QAAA,CAC1C,OAAAL,CAAAA,CAAaE,CAAAA,CACNA,CAAAA,CAET,MAAMG,CACR,CAEA,IAAA,IAAWX,CAAAA,IAAQS,CAAAA,CAAS,CAC1B,IAAMG,CAAAA,CAAMV,SAAAA,CAAKG,CAAAA,CAAYL,CAAI,CAAA,CACjC,GAAI,CAACa,WAAAA,CAASD,CAAG,CAAA,CAAE,WAAA,EAAY,CAC7B,SAGF,IAAME,CAAAA,CAAeZ,SAAAA,CAAKU,EAAK,UAAU,CAAA,CACzC,GAAI,CAACT,aAAAA,CAAWW,CAAY,CAAA,CAC1B,SAGF,IAAMC,CAAAA,CAAWC,eAAAA,CAAaF,CAAAA,CAAc,OAAO,CAAA,CAC7CG,CAAAA,CAAQ,IAAI,GAAA,CAClB,IAAA,IAAWC,CAAAA,IAAQR,cAAAA,CAAYE,CAAG,CAAA,CAAG,CACnC,GAAI,CAACM,CAAAA,CAAK,QAAA,CAAS,KAAK,CAAA,EAAKA,CAAAA,GAAS,UAAA,CACpC,SAEF,IAAMC,CAAAA,CAAWD,CAAAA,CAAK,OAAA,CAAQ,OAAA,CAAS,EAAE,CAAA,CACzCD,CAAAA,CAAM,GAAA,CAAIE,CAAAA,CAAUH,eAAAA,CAAad,SAAAA,CAAKU,CAAAA,CAAKM,CAAI,CAAA,CAAG,OAAO,CAAC,EAC5D,CAEAV,CAAAA,CAAM,GAAA,CAAIR,CAAAA,CAAM,CAAE,IAAA,CAAAA,CAAAA,CAAM,QAAA,CAAAe,CAAAA,CAAU,KAAA,CAAAE,CAAM,CAAC,EAC3C,CAEA,OAAAX,CAAAA,CAAaE,CAAAA,CACNA,CACT,CAOO,SAASY,CAAAA,EAAuB,CACrC,OAAO,KAAA,CAAM,IAAA,CAAKb,CAAAA,EAAW,CAAE,IAAA,EAAM,CAAA,CAAE,IAAA,EACzC,CAQO,SAASc,CAAAA,CAASrB,CAAAA,CAAiC,CACxD,OAAOO,CAAAA,EAAW,CAAE,GAAA,CAAIP,CAAI,CAC9B,CAQO,SAASsB,CAAAA,EAAmC,CACjD,OAAO,IAAI,GAAA,CAAIf,CAAAA,EAAY,CAC7B,CAWO,SAASgB,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACoB,CACpB,OAAOlB,CAAAA,EAAW,CAAE,GAAA,CAAIiB,CAAS,CAAA,EAAG,KAAA,CAAM,GAAA,CAAIC,CAAQ,CACxD,CAMO,SAASC,CAAAA,EAAmB,CACjCpB,CAAAA,CAAa,KACf","file":"index.cjs","sourcesContent":["/**\n * Programmatic API for `@directive-run/claude-plugin`.\n *\n * The canonical install path for end users is Claude Code's plugin\n * marketplace (`/plugin marketplace add directive-run/directive`\n * then `/plugin install directive@directive-plugins`). This module\n * is the alternative install path for tool authors who want to\n * consume the skill bundles programmatically — custom skill\n * registries, doc-generation pipelines, eval harnesses, or AI\n * orchestrators that want to expose Directive skills via their own\n * routing layer.\n *\n * The package ships the pre-built skill bundles in `skills/`. This\n * module exposes them as functions: list the skills, read a SKILL.md,\n * read a supporting knowledge file, or grab the whole skill tree.\n */\n\nimport { existsSync, readFileSync, readdirSync, statSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst PKG_ROOT = resolve(__dirname, \"..\");\n\n/**\n * Resolve a path relative to the package root. Tries the published\n * layout (`dist/` sibling of `skills/`) first, then the dev layout\n * (running from `src/` in the monorepo).\n */\nfunction resolveAsset(name: string): string {\n  const fromDist = join(PKG_ROOT, name);\n  if (existsSync(fromDist)) {\n    return fromDist;\n  }\n\n  const fromSrc = join(PKG_ROOT, \"..\", name);\n  if (existsSync(fromSrc)) {\n    return fromSrc;\n  }\n\n  return fromDist;\n}\n\nconst SKILLS_DIR = resolveAsset(\"skills\");\n\n/**\n * One bundled skill — the `SKILL.md` plus its supporting knowledge\n * files (which are copied in from `@directive-run/knowledge` at\n * build time) and the auto-generated `examples.md` when present.\n */\nexport interface Skill {\n  /** Skill name (matches the directory under `skills/`). */\n  name: string;\n  /** Full `SKILL.md` contents — the Claude-facing skill manifest. */\n  manifest: string;\n  /** Supporting files keyed by base name (no `.md` suffix). */\n  files: Map<string, string>;\n}\n\nlet skillCache: Map<string, Skill> | null = null;\n\nfunction loadSkills(): Map<string, Skill> {\n  if (skillCache) {\n    return skillCache;\n  }\n\n  const cache = new Map<string, Skill>();\n  let entries: string[];\n  try {\n    entries = readdirSync(SKILLS_DIR);\n  } catch (err: unknown) {\n    if ((err as NodeJS.ErrnoException).code === \"ENOENT\") {\n      skillCache = cache;\n      return cache;\n    }\n    throw err;\n  }\n\n  for (const name of entries) {\n    const dir = join(SKILLS_DIR, name);\n    if (!statSync(dir).isDirectory()) {\n      continue;\n    }\n\n    const manifestPath = join(dir, \"SKILL.md\");\n    if (!existsSync(manifestPath)) {\n      continue;\n    }\n\n    const manifest = readFileSync(manifestPath, \"utf-8\");\n    const files = new Map<string, string>();\n    for (const file of readdirSync(dir)) {\n      if (!file.endsWith(\".md\") || file === \"SKILL.md\") {\n        continue;\n      }\n      const baseName = file.replace(/\\.md$/, \"\");\n      files.set(baseName, readFileSync(join(dir, file), \"utf-8\"));\n    }\n\n    cache.set(name, { name, manifest, files });\n  }\n\n  skillCache = cache;\n  return cache;\n}\n\n/**\n * List the names of every bundled skill.\n *\n * Returns an alphabetically-sorted array — stable for snapshot tests.\n */\nexport function listSkills(): string[] {\n  return Array.from(loadSkills().keys()).sort();\n}\n\n/**\n * Get a single skill by name.\n *\n * @param name - Skill name (e.g. `\"writing-directive-modules\"`).\n * @returns The skill, or `undefined` if no skill by that name exists.\n */\nexport function getSkill(name: string): Skill | undefined {\n  return loadSkills().get(name);\n}\n\n/**\n * Get every bundled skill, keyed by name.\n *\n * Returns a defensive copy — mutating the returned Map won't affect\n * subsequent calls.\n */\nexport function getAllSkills(): Map<string, Skill> {\n  return new Map(loadSkills());\n}\n\n/**\n * Read one supporting file from a skill bundle.\n *\n * @param skillName - Skill name (e.g. `\"writing-directive-modules\"`).\n * @param fileName - Supporting file base name without `.md`\n *   (e.g. `\"core-patterns\"`, `\"anti-patterns\"`, `\"examples\"`).\n * @returns File contents, or `undefined` if the skill or file is not\n *   present.\n */\nexport function getSkillFile(\n  skillName: string,\n  fileName: string,\n): string | undefined {\n  return loadSkills().get(skillName)?.files.get(fileName);\n}\n\n/**\n * Clear the in-memory skill cache. Useful in tests or watch-mode\n * tooling that regenerates the `skills/` directory between calls.\n */\nexport function clearCache(): void {\n  skillCache = null;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,66 @@
+/**
+ * Programmatic API for `@directive-run/claude-plugin`.
+ *
+ * The canonical install path for end users is Claude Code's plugin
+ * marketplace (`/plugin marketplace add directive-run/directive`
+ * then `/plugin install directive@directive-plugins`). This module
+ * is the alternative install path for tool authors who want to
+ * consume the skill bundles programmatically — custom skill
+ * registries, doc-generation pipelines, eval harnesses, or AI
+ * orchestrators that want to expose Directive skills via their own
+ * routing layer.
+ *
+ * The package ships the pre-built skill bundles in `skills/`. This
+ * module exposes them as functions: list the skills, read a SKILL.md,
+ * read a supporting knowledge file, or grab the whole skill tree.
+ */
+/**
+ * One bundled skill — the `SKILL.md` plus its supporting knowledge
+ * files (which are copied in from `@directive-run/knowledge` at
+ * build time) and the auto-generated `examples.md` when present.
+ */
+interface Skill {
+    /** Skill name (matches the directory under `skills/`). */
+    name: string;
+    /** Full `SKILL.md` contents — the Claude-facing skill manifest. */
+    manifest: string;
+    /** Supporting files keyed by base name (no `.md` suffix). */
+    files: Map<string, string>;
+}
+/**
+ * List the names of every bundled skill.
+ *
+ * Returns an alphabetically-sorted array — stable for snapshot tests.
+ */
+declare function listSkills(): string[];
+/**
+ * Get a single skill by name.
+ *
+ * @param name - Skill name (e.g. `"writing-directive-modules"`).
+ * @returns The skill, or `undefined` if no skill by that name exists.
+ */
+declare function getSkill(name: string): Skill | undefined;
+/**
+ * Get every bundled skill, keyed by name.
+ *
+ * Returns a defensive copy — mutating the returned Map won't affect
+ * subsequent calls.
+ */
+declare function getAllSkills(): Map<string, Skill>;
+/**
+ * Read one supporting file from a skill bundle.
+ *
+ * @param skillName - Skill name (e.g. `"writing-directive-modules"`).
+ * @param fileName - Supporting file base name without `.md`
+ *   (e.g. `"core-patterns"`, `"anti-patterns"`, `"examples"`).
+ * @returns File contents, or `undefined` if the skill or file is not
+ *   present.
+ */
+declare function getSkillFile(skillName: string, fileName: string): string | undefined;
+/**
+ * Clear the in-memory skill cache. Useful in tests or watch-mode
+ * tooling that regenerates the `skills/` directory between calls.
+ */
+declare function clearCache(): void;
+
+export { type Skill, clearCache, getAllSkills, getSkill, getSkillFile, listSkills };

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Programmatic API for `@directive-run/claude-plugin`.
+ *
+ * The canonical install path for end users is Claude Code's plugin
+ * marketplace (`/plugin marketplace add directive-run/directive`
+ * then `/plugin install directive@directive-plugins`). This module
+ * is the alternative install path for tool authors who want to
+ * consume the skill bundles programmatically — custom skill
+ * registries, doc-generation pipelines, eval harnesses, or AI
+ * orchestrators that want to expose Directive skills via their own
+ * routing layer.
+ *
+ * The package ships the pre-built skill bundles in `skills/`. This
+ * module exposes them as functions: list the skills, read a SKILL.md,
+ * read a supporting knowledge file, or grab the whole skill tree.
+ */
+/**
+ * One bundled skill — the `SKILL.md` plus its supporting knowledge
+ * files (which are copied in from `@directive-run/knowledge` at
+ * build time) and the auto-generated `examples.md` when present.
+ */
+interface Skill {
+    /** Skill name (matches the directory under `skills/`). */
+    name: string;
+    /** Full `SKILL.md` contents — the Claude-facing skill manifest. */
+    manifest: string;
+    /** Supporting files keyed by base name (no `.md` suffix). */
+    files: Map<string, string>;
+}
+/**
+ * List the names of every bundled skill.
+ *
+ * Returns an alphabetically-sorted array — stable for snapshot tests.
+ */
+declare function listSkills(): string[];
+/**
+ * Get a single skill by name.
+ *
+ * @param name - Skill name (e.g. `"writing-directive-modules"`).
+ * @returns The skill, or `undefined` if no skill by that name exists.
+ */
+declare function getSkill(name: string): Skill | undefined;
+/**
+ * Get every bundled skill, keyed by name.
+ *
+ * Returns a defensive copy — mutating the returned Map won't affect
+ * subsequent calls.
+ */
+declare function getAllSkills(): Map<string, Skill>;
+/**
+ * Read one supporting file from a skill bundle.
+ *
+ * @param skillName - Skill name (e.g. `"writing-directive-modules"`).
+ * @param fileName - Supporting file base name without `.md`
+ *   (e.g. `"core-patterns"`, `"anti-patterns"`, `"examples"`).
+ * @returns File contents, or `undefined` if the skill or file is not
+ *   present.
+ */
+declare function getSkillFile(skillName: string, fileName: string): string | undefined;
+/**
+ * Clear the in-memory skill cache. Useful in tests or watch-mode
+ * tooling that regenerates the `skills/` directory between calls.
+ */
+declare function clearCache(): void;
+
+export { type Skill, clearCache, getAllSkills, getSkill, getSkillFile, listSkills };

package/dist/index.js

@@ -0,0 +1,2 @@
+import {existsSync,readdirSync,statSync,readFileSync}from'fs';import {dirname,resolve,join}from'path';import {fileURLToPath}from'url';var L=dirname(fileURLToPath(import.meta.url)),m=resolve(L,"..");function M(t){let r=join(m,t);if(existsSync(r))return r;let n=join(m,"..",t);return existsSync(n)?n:r}var S=M("skills"),i=null;function l(){if(i)return i;let t=new Map,r;try{r=readdirSync(S);}catch(n){if(n.code==="ENOENT")return i=t,t;throw n}for(let n of r){let s=join(S,n);if(!statSync(s).isDirectory())continue;let f=join(s,"SKILL.md");if(!existsSync(f))continue;let d=readFileSync(f,"utf-8"),a=new Map;for(let o of readdirSync(s)){if(!o.endsWith(".md")||o==="SKILL.md")continue;let p=o.replace(/\.md$/,"");a.set(p,readFileSync(join(s,o),"utf-8"));}t.set(n,{name:n,manifest:d,files:a});}return i=t,t}function K(){return Array.from(l().keys()).sort()}function N(t){return l().get(t)}function _(){return new Map(l())}function v(t,r){return l().get(t)?.files.get(r)}function A(){i=null;}export{A as clearCache,_ as getAllSkills,N as getSkill,v as getSkillFile,K as listSkills};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["__dirname","dirname","fileURLToPath","PKG_ROOT","resolve","resolveAsset","name","fromDist","join","existsSync","fromSrc","SKILLS_DIR","skillCache","loadSkills","cache","entries","readdirSync","err","dir","statSync","manifestPath","manifest","readFileSync","files","file","baseName","listSkills","getSkill","getAllSkills","getSkillFile","skillName","fileName","clearCache"],"mappings":"sIAqBA,IAAMA,CAAAA,CAAYC,OAAAA,CAAQC,aAAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA,CAClDC,CAAAA,CAAWC,OAAAA,CAAQJ,CAAAA,CAAW,IAAI,CAAA,CAOxC,SAASK,CAAAA,CAAaC,CAAAA,CAAsB,CAC1C,IAAMC,CAAAA,CAAWC,IAAAA,CAAKL,CAAAA,CAAUG,CAAI,CAAA,CACpC,GAAIG,UAAAA,CAAWF,CAAQ,CAAA,CACrB,OAAOA,CAAAA,CAGT,IAAMG,CAAAA,CAAUF,IAAAA,CAAKL,CAAAA,CAAU,IAAA,CAAMG,CAAI,CAAA,CACzC,OAAIG,UAAAA,CAAWC,CAAO,CAAA,CACbA,EAGFH,CACT,CAEA,IAAMI,CAAAA,CAAaN,CAAAA,CAAa,QAAQ,CAAA,CAgBpCO,CAAAA,CAAwC,IAAA,CAE5C,SAASC,CAAAA,EAAiC,CACxC,GAAID,CAAAA,CACF,OAAOA,CAAAA,CAGT,IAAME,CAAAA,CAAQ,IAAI,GAAA,CACdC,CAAAA,CACJ,GAAI,CACFA,CAAAA,CAAUC,WAAAA,CAAYL,CAAU,EAClC,CAAA,MAASM,CAAAA,CAAc,CACrB,GAAKA,CAAAA,CAA8B,IAAA,GAAS,QAAA,CAC1C,OAAAL,CAAAA,CAAaE,CAAAA,CACNA,CAAAA,CAET,MAAMG,CACR,CAEA,IAAA,IAAWX,CAAAA,IAAQS,CAAAA,CAAS,CAC1B,IAAMG,CAAAA,CAAMV,IAAAA,CAAKG,CAAAA,CAAYL,CAAI,CAAA,CACjC,GAAI,CAACa,QAAAA,CAASD,CAAG,CAAA,CAAE,WAAA,EAAY,CAC7B,SAGF,IAAME,CAAAA,CAAeZ,IAAAA,CAAKU,EAAK,UAAU,CAAA,CACzC,GAAI,CAACT,UAAAA,CAAWW,CAAY,CAAA,CAC1B,SAGF,IAAMC,CAAAA,CAAWC,YAAAA,CAAaF,CAAAA,CAAc,OAAO,CAAA,CAC7CG,CAAAA,CAAQ,IAAI,GAAA,CAClB,IAAA,IAAWC,CAAAA,IAAQR,WAAAA,CAAYE,CAAG,CAAA,CAAG,CACnC,GAAI,CAACM,CAAAA,CAAK,QAAA,CAAS,KAAK,CAAA,EAAKA,CAAAA,GAAS,UAAA,CACpC,SAEF,IAAMC,CAAAA,CAAWD,CAAAA,CAAK,OAAA,CAAQ,OAAA,CAAS,EAAE,CAAA,CACzCD,CAAAA,CAAM,GAAA,CAAIE,CAAAA,CAAUH,YAAAA,CAAad,IAAAA,CAAKU,CAAAA,CAAKM,CAAI,CAAA,CAAG,OAAO,CAAC,EAC5D,CAEAV,CAAAA,CAAM,GAAA,CAAIR,CAAAA,CAAM,CAAE,IAAA,CAAAA,CAAAA,CAAM,QAAA,CAAAe,CAAAA,CAAU,KAAA,CAAAE,CAAM,CAAC,EAC3C,CAEA,OAAAX,CAAAA,CAAaE,CAAAA,CACNA,CACT,CAOO,SAASY,CAAAA,EAAuB,CACrC,OAAO,KAAA,CAAM,IAAA,CAAKb,CAAAA,EAAW,CAAE,IAAA,EAAM,CAAA,CAAE,IAAA,EACzC,CAQO,SAASc,CAAAA,CAASrB,CAAAA,CAAiC,CACxD,OAAOO,CAAAA,EAAW,CAAE,GAAA,CAAIP,CAAI,CAC9B,CAQO,SAASsB,CAAAA,EAAmC,CACjD,OAAO,IAAI,GAAA,CAAIf,CAAAA,EAAY,CAC7B,CAWO,SAASgB,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACoB,CACpB,OAAOlB,CAAAA,EAAW,CAAE,GAAA,CAAIiB,CAAS,CAAA,EAAG,KAAA,CAAM,GAAA,CAAIC,CAAQ,CACxD,CAMO,SAASC,CAAAA,EAAmB,CACjCpB,CAAAA,CAAa,KACf","file":"index.js","sourcesContent":["/**\n * Programmatic API for `@directive-run/claude-plugin`.\n *\n * The canonical install path for end users is Claude Code's plugin\n * marketplace (`/plugin marketplace add directive-run/directive`\n * then `/plugin install directive@directive-plugins`). This module\n * is the alternative install path for tool authors who want to\n * consume the skill bundles programmatically — custom skill\n * registries, doc-generation pipelines, eval harnesses, or AI\n * orchestrators that want to expose Directive skills via their own\n * routing layer.\n *\n * The package ships the pre-built skill bundles in `skills/`. This\n * module exposes them as functions: list the skills, read a SKILL.md,\n * read a supporting knowledge file, or grab the whole skill tree.\n */\n\nimport { existsSync, readFileSync, readdirSync, statSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst PKG_ROOT = resolve(__dirname, \"..\");\n\n/**\n * Resolve a path relative to the package root. Tries the published\n * layout (`dist/` sibling of `skills/`) first, then the dev layout\n * (running from `src/` in the monorepo).\n */\nfunction resolveAsset(name: string): string {\n  const fromDist = join(PKG_ROOT, name);\n  if (existsSync(fromDist)) {\n    return fromDist;\n  }\n\n  const fromSrc = join(PKG_ROOT, \"..\", name);\n  if (existsSync(fromSrc)) {\n    return fromSrc;\n  }\n\n  return fromDist;\n}\n\nconst SKILLS_DIR = resolveAsset(\"skills\");\n\n/**\n * One bundled skill — the `SKILL.md` plus its supporting knowledge\n * files (which are copied in from `@directive-run/knowledge` at\n * build time) and the auto-generated `examples.md` when present.\n */\nexport interface Skill {\n  /** Skill name (matches the directory under `skills/`). */\n  name: string;\n  /** Full `SKILL.md` contents — the Claude-facing skill manifest. */\n  manifest: string;\n  /** Supporting files keyed by base name (no `.md` suffix). */\n  files: Map<string, string>;\n}\n\nlet skillCache: Map<string, Skill> | null = null;\n\nfunction loadSkills(): Map<string, Skill> {\n  if (skillCache) {\n    return skillCache;\n  }\n\n  const cache = new Map<string, Skill>();\n  let entries: string[];\n  try {\n    entries = readdirSync(SKILLS_DIR);\n  } catch (err: unknown) {\n    if ((err as NodeJS.ErrnoException).code === \"ENOENT\") {\n      skillCache = cache;\n      return cache;\n    }\n    throw err;\n  }\n\n  for (const name of entries) {\n    const dir = join(SKILLS_DIR, name);\n    if (!statSync(dir).isDirectory()) {\n      continue;\n    }\n\n    const manifestPath = join(dir, \"SKILL.md\");\n    if (!existsSync(manifestPath)) {\n      continue;\n    }\n\n    const manifest = readFileSync(manifestPath, \"utf-8\");\n    const files = new Map<string, string>();\n    for (const file of readdirSync(dir)) {\n      if (!file.endsWith(\".md\") || file === \"SKILL.md\") {\n        continue;\n      }\n      const baseName = file.replace(/\\.md$/, \"\");\n      files.set(baseName, readFileSync(join(dir, file), \"utf-8\"));\n    }\n\n    cache.set(name, { name, manifest, files });\n  }\n\n  skillCache = cache;\n  return cache;\n}\n\n/**\n * List the names of every bundled skill.\n *\n * Returns an alphabetically-sorted array — stable for snapshot tests.\n */\nexport function listSkills(): string[] {\n  return Array.from(loadSkills().keys()).sort();\n}\n\n/**\n * Get a single skill by name.\n *\n * @param name - Skill name (e.g. `\"writing-directive-modules\"`).\n * @returns The skill, or `undefined` if no skill by that name exists.\n */\nexport function getSkill(name: string): Skill | undefined {\n  return loadSkills().get(name);\n}\n\n/**\n * Get every bundled skill, keyed by name.\n *\n * Returns a defensive copy — mutating the returned Map won't affect\n * subsequent calls.\n */\nexport function getAllSkills(): Map<string, Skill> {\n  return new Map(loadSkills());\n}\n\n/**\n * Read one supporting file from a skill bundle.\n *\n * @param skillName - Skill name (e.g. `\"writing-directive-modules\"`).\n * @param fileName - Supporting file base name without `.md`\n *   (e.g. `\"core-patterns\"`, `\"anti-patterns\"`, `\"examples\"`).\n * @returns File contents, or `undefined` if the skill or file is not\n *   present.\n */\nexport function getSkillFile(\n  skillName: string,\n  fileName: string,\n): string | undefined {\n  return loadSkills().get(skillName)?.files.get(fileName);\n}\n\n/**\n * Clear the in-memory skill cache. Useful in tests or watch-mode\n * tooling that regenerates the `skills/` directory between calls.\n */\nexport function clearCache(): void {\n  skillCache = null;\n}\n"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@directive-run/claude-plugin",
+  "version": "1.16.0",
+  "description": "Claude Code plugin for Directive — 12 skills covering modules, constraints, resolvers, derivations, AI orchestration, and adapters. Installable via Claude Code's plugin marketplace or consumable programmatically as an npm package.",
+  "license": "(MIT OR Apache-2.0)",
+  "author": "Jason Comes",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/directive-run/directive",
+    "directory": "packages/claude-plugin"
+  },
+  "homepage": "https://directive.run/docs/ide-integration",
+  "bugs": {
+    "url": "https://github.com/directive-run/directive/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "directive",
+    "claude",
+    "claude-code",
+    "skills",
+    "ai-rules",
+    "plugin",
+    "agents",
+    "knowledge"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "skills",
+    ".claude-plugin"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.0",
+    "@directive-run/knowledge": "1.16.0"
+  },
+  "scripts": {
+    "build": "tsx scripts/build-skills.ts && tsup",
+    "build:skills": "tsx scripts/build-skills.ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf skills/* dist"
+  }
+}

package/skills/README.md

@@ -0,0 +1,9 @@
+# Generated – Do Not Edit
+
+This directory is auto-generated by `scripts/build-skills.ts` from templates + `@directive-run/knowledge`.
+
+To modify skills, edit files in `templates/` and rebuild:
+
+```bash
+pnpm --filter @directive-run/claude-plugin build
+```