@novare-technologies/nvaid 0.2.2 → 0.2.4

package/dist/cli.js

@@ -16,7 +16,6 @@ var AGENTS = [
     commandsPath: ".claude/commands",
     // /nvaid:install resolves from .claude/commands/nvaid/install.md
     instructionsFile: "CLAUDE.md",
-    format: "markdown",
     bespoke: true
   },
   {
@@ -24,70 +23,65 @@ var AGENTS = [
     label: "Kiro",
     skillsPath: ".kiro/skills",
     instructionsFile: ".kiro/steering/nvaid.md",
-    format: "markdown",
     bespoke: true
   },
   {
     id: "cursor",
     label: "Cursor",
-    skillsPath: ".cursor/rules",
-    commandsPath: ".cursor/commands",
-    // Cursor reads custom commands from .cursor/commands
-    format: "mdc",
+    skillsPath: ".cursor/skills",
+    // cursor.com/docs/skills
     bespoke: true
   },
   {
     id: "copilot",
     label: "GitHub Copilot",
-    skillsPath: ".github",
+    skillsPath: ".github/skills",
+    // docs.github.com — project skills in .github/skills
     instructionsFile: ".github/copilot-instructions.md",
-    format: "markdown",
     bespoke: true
   },
   {
     id: "windsurf",
     label: "Windsurf",
-    skillsPath: ".windsurf/rules",
-    format: "markdown",
+    skillsPath: ".windsurf/skills",
+    // docs.windsurf.com/windsurf/cascade/skills
     bespoke: true
   },
   {
     id: "amazonq",
     label: "Amazon Q",
-    skillsPath: ".amazonq/rules",
-    format: "markdown",
+    skillsPath: ".amazonq/skills",
     bespoke: true
   },
   {
     id: "cline",
     label: "Cline",
-    skillsPath: ".cline/rules",
+    skillsPath: ".cline/skills",
+    // docs.cline.bot/customization/skills
     instructionsFile: ".clinerules",
-    format: "markdown",
     bespoke: true
   },
   {
     id: "gemini",
     label: "Gemini Code Assist",
-    skillsPath: ".gemini",
-    instructionsFile: ".gemini/styleguide.md",
-    format: "markdown",
+    skillsPath: ".gemini/skills",
+    // geminicli.com/docs/cli/skills
     bespoke: true
   },
   {
     id: "aider",
     label: "Aider",
-    skillsPath: ".nvaid/skills",
+    skillsPath: ".agents/skills",
+    // neutral cross-tool skills location
     instructionsFile: "AGENTS.md",
-    format: "markdown",
     bespoke: true
   },
   {
     id: "agents-md",
-    label: "Any AGENTS.md-compatible tool (catch-all)",
-    skillsPath: ".nvaid/skills",
+    label: "Any Agent-Skills / AGENTS.md tool (catch-all)",
+    skillsPath: ".agents/skills",
+    // the emerging neutral standard (per GitHub Copilot docs)
     instructionsFile: "AGENTS.md",
-    format: "markdown",
     bespoke: false
   }
 ];
@@ -124,10 +118,18 @@ function aidlcRootFor(agent) {
   void agent;
   return "nvaid/rules";
 }
-function withHeader(body, format) {
-  if (format === "mdc") {
-    return `${DO_NOT_EDIT}
-${body}`;
+function withHeader(body) {
+  if (body.startsWith("---\n")) {
+    const end = body.indexOf("\n---", 4);
+    if (end !== -1) {
+      const closeLineEnd = body.indexOf("\n", end + 1);
+      const cut = closeLineEnd === -1 ? body.length : closeLineEnd + 1;
+      const front = body.slice(0, cut);
+      const rest = body.slice(cut);
+      return `${front}
+${DO_NOT_EDIT}
+${rest}`;
+    }
   }
   return `${DO_NOT_EDIT}
 
@@ -144,19 +146,17 @@ async function listCommandFiles() {
 async function renderTemplate(srcFile, agent) {
   const raw = await readFile(srcFile, "utf8");
   const substituted = raw.split(AIDLC_ROOT_TOKEN).join(aidlcRootFor(agent));
-  return withHeader(substituted, agent.format);
+  return withHeader(substituted);
 }
 function skillTarget(projectRoot, agent, skill) {
-  const ext = agent.format === "mdc" ? "mdc" : "md";
-  return join(projectRoot, agent.skillsPath, `${skill}.${ext}`);
+  return join(projectRoot, agent.skillsPath, skill, "SKILL.md");
 }
 function commandTarget(projectRoot, agent, cmdFile) {
   const base = cmdFile.replace(/\.md$/, "");
-  const ext = agent.format === "mdc" ? "mdc" : "md";
   if (agent.commandsPath) {
-    return join(projectRoot, agent.commandsPath, "nvaid", `${base}.${ext}`);
+    return join(projectRoot, agent.commandsPath, "nvaid", `${base}.md`);
   }
-  return join(projectRoot, agent.skillsPath, "nvaid-commands", `nvaid-${base}.${ext}`);
+  return join(projectRoot, agent.skillsPath, `nvaid-${base}`, "SKILL.md");
 }
 async function writeFileEnsuringDir(path, body, force, result) {
   if (!force && existsSync(path)) {
@@ -211,11 +211,22 @@ async function diffAgentFiles(opts) {
   return drift;
 }
 async function cleanAgentDirs(projectRoot, agents) {
+  const skills = await listSkillDirs().catch(() => []);
   for (const agent of agents) {
-    const commandsDir = agent.commandsPath ? join(projectRoot, agent.commandsPath, "nvaid") : join(projectRoot, agent.skillsPath, "nvaid-commands");
-    if (existsSync(commandsDir)) await rm(commandsDir, { recursive: true, force: true });
+    if (agent.commandsPath) {
+      await rmIfExists(join(projectRoot, agent.commandsPath, "nvaid"));
+    }
+    await rmIfExists(join(projectRoot, agent.skillsPath, "commands"));
+    await rmIfExists(join(projectRoot, agent.skillsPath, "nvaid-commands"));
+    for (const skill of skills) {
+      await rmIfExists(join(projectRoot, agent.skillsPath, `${skill}.md`));
+      await rmIfExists(join(projectRoot, agent.skillsPath, `${skill}.mdc`));
+    }
   }
 }
+async function rmIfExists(path) {
+  if (existsSync(path)) await rm(path, { recursive: true, force: true });
+}
 
 // src/scaffold.ts
 import { cp, mkdir as mkdir2, readdir as readdir2 } from "fs/promises";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novare-technologies/nvaid",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "nvaid — one CLI that installs an AI-DLC skills-and-workflow toolkit into any coding agent, and houses intents, config, and the design-code dictionary in a single nvaid/ folder.",
   "type": "module",
   "bin": {

package/templates/nvaid/config.yml

@@ -84,4 +84,4 @@ context: ""
 
 # nvaid version this repo was last generated against. `nvaid validate` compares the
 # installed CLI version to this and flags drift.
-generated_with: "0.2.2"
+generated_with: "0.2.4"

package/templates/rules/ISSUE-TRACKER-TEMPLATE.md

@@ -12,7 +12,7 @@ status: draft
 **What this file is:** the field shape and creation rules for how Fig. 2's Intent-to-Release
 artifacts show up in Jira or GitHub Projects — one Epic per Intent, one Story or Bug per
 Unit of Work, bundled for shipping by Release Checkpoint rather than by sprint — so the
-tracker and the `aidlc-docs/` artifacts never disagree about what was decided.
+tracker and the `nvaid/` artifacts never disagree about what was decided.
 
 **What this file is not:** not a replacement for `intent.md`, `unit-breakdown.md`, or any
 contract file. The tracker is the *tracking* layer — status, ownership, checkpoint
@@ -21,7 +21,7 @@ agreed, in full, versioned in git. A ticket field never carries content that onl
 the ticket; if it's worth writing down, it's worth writing into the file the AI agent
 actually reads, and the ticket links to it.
 
-**Companion files:** [PROJECT-RULES.md](./PROJECT-RULES.md) §7 rule 11 is the operating
+**Companion files:** [PROJECT-RULES.md](../PROJECT-RULES.md) §7 rule 11 is the operating
 rule this file implements. [unit-breakdown-rules.md](./unit-breakdown-rules.md) governs
 *how* a Unit of Work is decided and classified before it ever becomes the ticket
 described here. The worked example in `docs/templates/samples/` is what every link below
@@ -45,7 +45,7 @@ A ticket holds three kinds of information, and only two of them belong in ticket
 2. **Links to content** (the Intent, the contracts, the design docs) — belongs in ticket
    fields, as links, never as pasted text.
 3. **The content itself** (what the API contract actually says, what the acceptance
-   criteria actually are) — belongs *only* in the `aidlc-docs/` artifact. Pasting it into
+   criteria actually are) — belongs *only* in the `nvaid/` artifact. Pasting it into
    a ticket description creates a second copy that drifts the first time either one is
    edited without the other, and the AI agent isn't the one reading the ticket anyway — it
    reads the file.

package/templates/rules/unit-breakdown-rules.md

@@ -20,7 +20,7 @@ governs that), not the ceremony's choreography (the AI-Native Engineering Model'
 one specific judgment call: given an approved Intent, what its Units of Work are.
 
 **Companion files:** [ISSUE-TRACKER-TEMPLATE.md](./ISSUE-TRACKER-TEMPLATE.md) is where a
-Unit of Work, once decided here, becomes a ticket. [PROJECT-RULES.md](./PROJECT-RULES.md)
+Unit of Work, once decided here, becomes a ticket. [PROJECT-RULES.md](../PROJECT-RULES.md)
 §7 rule 12 is the operating rule this file implements.
 
 ---

package/templates/skills/r3-analytics/SKILL.md

@@ -2,7 +2,7 @@
 name: r3-analytics
 description: Gathers checkpoint-to-checkpoint performance indicators (lead time, gate pass rate, escaped defects, Known Gaps) for R3's Retrospective step. Use when asked to run the R3 Analytics Skill or prepare Retrospective data after a Release Checkpoint ships.
 invoked_by: R3 (Ceremony 4), triggered by a Release Checkpoint shipping
-output: file — process/retro-<checkpoint>.md
+output: file — nvaid/process/retro-<checkpoint>.md
 ---
 
 # R3 Analytics Skill
@@ -17,8 +17,8 @@ looks at, so "what does the data actually say" has an answer ready the moment R3
    escaped defects logged against this checkpoint's Units.
 3. Roll up every Known Gap logged across this checkpoint's Quality Architecture
    Contracts — a gap doesn't disappear just because the checkpoint shipped.
-4. Draft `process/retro-<checkpoint>.md` with the above, structured for the room to read
-   before proposing Regenerate edits.
+4. Draft `nvaid/process/retro-<checkpoint>.md` with the above, structured for the room to
+   read before proposing Regenerate edits.
 
 ## Boundaries