@jenga-ai/agent 1.2.2 → 1.2.4

package/README.md

@@ -1,4 +1,4 @@
-# JengaAgent
+# Jenga AI
 
 **A structured multi-agent development workflow that works with any AI agent or AI-native IDE.** Three specialised AI agents — Scrum Master, Developer, and Tester — collaborate through a shared scrum board, an event-driven trigger queue, and 28 slash-command skills to take a project from idea to verified, committed code — across as many sessions as it takes.
 
@@ -25,16 +25,18 @@ npm install @jenga-ai/agent
 | Agent | Skills & Agents | Root Context File |
 |---|---|---|
 | **Claude Code** | `.claude/` — mirrored automatically on install | `CLAUDE.md` — generated by `/init` today |
-| **GitHub Copilot** | `.agents/` — mirrored automatically on install | `.github/copilot-instructions.md` — generated by `/init` today |
+| **GitHub Copilot** | `.agents/` — mirrored automatically on install | `.github/copilot-instructions.md` — bootstrapped at `npm install` time, refined by `jenga init` |
 | **Codex** | `.agents/` — mirrored automatically on install | `AGENTS.md` — generated by `/init` today |
 
 `CLAUDE.md` and `AGENTS.md` are generated unconditionally by `/init` — every agent gets a real, populated root-level context file out of the box, not just a pointer. If either file already exists as a genuine pre-existing user file, Jenga writes its own copy as `J-CLAUDE.md` / `J-AGENTS.md` instead and inserts a short reference into the existing file, leaving it otherwise untouched.
 
+`.github/copilot-instructions.md` follows a different path: `scripts/postinstall.js` writes it unconditionally and non-interactively the moment `npm install` finishes, so Copilot has working `/skill-name` routing instructions even if a consumer's very first action is a Copilot slash command, before the separate `jenga init` CLI wizard has ever run. Running `jenga init` afterward refines the same file using the user's actual chosen skills path — it is never generated by the `/init` skill itself.
+
 ---
 
 ## The Problem It Solves
 
-Without a framework like JengaAgent, AI-assisted development has serious structural weaknesses:
+Without a framework like Jenga AI, AI-assisted development has serious structural weaknesses:
 
 | Problem | Reality |
 |---|---|
@@ -45,7 +47,7 @@ Without a framework like JengaAgent, AI-assisted development has serious structu
 | **No audit trail** | You can't replay *why* something was built, by which agent, based on which task |
 | **Sessions just end** | Work-in-progress, unresolved problems, and incomplete stories silently vanish |
 
-JengaAgent solves each of these with structure: persistent board state, strict agent roles, typed inter-agent contracts, and session-end hooks that preserve context between sessions.
+Jenga AI solves each of these with structure: persistent board state, strict agent roles, typed inter-agent contracts, and session-end hooks that preserve context between sessions.
 
 ---
 
@@ -53,7 +55,7 @@ JengaAgent solves each of these with structure: persistent board state, strict a
 
 ### Before / After
 
-**Without JengaAgent:**
+**Without Jenga AI:**
 ```
 You: "Add user authentication"
 AI agent: [writes auth code, declares it works, session ends]
@@ -63,7 +65,7 @@ You: "What's the status of auth?"
 AI agent: "I don't have context from the previous session."
 ```
 
-**With JengaAgent:**
+**With Jenga AI:**
 ```
 /todo → "Add user authentication" → linked to E01_S02
 /do   → Developer creates worktree E01_S02_T01-auth
@@ -81,7 +83,7 @@ Next session:
 
 ### Real-World Scenario: Building a Feature Across Sessions
 
-Imagine you're building a REST API with auth, rate limiting, and an admin dashboard. Each is a separate Epic. Here's how JengaAgent handles that across multiple days:
+Imagine you're building a REST API with auth, rate limiting, and an admin dashboard. Each is a separate Epic. Here's how Jenga AI handles that across multiple days:
 
 **Planning**
 ```
@@ -187,7 +189,7 @@ Run `/status` at any time to see where the project stands.
 
 ## Supported Platforms
 
-JengaAgent has been tested with:
+Jenga AI has been tested with:
 
 | Platform | Type |
 |---|---|
@@ -261,7 +263,7 @@ Skills live in `.agents/skills/<name>/SKILL.md`. Invoke with `/<name>` in your A
 
 ## Distributing the Workflow
 
-JengaAgent can propagate its workflow files to other projects on your machine via `/distribute`.
+Jenga AI can propagate its workflow files to other projects on your machine via `/distribute`.
 
 1. **Register consumer projects** — add each consuming project to `distribute.config.json` at the repo root (or pass a path directly: `/distribute /path/to/project`).
 2. **Run `/distribute`** — choose `major`, `minor`, `patch`, or `amend` release type; the skill handles versioning, dry-run preview, file copy, and a version bump commit.
@@ -375,7 +377,7 @@ All agents log every incoming sender object to `project/logs/events.json` as the
 
 ---
 
-## When to Use JengaAgent
+## When to Use Jenga AI
 
 **Use it when:**
 - You're building a non-trivial project across multiple sessions

package/lib/commands/init.js

@@ -1,10 +1,11 @@
 import { createInterface } from "readline";
-import { readFileSync, writeFileSync, existsSync, appendFileSync, mkdirSync, readdirSync } from "fs";
+import { readFileSync, writeFileSync, existsSync, appendFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { validateConfig } from "../config-schema.js";
 import { injectSettings } from "../inject-settings.js";
 import { generateAgentContext } from "../generate-agent-context.js";
+import { generateCopilotInstructions } from "../generate-copilot-instructions.js";
 
 const CONFIG_FILE = "jenga.cli.json";
 
@@ -125,74 +126,28 @@ export async function runInit(args, projectRoot = process.cwd()) {
       console.warn("You can register it manually later by running jenga init again.");
     }
 
-    // Generate .github/copilot-instructions.md from template.
-    // Templates ship inside the jenga-agent package (node_modules/jenga-agent/templates/).
-    // Fall back to a bare `templates/` at the project root only for the dev-repo case.
+    // Generate .github/copilot-instructions.md from template, via the shared generator
+    // (lib/generate-copilot-instructions.js) also used unconditionally by scripts/postinstall.js
+    // at install time (E46_S03_T01). Templates ship inside the jenga-agent package
+    // (node_modules/jenga-agent/templates/), with a bare `templates/` at the project root as a
+    // fallback for the dev-repo case — both handled inside the shared generator.
+    //
+    // skillsPath may be a string or an array (multi-target installs); pick the first existing
+    // directory — mirrored copies hold identical content. This pass uses the user's actual
+    // chosen skillsPath from the wizard, which may differ from postinstall's `.agents/skills`
+    // default and refines whatever postinstall already bootstrapped. The shared generator's
+    // idempotent marker-replace logic means running it again here never duplicates the JENGA
+    // block or corrupts content outside the markers.
     try {
-      const tplCandidates = [
-        join(PACKAGE_ROOT, "templates", "copilot-instructions.md.tpl"),
-        join(projectRoot, "templates", "copilot-instructions.md.tpl"),
-      ];
-      const tplPath = tplCandidates.find(existsSync);
-      if (tplPath) {
-        const tpl = readFileSync(tplPath, "utf8");
-
-        // Build skill list from skillsPath. skillsPath may be a string or an
-        // array (multi-target installs); pick the first existing directory —
-        // mirrored copies hold identical content.
-        const skillsPathList = Array.isArray(config.skillsPath) ? config.skillsPath : [config.skillsPath];
-        const skillsDir = skillsPathList
-          .map(p => join(projectRoot, p))
-          .find(existsSync);
-        let skillLines = [];
-        if (skillsDir) {
-          for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
-            if (!entry.isDirectory()) continue;
-            const skillMdPath = join(skillsDir, entry.name, "SKILL.md");
-            let description = "";
-            if (existsSync(skillMdPath)) {
-              const content = readFileSync(skillMdPath, "utf8");
-              const match = content.match(/^description:\s*(.+)$/m);
-              if (match) description = match[1].trim();
-            }
-            skillLines.push(`- **${entry.name}**${description ? `: ${description}` : ""}`);
-          }
-        }
-        const skillList = skillLines.length > 0 ? skillLines.join("\n") : "_No skills found._";
-        const rendered = tpl.replace("{{SKILL_LIST}}", skillList);
-
-        const githubDir = join(projectRoot, ".github");
-        const copilotInstructionsPath = join(githubDir, "copilot-instructions.md");
-
-        if (!existsSync(githubDir)) mkdirSync(githubDir, { recursive: true });
-
-        if (!existsSync(copilotInstructionsPath)) {
-          writeFileSync(copilotInstructionsPath, rendered, "utf8");
-        } else {
-          // Replace only the JENGA block; preserve content outside the markers
-          const existing = readFileSync(copilotInstructionsPath, "utf8");
-          const startMarker = "<!-- JENGA:START -->";
-          const endMarker = "<!-- JENGA:END -->";
-          const startIdx = existing.indexOf(startMarker);
-          const endIdx = existing.indexOf(endMarker);
-
-          // Extract the new JENGA block from rendered template
-          const renderedStart = rendered.indexOf(startMarker);
-          const renderedEnd = rendered.indexOf(endMarker);
-          const newBlock = rendered.slice(renderedStart, renderedEnd + endMarker.length);
-
-          let updated;
-          if (startIdx !== -1 && endIdx !== -1 && startIdx < endIdx) {
-            updated =
-              existing.slice(0, startIdx) +
-              newBlock +
-              existing.slice(endIdx + endMarker.length);
-          } else {
-            // No existing markers — append the block
-            updated = existing + (existing.endsWith("\n") ? "" : "\n") + newBlock + "\n";
-          }
-          writeFileSync(copilotInstructionsPath, updated, "utf8");
-        }
+      const skillsPathList = Array.isArray(config.skillsPath) ? config.skillsPath : [config.skillsPath];
+      const skillsDir = skillsPathList
+        .map(p => join(projectRoot, p))
+        .find(existsSync);
+
+      const result = generateCopilotInstructions(projectRoot, PACKAGE_ROOT, skillsDir);
+      if (result.skipped) {
+        console.warn("Warning: templates/copilot-instructions.md.tpl not found — skipped .github/copilot-instructions.md generation.");
+      } else {
         console.log("✓ .github/copilot-instructions.md written");
       }
     } catch (e) {

package/lib/generate-agent-context.js

@@ -26,7 +26,7 @@
  * ESM, Node built-ins only — mirrors lib/mirror.js and lib/inject-settings.js.
  */
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, realpathSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 
@@ -220,7 +220,16 @@ export function generateAgentContext(projectRoot = process.cwd(), packageRoot =
 // used by skills/init/scripts/init.sh (this repo's own board-scaffolding
 // flow, where node is guaranteed available). The published npm CLI path
 // (lib/commands/init.js) imports generateAgentContext() directly instead.
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
+//
+// process.argv[1] is compared via realpath, not as a raw string: Node
+// resolves import.meta.url through symlinks when loading an ES module, but
+// leaves process.argv[1] exactly as the shell passed it. On macOS, TMPDIR
+// and /tmp are themselves symlinks into /private, so any invocation from a
+// path under either (a very ordinary occurrence — every consumer install
+// under a symlinked, mapped, or `npm link`-ed directory hits this) made the
+// two sides disagree and silently skipped generation with no error.
+const invokedPath = process.argv[1] ? realpathSync(process.argv[1]) : null;
+if (invokedPath === fileURLToPath(import.meta.url)) {
   const projectRoot = process.argv[2] || process.cwd();
   const result = generateAgentContext(projectRoot);
   if (result.skipped) {

package/lib/generate-copilot-instructions.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+/**
+ * lib/generate-copilot-instructions.js — .github/copilot-instructions.md generation
+ *
+ * Single source of truth for scaffolding the Copilot routing-instructions file from
+ * templates/copilot-instructions.md.tpl (extracted from lib/commands/init.js per E46_S03_T01).
+ * Used by:
+ *   - scripts/postinstall.js  (runs unconditionally, non-interactively, on every `npm install`)
+ *   - lib/commands/init.js    (the interactive `jenga init` CLI wizard, using the user's chosen
+ *                              skillsPath — may differ from postinstall's default)
+ *
+ * Root-cause context: `.github/copilot-instructions.md` teaches Copilot the `/skill-name` →
+ * `.agents/skills/<name>/SKILL.md` routing convention. It was previously written only by the
+ * `jenga init` CLI wizard, never by postinstall.js — so a consumer whose very first action was
+ * typing `/init` inside Copilot (before ever running `jenga init`) got no routing at all.
+ * Extracting this into a shared, parameterized function lets postinstall.js bootstrap a working
+ * routing file immediately, with `jenga init` free to refine it later using the user's actual
+ * chosen skills path.
+ *
+ * Collision behaviour (preserved verbatim from the original inline implementation — do not
+ * rewrite this algorithm, only relocate it):
+ *   - If `.github/copilot-instructions.md` does not exist, write the rendered template in full.
+ *   - If it exists, replace only the content between `<!-- JENGA:START -->` and
+ *     `<!-- JENGA:END -->`, preserving everything outside the markers.
+ *   - If it exists but has no JENGA markers, append the block to the end of the file.
+ * This makes repeat runs (postinstall run twice, or postinstall followed by `jenga init`)
+ * idempotent: the JENGA block is never duplicated and content outside the markers is never
+ * touched.
+ *
+ * ESM, Node built-ins only — mirrors lib/generate-agent-context.js and lib/mirror.js.
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+// This file lives at <package>/lib/generate-copilot-instructions.js — one level up is the
+// installed jenga-agent package root, which holds templates/.
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_PACKAGE_ROOT = join(__dirname, "..");
+
+const START_MARKER = "<!-- JENGA:START -->";
+const END_MARKER = "<!-- JENGA:END -->";
+
+function resolveTemplatePath(projectRoot, packageRoot) {
+  const candidates = [
+    join(packageRoot, "templates", "copilot-instructions.md.tpl"),
+    join(projectRoot, "templates", "copilot-instructions.md.tpl"),
+  ];
+  return candidates.find(existsSync);
+}
+
+/**
+ * Build the {{SKILL_LIST}} markdown block by scanning `skillsDir` for subdirectories
+ * containing a SKILL.md, extracting each one's `description:` frontmatter line.
+ */
+function buildSkillList(skillsDir) {
+  if (!skillsDir || !existsSync(skillsDir)) return "_No skills found._";
+
+  const skillLines = [];
+  for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const skillMdPath = join(skillsDir, entry.name, "SKILL.md");
+    let description = "";
+    if (existsSync(skillMdPath)) {
+      const content = readFileSync(skillMdPath, "utf8");
+      const match = content.match(/^description:\s*(.+)$/m);
+      if (match) description = match[1].trim();
+    }
+    skillLines.push(`- **${entry.name}**${description ? `: ${description}` : ""}`);
+  }
+  return skillLines.length > 0 ? skillLines.join("\n") : "_No skills found._";
+}
+
+/**
+ * Replace only the JENGA:START..JENGA:END block in an existing copilot-instructions.md with the
+ * freshly rendered one, preserving everything outside the markers. If no existing file, write
+ * the rendered template in full. If the existing file has no markers, append the block.
+ */
+function writeCopilotInstructions(path, rendered) {
+  if (!existsSync(path)) {
+    writeFileSync(path, rendered, "utf8");
+    return;
+  }
+
+  const existing = readFileSync(path, "utf8");
+  const startIdx = existing.indexOf(START_MARKER);
+  const endIdx = existing.indexOf(END_MARKER);
+
+  const renderedStart = rendered.indexOf(START_MARKER);
+  const renderedEnd = rendered.indexOf(END_MARKER);
+  const newBlock = rendered.slice(renderedStart, renderedEnd + END_MARKER.length);
+
+  let updated;
+  if (startIdx !== -1 && endIdx !== -1 && startIdx < endIdx) {
+    updated = existing.slice(0, startIdx) + newBlock + existing.slice(endIdx + END_MARKER.length);
+  } else {
+    // No existing markers — append the block.
+    updated = existing + (existing.endsWith("\n") ? "" : "\n") + newBlock + "\n";
+  }
+  writeFileSync(path, updated, "utf8");
+}
+
+/**
+ * Generate (or idempotently refresh) `.github/copilot-instructions.md` at projectRoot from the
+ * shared template.
+ *
+ * @param {string} projectRoot - project root directory (default: cwd)
+ * @param {string} packageRoot - installed jenga-agent package root (default: derived from this
+ *   file's own location)
+ * @param {string} skillsDir - path to the skills directory, resolved relative to projectRoot if
+ *   not already absolute (e.g. ".agents/skills" from postinstall, or the user's chosen
+ *   skillsPath from the `jenga init` wizard)
+ * @returns {{written: boolean, path?: string, skipped?: boolean}}
+ */
+export function generateCopilotInstructions(
+  projectRoot = process.cwd(),
+  packageRoot = DEFAULT_PACKAGE_ROOT,
+  skillsDir
+) {
+  const tplPath = resolveTemplatePath(projectRoot, packageRoot);
+  if (!tplPath) {
+    return { written: false, skipped: true };
+  }
+
+  const tpl = readFileSync(tplPath, "utf8");
+
+  const resolvedSkillsDir = skillsDir
+    ? (skillsDir.startsWith("/") ? skillsDir : join(projectRoot, skillsDir))
+    : undefined;
+  const skillList = buildSkillList(resolvedSkillsDir);
+  const rendered = tpl.replace("{{SKILL_LIST}}", skillList);
+
+  const githubDir = join(projectRoot, ".github");
+  const copilotInstructionsPath = join(githubDir, "copilot-instructions.md");
+
+  if (!existsSync(githubDir)) mkdirSync(githubDir, { recursive: true });
+
+  writeCopilotInstructions(copilotInstructionsPath, rendered);
+
+  return { written: true, path: copilotInstructionsPath };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jenga-ai/agent",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "Structured multi-agent development workflow for AI coding agents — scrum board, role-bounded scrum master / developer / tester agents, and 30+ slash-command skills. Works with Claude Code, GitHub Copilot, and Codex.",
   "type": "module",
   "publishConfig": {
@@ -14,6 +14,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
+    "test": "bats tests/*.bats",
     "validate:npm-metadata": "bash scripts/validate_npm_metadata.sh",
     "ui:dev": "npm run ui:dev --prefix project/app",
     "ui:build": "npm run ui:build --prefix project/app",
@@ -74,5 +75,8 @@
   },
   "comments": {
     "audit": "sharp <0.35.0 and adm-zip <0.6.0 are transitive deps of @huggingface/transformers with no upstream fix available. Not exploitable in this context: only text feature-extraction pipeline is used — no image processing or ZIP handling at application boundary. Review when @huggingface/transformers ships a patched release."
+  },
+  "devDependencies": {
+    "bats": "^1.13.0"
   }
 }

package/scripts/postinstall.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * postinstall.js — JengaAgent consumer installation hook
+ * postinstall.js — Jenga AI consumer installation hook
  *
  * Runs automatically when a consumer project installs jenga-agent via npm.
  * Copies the discovery-bound dirs — `skills/` and `agents/` — into BOTH
@@ -32,6 +32,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { mirror } from '../lib/mirror.js';
+import { generateCopilotInstructions } from '../lib/generate-copilot-instructions.js';
 
 // ESM equivalent of __dirname
 const __filename = fileURLToPath(import.meta.url);
@@ -65,7 +66,7 @@ function main() {
 
   // Avoid running during development (when INIT_CWD === packageRoot itself)
   if (path.resolve(consumerRoot) === path.resolve(packageRoot)) {
-    console.log('\n  ℹ  JengaAgent postinstall: running inside the package itself — skipping copy.\n');
+    console.log('\n  ℹ  Jenga AI postinstall: running inside the package itself — skipping copy.\n');
     return;
   }
 
@@ -93,7 +94,7 @@ function main() {
   const shouldCopy     = isFirstInstall || isUpgrade;
 
   console.log('\n╔══════════════════════════════════════════════════════╗');
-  console.log('║            JengaAgent — postinstall hook             ║');
+  console.log('║            Jenga AI — postinstall hook             ║');
   console.log('╚══════════════════════════════════════════════════════╝\n');
   console.log(`  Package version  : ${packageVersion}`);
   console.log(`  Installed version: ${installedVersion ?? '(none — first install)'}`);
@@ -153,6 +154,26 @@ function main() {
     totalSkipped += result.skipped.length;
   }
 
+  // Bootstrap .github/copilot-instructions.md unconditionally, right after the mirror step —
+  // no interactive prompts, since postinstall runs unattended during `npm install`. Without
+  // this, a consumer whose very first action is a Copilot slash command (before ever running
+  // the separate `jenga init` CLI wizard) gets no `/skill-name` routing instructions at all
+  // (E46_S03_T01). `.agents/skills` is passed as the skills directory because that's the
+  // directory the mirror step above just populated, regardless of which agentTarget the user
+  // eventually picks in `jenga init`. The shared generator's idempotent marker-replace logic
+  // (lib/generate-copilot-instructions.js) means a later `jenga init` run — using the user's
+  // actual chosen skillsPath — safely refines this file without duplicating the JENGA block.
+  try {
+    const result = generateCopilotInstructions(consumerRoot, packageRoot, '.agents/skills');
+    if (result.skipped) {
+      console.log('  ⚠  templates/copilot-instructions.md.tpl not found — skipped .github/copilot-instructions.md bootstrap');
+    } else {
+      console.log('  ✓ .github/copilot-instructions.md bootstrapped');
+    }
+  } catch (e) {
+    console.log(`  ⚠  Could not bootstrap .github/copilot-instructions.md — ${e.message}`);
+  }
+
   // Write .jenga-version to record the installed version at consumer root
   fs.writeFileSync(versionFile, packageVersion + '\n', 'utf8');
 

package/scripts/validate_npm_metadata.sh

@@ -7,7 +7,7 @@
 # (CLAUDE.md), this is a script rather than an agent instruction so that
 # future drift in package.json's publish-facing fields (e.g. keywords
 # accidentally cleared, or repository.url silently re-pointed at the
-# private samwelmunga/JengaAgent repo instead of the public jenga-npm
+# private samwelmunga/Jenga AI repo instead of the public jenga-npm
 # mirror) is caught deterministically instead of relying on an agent
 # noticing during review.
 #
@@ -109,7 +109,7 @@ if (pkg.repository != null) {
   if (!repoUrl || repoUrl.trim().length === 0) {
     fail("repository is present but has no resolvable url.");
   } else if (!repoUrl.includes(PUBLIC_REPO_MARKER)) {
-    fail("repository.url (\"" + repoUrl + "\") does not point at the public " + PUBLIC_REPO_MARKER + " repo — it must not reference a private repo (e.g. samwelmunga/JengaAgent) or any other location.");
+    fail("repository.url (\"" + repoUrl + "\") does not point at the public " + PUBLIC_REPO_MARKER + " repo — it must not reference a private repo (e.g. samwelmunga/Jenga AI) or any other location.");
   } else {
     pass("repository.url points at the public " + PUBLIC_REPO_MARKER + " repo.");
   }

package/skills/distribute/CONFIG_SCHEMA.md

@@ -6,7 +6,7 @@ This document is the canonical reference for the `jenga.config.json` file writte
 
 ## Purpose
 
-`jenga.config.json` lives at the root of a consuming project and tracks which version of the JengaAgent framework is currently installed there, where the framework files were placed, and when the last distribution occurred. It is read by the distribution script on subsequent runs to determine the target directory and detect whether an upgrade is needed.
+`jenga.config.json` lives at the root of a consuming project and tracks which version of the Jenga AI framework is currently installed there, where the framework files were placed, and when the last distribution occurred. It is read by the distribution script on subsequent runs to determine the target directory and detect whether an upgrade is needed.
 
 ---
 
@@ -40,17 +40,17 @@ This document is the canonical reference for the `jenga.config.json` file writte
 |---|---|---|---|---|
 | `project_name` | string | yes | — | Human-readable identifier for the consuming project. Must match the `name` field of the corresponding entry in the monorepo's `distribute.config.json`. |
 | `target_dir` | string | yes | `.agents` | The directory under the project root where framework files are copied. `distribute-changes.sh` reads this field to resolve the destination path on every run. Change this only if the consuming project uses a non-standard layout. |
-| `version` | string | yes | — | The JengaAgent semantic version currently installed in this project (e.g. `"2.3.1"`). Compared against the `version` field in the monorepo's `package.json` to determine whether an upgrade is required. |
+| `version` | string | yes | — | The Jenga AI semantic version currently installed in this project (e.g. `"2.3.1"`). Compared against the `version` field in the monorepo's `package.json` to determine whether an upgrade is required. |
 | `updated_at` | string (ISO 8601 date) | yes | — | Date of the last successful distribution, in `YYYY-MM-DD` format. Does **not** include a time component. |
 | `last_distributed` | string (ISO 8601 datetime) | yes | — | Full UTC timestamp of the last successful distribution, in `YYYY-MM-DDTHH:MM:SSZ` format. Provides more precision than `updated_at` and is useful for audit and ordering purposes. |
 | `source` | string | yes | `"private"` | Distribution channel. Always `"private"` for projects that receive updates via the filesystem distribution mechanism. Distinguishes these projects from any future npm-installed consumers. Do not change this value manually. |
-| `project_files_visibility` | string (enum) | no | `"visible"` | How JengaAgent's own working files appear in the consuming project. Exactly one of `visible` or `ignored` — no other value is accepted. Written by `/init`, not by distribution. See [Project files visibility](#project-files-visibility) below. |
+| `project_files_visibility` | string (enum) | no | `"visible"` | How Jenga AI's own working files appear in the consuming project. Exactly one of `visible` or `ignored` — no other value is accepted. Written by `/init`, not by distribution. See [Project files visibility](#project-files-visibility) below. |
 
 ---
 
 ## Project files visibility
 
-`project_files_visibility` controls how JengaAgent's own working files — the `project/` tree containing the scrum board, `todo.md`, `queue/`, `rapports/`, and `logs/` — appear in a consuming project.
+`project_files_visibility` controls how Jenga AI's own working files — the `project/` tree containing the scrum board, `todo.md`, `queue/`, `rapports/`, and `logs/` — appear in a consuming project.
 
 This is distinct from `target_dir`. `target_dir` governs where the **distributed framework files** (skill and agent definitions) land; `project_files_visibility` governs the **working tree** that accumulates as the framework is used.
 

package/skills/distribute/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: distribute
-description: Distribute JengaAgent framework files from this private monorepo to one or more consuming projects via the local filesystem. Manages release type selection, version bumping, dry-run preview, per-target file copy, and a post-distribution git commit.
+description: Distribute Jenga AI framework files from this private monorepo to one or more consuming projects via the local filesystem. Manages release type selection, version bumping, dry-run preview, per-target file copy, and a post-distribution git commit.
 keywords:
   - distribute
   - private distribution
@@ -16,7 +16,7 @@ examples:
 
 # Distribute
 
-Copies JengaAgent framework files from this monorepo to all active consuming projects registered in `distribute.config.json`. Manages the full version lifecycle: release type selection, `package.json` version bump, dry-run preview, per-target file copy, and a final git commit of the version bump.
+Copies Jenga AI framework files from this monorepo to all active consuming projects registered in `distribute.config.json`. Manages the full version lifecycle: release type selection, `package.json` version bump, dry-run preview, per-target file copy, and a final git commit of the version bump.
 
 Distinct from `/self-sync` (which mirrors root → in-repo `.claude/.agents/`) and `/mirror-public` (which syncs to the public GitHub repo). Do not call either of those skills from within this flow.
 

package/skills/distribute/scripts/distribute-changes.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# distribute-changes.sh — Copy JengaAgent framework files into a consuming project
+# distribute-changes.sh — Copy Jenga AI framework files into a consuming project
 #
 # Usage:
 #   distribute-changes.sh <project_path> [--dry-run]

package/skills/doc/SKILL.md

@@ -39,7 +39,7 @@ After target resolution, all generation must operate on a synthesis context obje
 ```yaml
 target_path: README.md
 objective: project overview
-project_name: JengaAgent
+project_name: Jenga AI
 project_description: Structured multi-agent development workflow
 features: []
 getting_started: []

package/skills/init/SKILL.md

@@ -67,11 +67,11 @@ changes nothing on disk, so it is the only safe default.
 Never treat `existing-codebase` as if it were `empty`, and never skip straight to step 2
 on that verdict without the user (or the non-interactive default) choosing to.
 
-### 2. Ask how JengaAgent's working files should appear
+### 2. Ask how Jenga AI's working files should appear
 
 Ask the user this question, verbatim, before running any script:
 
-    How should JengaAgent's own working files (project/ — the scrum board, todo.md,
+    How should Jenga AI's own working files (project/ — the scrum board, todo.md,
     queue/, rapports/, and logs/) appear in this project?
     1. Visible — keep them at `project/`, tracked and visible in directory listings
     2. Ignored — keep them at `project/` but add them to `.gitignore` so they are never committed
@@ -96,10 +96,26 @@ of the mechanical work.
 
 ### 3. Run the scaffold script
 
-Execute the init script from the project root, passing the choice from step 2:
+`init.sh` is not guaranteed to live at a single fixed path: in a project that
+installed Jenga via npm, it was mirrored to `.claude/skills/init/scripts/`
+(Claude Code) and `.agents/skills/init/scripts/` (Copilot/other agents) by
+`postinstall.js`, and neither of those exists yet in this framework's own
+source checkout, where it lives at the bare `skills/init/scripts/` path
+instead. This step runs before `CLAUDE.md`/`AGENTS.md` exist, so it cannot
+rely on either file's routing instructions to resolve the path — it must
+locate its own script directly. Execute the init script from the project
+root, passing the choice from step 2:
 
 ```bash
-chmod +x ./scripts/init.sh && ./scripts/init.sh --visibility <visible|ignored>
+INIT_SCRIPT=""
+for candidate in .claude/skills/init/scripts/init.sh .agents/skills/init/scripts/init.sh skills/init/scripts/init.sh; do
+  [[ -f "$candidate" ]] && { INIT_SCRIPT="$candidate"; break; }
+done
+if [[ -z "$INIT_SCRIPT" ]]; then
+  echo "Error: could not locate init.sh under .claude/skills/, .agents/skills/, or skills/" >&2
+  exit 1
+fi
+chmod +x "$INIT_SCRIPT" && "$INIT_SCRIPT" --visibility <visible|ignored>
 ```
 
 Omitting `--visibility` falls back to the `JENGA_PROJECT_FILES_VISIBILITY`

package/skills/init/scripts/apply-project-visibility.sh

@@ -41,7 +41,7 @@ usage() {
   exit 1
 }
 
-# Every JengaAgent working file named in E31_S05 — the scrum board, todo.md,
+# Every Jenga AI working file named in E31_S05 — the scrum board, todo.md,
 # queue/, rapports/ and logs/ — nests under this single root, so one entry
 # covers them all. `ignored` consumes this list.
 JENGA_WORKING_PATHS=("project")

package/skills/init/scripts/init.sh

@@ -5,6 +5,23 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ASSETS_DIR="$SCRIPT_DIR/../assets"
 VISIBILITY_SCRIPT="$SCRIPT_DIR/apply-project-visibility.sh"
 
+# ─── Resolve the package root that owns templates/ and lib/ ──────────────────
+# postinstall.js mirrors only skills/ and agents/ into .claude/ and .agents/ —
+# templates/ and lib/ are never copied there, so a script running from a
+# mirrored copy (.claude/skills/init/scripts/ or .agents/skills/init/scripts/)
+# cannot reach its siblings via a fixed ../../../ climb the way it can in this
+# monorepo checkout, where init.sh actually lives at skills/init/scripts/ with
+# templates/ and lib/ three levels up. Consumers instead have them inside the
+# installed npm package.
+if [[ -d "$SCRIPT_DIR/../../../templates" ]]; then
+  PKG_ROOT="$SCRIPT_DIR/../../.."
+elif [[ -d "$PWD/node_modules/@jenga-ai/agent/templates" ]]; then
+  PKG_ROOT="$PWD/node_modules/@jenga-ai/agent"
+else
+  echo "Error: could not locate the jenga-agent package root (templates/ not found via monorepo checkout or node_modules/@jenga-ai/agent)." >&2
+  exit 1
+fi
+
 # ─── 0. Resolve project_files_visibility ─────────────────────────────────────
 # Defaults to `visible` — the only value that touches nothing on disk — so an
 # unattended run can never silently relocate directories or edit .gitignore.
@@ -65,7 +82,7 @@ cp "$ASSETS_DIR/strategy_stub_template.md" docs/STRATEGY.md
 
 # ─── 10. Create CHANGELOG.md ──────────────────────────────────────────────────
 echo "→ Creating CHANGELOG.md from template..."
-cp "$SCRIPT_DIR/../../../templates/CHANGELOG_TEMPLATE.md" CHANGELOG.md
+cp "$PKG_ROOT/templates/CHANGELOG_TEMPLATE.md" CHANGELOG.md
 
 # ─── 11. Apply project_files_visibility ──────────────────────────────────────
 # Runs before the commit so the .gitignore entry (ignored) is captured in the
@@ -79,7 +96,7 @@ bash "$VISIBILITY_SCRIPT" "$VISIBILITY" "$PWD"
 # lib/generate-agent-context.js (shared with the published `jenga init` CLI).
 echo "→ Generating CLAUDE.md / AGENTS.md..."
 if command -v node >/dev/null 2>&1; then
-  node "$SCRIPT_DIR/../../../lib/generate-agent-context.js" "$PWD"
+  node "$PKG_ROOT/lib/generate-agent-context.js" "$PWD"
 else
   echo "  Warning: node not found — skipped CLAUDE.md/AGENTS.md generation." >&2
 fi

package/skills/publish/scripts/npm_pipeline.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
-# npm_pipeline.sh — Execute the npm publish pipeline for the JengaAgent repo.
+# npm_pipeline.sh — Execute the npm publish pipeline for the Jenga AI repo.
 #
-# Runs from the JengaAgent repo root (where package.json lives) and invokes
+# Runs from the Jenga AI repo root (where package.json lives) and invokes
 # `npm publish --tag <dist_tag>` (or `--dry-run` when requested).
 #
 # Exit codes:

package/skills/uncharted/scripts/discover-subsystems.sh

@@ -45,10 +45,10 @@
 #                        itself. The epic cap — and the surfacing of anything it drops — is
 #                        applied by a separate layer on top of this script's output.
 #   --include-framework  Do not exclude Jenga scaffolding. Needed to point the script at the
-#                        JengaAgent repo itself, where the scaffolding IS the application.
+#                        Jenga AI repo itself, where the scaffolding IS the application.
 #   --include-training-scaffolding
 #                        Do not exclude .training/ job-template scaffolding. Needed to point the
-#                        script at JengaAgent's own /train subsystem, or at a project that
+#                        script at Jenga AI's own /train subsystem, or at a project that
 #                        genuinely wants job templates catalogued as a candidate.
 #   --with-dependencies  Additionally compute the "cohesion" signal by calling
 #                        detect-dependencies.sh once per candidate. Off by default: it is an