@groupby/ai-dev 0.2.1 → 0.3.0

package/README.md

@@ -57,6 +57,7 @@ When installing a team's skills, you will be prompted to optionally include skil
 | Flag | Description |
 | --- | --- |
 | `--target <dir>` | Install into a specific directory (defaults to cwd) |
+| `--ai-dir <path>` | Override the AI skills/resources directory (defaults to `docs/ai`) |
 | `--dry-run` | Preview what would be installed without writing files |
 | `--force` | Overwrite existing files without prompting |
 | `--skip-existing` | Skip files that already exist |
@@ -65,8 +66,9 @@ When installing a team's skills, you will be prompted to optionally include skil
 
 1. **Discovery** — The CLI scans bundled `skills/` and `teams/` directories for `SKILL.md` files and reads their YAML frontmatter (name, description, etc.).
 2. **Client detection** — It checks the target project for known config directories (`.github/`, `.claude/`, `.agents/`) to determine which LLM clients are in use.
-3. **Installation** — Each selected skill is copied into `docs/ai/skills/<name>/` and a stub `SKILL.md` is generated in each client's skills directory pointing back to the full skill file.
+3. **Installation** — Each selected skill is copied into `<ai-dir>/skills/<name>/` (default: `docs/ai/skills/<name>/`) and a stub `SKILL.md` is generated in each client's skills directory pointing back to the full skill file.
 4. **Conflict handling** — If a file already exists and its content differs, you are prompted to overwrite or skip (unless `--force` or `--skip-existing` is set).
+5. **Path patching** — When `--ai-dir` is set to a non-default value, any `docs/ai/` references inside installed `.md` files are replaced with the custom path so LLMs can find resource files at runtime.
 
 ## Supported clients
 

package/dist/index.js

@@ -22,9 +22,9 @@ function parseFrontmatter(content) {
     content: parsed.content
   };
 }
-function generateStub(frontmatter, skillName) {
+function generateStub(frontmatter, skillName, aiDir = "docs/ai") {
   const body = `
-See \`docs/ai/skills/${skillName}/SKILL.md\` and follow closely.
+See \`${aiDir}/skills/${skillName}/SKILL.md\` and follow closely.
 `;
   return matter.stringify(body, frontmatter);
 }
@@ -266,6 +266,7 @@ async function detectClients(targetDir) {
 // src/lib/installer.ts
 import path3 from "path";
 import fs4 from "fs-extra";
+var DEFAULT_AI_DIR = "docs/ai";
 async function handleFile(srcPath, destPath, options, result, onConflict, contentOverride) {
   const relativeDest = path3.relative(options.targetDir, destPath);
   if (await fs4.pathExists(destPath)) {
@@ -309,6 +310,12 @@ async function handleFile(srcPath, destPath, options, result, onConflict, conten
     result.created.push(relativeDest);
   }
 }
+async function patchContent(srcPath, aiDir) {
+  if (aiDir === DEFAULT_AI_DIR) return void 0;
+  if (!srcPath.endsWith(".md")) return void 0;
+  const content = await fs4.readFile(srcPath, "utf-8");
+  return content.replaceAll(`${DEFAULT_AI_DIR}/`, `${aiDir}/`);
+}
 async function installSkill(skill, options, onConflict) {
   const result = {
     skill: skill.name,
@@ -316,14 +323,15 @@ async function installSkill(skill, options, onConflict) {
     skipped: [],
     overwritten: []
   };
-  const destFolder = path3.join(options.targetDir, "docs", "ai", "skills", skill.name);
+  const destFolder = path3.join(options.targetDir, options.aiDir, "skills", skill.name);
   const sourceFiles = await fs4.readdir(skill.sourcePath);
   for (const file of sourceFiles) {
     const srcFile = path3.join(skill.sourcePath, file);
     const stat = await fs4.stat(srcFile);
     if (stat.isFile()) {
       const destFile = path3.join(destFolder, file);
-      await handleFile(srcFile, destFile, options, result, onConflict);
+      const contentOverride = await patchContent(srcFile, options.aiDir);
+      await handleFile(srcFile, destFile, options, result, onConflict, contentOverride);
     }
   }
   for (const client of options.clients) {
@@ -333,7 +341,7 @@ async function installSkill(skill, options, onConflict) {
       skill.name,
       "SKILL.md"
     );
-    const stubContent = generateStub(skill.frontmatter, skill.name);
+    const stubContent = generateStub(skill.frontmatter, skill.name, options.aiDir);
     await handleFile("", stubPath, options, result, onConflict, stubContent);
   }
   return result;
@@ -355,14 +363,15 @@ async function installResources(toolset, options, onConflict) {
   if (!toolset.hasResources) return result;
   const entries = await fs4.readdir(toolset.resourcesPath);
   const resourceFiles = entries.filter((e) => e !== "README.md");
-  const destDir = path3.join(options.targetDir, "docs", "ai", "resources");
+  const destDir = path3.join(options.targetDir, options.aiDir, "resources");
   const fileResult = { skill: toolset.name, created: [], skipped: [], overwritten: [] };
   for (const file of resourceFiles) {
     const srcFile = path3.join(toolset.resourcesPath, file);
     const stat = await fs4.stat(srcFile);
     if (!stat.isFile()) continue;
     const destFile = path3.join(destDir, file);
-    await handleFile(srcFile, destFile, options, fileResult, onConflict);
+    const contentOverride = await patchContent(srcFile, options.aiDir);
+    await handleFile(srcFile, destFile, options, fileResult, onConflict, contentOverride);
   }
   result.created = fileResult.created;
   result.skipped = fileResult.skipped;
@@ -371,7 +380,7 @@ async function installResources(toolset, options, onConflict) {
 }
 
 // src/lib/prompts.ts
-import { select, checkbox, confirm } from "@inquirer/prompts";
+import { select, checkbox, confirm, input } from "@inquirer/prompts";
 import chalk2 from "chalk";
 async function promptSelectSkills(skills) {
   const librarySkills = skills.filter((s) => s.sourceType === "library");
@@ -457,12 +466,22 @@ async function promptIncludeLibrary() {
     default: false
   });
 }
-async function promptConfirmInstall(skills, clients, targetDir) {
+async function promptInstallDir() {
+  const raw = await input({
+    message: "Install location for AI skills and resources:",
+    default: "docs/ai"
+  });
+  return raw.replace(/\/+$/, "") || "docs/ai";
+}
+async function promptConfirmInstall(skills, clients, targetDir, aiDir = "docs/ai") {
   console.log();
   console.log(chalk2.bold("Install summary:"));
   console.log(`  Skills: ${skills.map((s) => s.name).join(", ")}`);
   console.log(`  Clients: ${clients.map((c) => c.name).join(", ") || chalk2.dim("none")}`);
   console.log(`  Target: ${targetDir}`);
+  if (aiDir !== "docs/ai") {
+    console.log(`  AI directory: ${aiDir}`);
+  }
   console.log();
   return confirm({ message: "Proceed with installation?", default: true });
 }
@@ -485,6 +504,14 @@ function formatTeamName2(name) {
 }
 
 // src/commands/install.ts
+function normalizeAiDir(raw) {
+  const trimmed = raw.replace(/\/+$/, "") || DEFAULT_AI_DIR;
+  if (path4.isAbsolute(trimmed)) {
+    console.log(chalk3.red(`--ai-dir must be a relative path, got: ${trimmed}`));
+    process.exit(1);
+  }
+  return trimmed;
+}
 function printResults(results, options, resourceResult) {
   const prefix = options.dryRun ? chalk3.yellow("[DRY RUN] ") : "";
   const createdWord = options.dryRun ? "would create" : "created";
@@ -525,6 +552,7 @@ async function installSkillCmd(name, _opts, cmd) {
   const targetDir = path4.resolve(
     parentOpts.target || process.cwd()
   );
+  const aiDir = normalizeAiDir(parentOpts.aiDir || DEFAULT_AI_DIR);
   const skill = await findSkill(name);
   if (!skill) {
     const all = await discoverSkills();
@@ -541,6 +569,7 @@ async function installSkillCmd(name, _opts, cmd) {
   }
   const options = {
     targetDir,
+    aiDir,
     clients,
     force,
     skipExisting,
@@ -564,6 +593,7 @@ async function installTeamCmd(name, _opts, cmd) {
   const targetDir = path4.resolve(
     parentOpts.target || process.cwd()
   );
+  const aiDir = normalizeAiDir(parentOpts.aiDir || DEFAULT_AI_DIR);
   const teams = await discoverTeams();
   const team = teams.find(
     (t) => t.name === name || t.name.toLowerCase() === name.toLowerCase()
@@ -589,6 +619,7 @@ async function installTeamCmd(name, _opts, cmd) {
   }
   const options = {
     targetDir,
+    aiDir,
     clients,
     force,
     skipExisting,
@@ -609,6 +640,7 @@ async function installToolsetCmd(name, _opts, cmd) {
   const targetDir = path4.resolve(
     parentOpts.target || process.cwd()
   );
+  const aiDir = normalizeAiDir(parentOpts.aiDir || DEFAULT_AI_DIR);
   const toolset = await findToolset(name);
   if (!toolset) {
     const allToolsets = await discoverToolsets();
@@ -627,6 +659,7 @@ async function installToolsetCmd(name, _opts, cmd) {
   }
   const options = {
     targetDir,
+    aiDir,
     clients,
     force,
     skipExisting,
@@ -640,11 +673,18 @@ async function installToolsetCmd(name, _opts, cmd) {
   const results = await installSkills(toolset.skills, options, conflictHandler);
   printResults(results, options, resourceResult);
 }
+var INHERITED_OPTIONS_HELP = `
+Parent options (pass before subcommand):
+  --force            Overwrite existing files without prompting
+  --skip-existing    Skip files that already exist without prompting
+  --dry-run          Show what would be installed without writing files
+  --target <dir>     Install to a different directory (default: CWD)
+  --ai-dir <path>    Override the AI skills/resources directory (default: docs/ai)`;
 function registerInstallCommand(program2) {
-  const install = program2.command("install").description("Install skills").option("--force", "Overwrite existing files without prompting").option("--skip-existing", "Skip files that already exist without prompting").option("--dry-run", "Show what would be installed without writing files").option("--target <dir>", "Install to a different directory (default: CWD)");
-  install.command("skill <name>").description("Install a specific skill").action(installSkillCmd);
-  install.command("team <name>").description("Install all skills for a team").action(installTeamCmd);
-  install.command("toolset <name>").description("Install all skills and resources for a toolset").action(installToolsetCmd);
+  const install = program2.command("install").description("Install skills").option("--force", "Overwrite existing files without prompting").option("--skip-existing", "Skip files that already exist without prompting").option("--dry-run", "Show what would be installed without writing files").option("--target <dir>", "Install to a different directory (default: CWD)").option("--ai-dir <path>", "Override the AI skills/resources directory (default: docs/ai)");
+  install.command("skill <name>").description("Install a specific skill").addHelpText("after", INHERITED_OPTIONS_HELP).action(installSkillCmd);
+  install.command("team <name>").description("Install all skills for a team").addHelpText("after", INHERITED_OPTIONS_HELP).action(installTeamCmd);
+  install.command("toolset <name>").description("Install all skills and resources for a toolset").addHelpText("after", INHERITED_OPTIONS_HELP).action(installToolsetCmd);
 }
 
 // src/commands/interactive.ts
@@ -757,20 +797,32 @@ async function runInteractive() {
     const selectedSkills = await promptSelectSkills(allSkills);
     const detected = await detectClients(targetDir);
     const clients = await promptSelectClients(ALL_CLIENTS, detected);
-    const confirmed = await promptConfirmInstall(selectedSkills, clients, targetDir);
+    const aiDir = await promptInstallDir();
+    const confirmed = await promptConfirmInstall(selectedSkills, clients, targetDir, aiDir);
     if (!confirmed) {
       console.log(chalk4.dim("Cancelled."));
       return;
     }
     const options = {
       targetDir,
+      aiDir,
       clients,
       force: false,
       skipExisting: false,
       dryRun: false
     };
     const results = await installSkills(selectedSkills, options, promptConflict);
-    printResults2(results, options);
+    let resourceResult;
+    const toolsetNames = new Set(
+      selectedSkills.filter((s) => s.sourceType === "toolset" && s.toolsetName).map((s) => s.toolsetName)
+    );
+    for (const tsName of toolsetNames) {
+      const toolset = await findToolset(tsName);
+      if (toolset && toolset.hasResources) {
+        resourceResult = await installResources(toolset, options, promptConflict);
+      }
+    }
+    printResults2(results, options, resourceResult);
   } else if (action === "install-team") {
     const teams = await discoverTeams();
     if (teams.length === 0) {
@@ -787,20 +839,32 @@ async function runInteractive() {
     }
     const detected = await detectClients(targetDir);
     const clients = await promptSelectClients(ALL_CLIENTS, detected);
-    const confirmed = await promptConfirmInstall(skillsToInstall, clients, targetDir);
+    const aiDir = await promptInstallDir();
+    const confirmed = await promptConfirmInstall(skillsToInstall, clients, targetDir, aiDir);
     if (!confirmed) {
       console.log(chalk4.dim("Cancelled."));
       return;
     }
     const options = {
       targetDir,
+      aiDir,
       clients,
       force: false,
       skipExisting: false,
       dryRun: false
     };
     const results = await installSkills(skillsToInstall, options, promptConflict);
-    printResults2(results, options);
+    let resourceResult;
+    const toolsetNames = new Set(
+      skillsToInstall.filter((s) => s.sourceType === "toolset" && s.toolsetName).map((s) => s.toolsetName)
+    );
+    for (const tsName of toolsetNames) {
+      const toolset = await findToolset(tsName);
+      if (toolset && toolset.hasResources) {
+        resourceResult = await installResources(toolset, options, promptConflict);
+      }
+    }
+    printResults2(results, options, resourceResult);
   } else if (action === "install-toolset") {
     const toolsets = await discoverToolsets();
     if (toolsets.length === 0) {
@@ -810,13 +874,15 @@ async function runInteractive() {
     const toolset = await promptSelectToolset(toolsets);
     const detected = await detectClients(targetDir);
     const clients = await promptSelectClients(ALL_CLIENTS, detected);
-    const confirmed = await promptConfirmInstall(toolset.skills, clients, targetDir);
+    const aiDir = await promptInstallDir();
+    const confirmed = await promptConfirmInstall(toolset.skills, clients, targetDir, aiDir);
     if (!confirmed) {
       console.log(chalk4.dim("Cancelled."));
       return;
     }
     const options = {
       targetDir,
+      aiDir,
       clients,
       force: false,
       skipExisting: false,
@@ -846,6 +912,7 @@ Examples:
   $ npx @groupby/ai-dev install skill frontend-design Install a single skill
   $ npx @groupby/ai-dev install team brain-studio     Install all team skills
   $ npx @groupby/ai-dev install toolset rzlv-flow     Install all skills + resources for a toolset
-  $ npx @groupby/ai-dev install team brain-studio --dry-run`
+  $ npx @groupby/ai-dev install team brain-studio --dry-run
+  $ npx @groupby/ai-dev install skill frontend-design --ai-dir .ai`
 );
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groupby/ai-dev",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Interactive installer for Rezolve Ai development skills",
   "type": "module",
   "bin": {
@@ -13,7 +13,7 @@
     "toolsets/"
   ],
   "scripts": {
-    "prebuild": "cp -r ../skills ./skills && cp -r ../teams ./teams && cp -r ../toolsets ./toolsets",
+    "prebuild": "rm -rf skills teams toolsets && cp -r ../skills ./skills && cp -r ../teams ./teams && cp -r ../toolsets ./toolsets",
     "build": "tsup",
     "prepublishOnly": "npm run build",
     "test": "vitest run",
@@ -22,11 +22,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/rezolved/ai-dev-shared.git",
+    "url": "git+https://github.com/groupby/ai-dev-shared.git",
     "directory": "cli"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"

package/skills/library/implementation-plan/README.md

@@ -0,0 +1,19 @@
+# implementation-plan
+
+Generate structured implementation plans from any written input — documents, notes, specs, or descriptions.
+
+Produces phased checklists with architecture justification, a clarifications file for surfacing and resolving ambiguities before planning, and self-contained sub-plan files for larger work.
+
+## Output
+
+Plans are written to `docs/planning/<story-name>/` (folder) or `docs/planning/<story-name>.md` (single file), depending on scope. A `clarifications.md` file is always generated alongside the plan.
+
+## Example prompts
+
+- `/implementation-plan` with a pasted feature description
+- `/implementation-plan` pointing to `docs/planning/tasks/configurable-install-path.md`
+- "Plan the implementation for adding OAuth support"
+
+## Related
+
+- [`jira-plan`](../jira-plan/) — wrapper that fetches Jira ticket context and delegates to this skill for plan generation