@forwardimpact/pathway 0.25.8 → 0.25.10

package/bin/fit-pathway.js

@@ -104,7 +104,7 @@ GETTING STARTED
   init                                Create ./data/ with example data
   dev [--port=PORT]                   Run live development server
   build [--output=PATH] [--url=URL]   Generate static site + distribution bundle
-  update [--url=URL]                  Update local ~/.fit/pathway/ installation
+  update [--url=URL]                  Update local ~/.fit/data/pathway/ installation
 
 ────────────────────────────────────────────────────────────────────────────────
 ENTITY COMMANDS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.25.8",
+  "version": "0.25.10",
   "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {

package/src/commands/agent.js

@@ -38,6 +38,7 @@ import {
   deriveToolkit,
   getDisciplineAbbreviation,
   toKebabCase,
+  interpolateTeamInstructions,
 } from "@forwardimpact/libskill";
 import { formatAgentProfile } from "../formatters/agent/profile.js";
 import {
@@ -207,6 +208,21 @@ async function writeProfile(profile, baseDir, template) {
   return profilePath;
 }
 
+/**
+ * Write team instructions to CLAUDE.md
+ * @param {string|null} teamInstructions - Interpolated team instructions content
+ * @param {string} baseDir - Base output directory
+ * @returns {string|null} Path written, or null if skipped
+ */
+async function writeTeamInstructions(teamInstructions, baseDir) {
+  if (!teamInstructions) return null;
+  const filePath = join(baseDir, ".claude", "CLAUDE.md");
+  await ensureDir(filePath);
+  await writeFile(filePath, teamInstructions.trim() + "\n", "utf-8");
+  console.log(formatSuccess(`Created: ${filePath}`));
+  return filePath;
+}
+
 /**
  * Write skill files (SKILL.md, scripts/install.sh, references/REFERENCE.md)
  * @param {Array} skills - Generated skills
@@ -434,10 +450,18 @@ export async function runAgentCommand({
 
     // Output to console (default) or write to files (with --output)
     if (!options.output) {
+      const teamInstructions = interpolateTeamInstructions(agentTrack, humanDiscipline);
+      if (teamInstructions) {
+        console.log("# Team Instructions (CLAUDE.md)\n");
+        console.log(teamInstructions.trim());
+        console.log("\n---\n");
+      }
       console.log(formatAgentProfile(profile, agentTemplate));
       return;
     }
 
+    const teamInstructions = interpolateTeamInstructions(agentTrack, humanDiscipline);
+    await writeTeamInstructions(teamInstructions, baseDir);
     await writeProfile(profile, baseDir, agentTemplate);
     await generateClaudeCodeSettings(baseDir, agentData.claudeCodeSettings);
     console.log("");
@@ -516,6 +540,12 @@ export async function runAgentCommand({
 
   // Output to console (default) or write to files (with --output)
   if (!options.output) {
+    const teamInstructions = interpolateTeamInstructions(agentTrack, humanDiscipline);
+    if (teamInstructions) {
+      console.log("# Team Instructions (CLAUDE.md)\n");
+      console.log(teamInstructions.trim());
+      console.log("\n---\n");
+    }
     for (const profile of profiles) {
       console.log(formatAgentProfile(profile, agentTemplate));
       console.log("\n---\n");
@@ -523,6 +553,8 @@ export async function runAgentCommand({
     return;
   }
 
+  const teamInstructions = interpolateTeamInstructions(agentTrack, humanDiscipline);
+  await writeTeamInstructions(teamInstructions, baseDir);
   for (const profile of profiles) {
     await writeProfile(profile, baseDir, agentTemplate);
   }

package/src/commands/update.js

@@ -2,7 +2,7 @@
  * Update Command
  *
  * Re-downloads the distribution bundle from the published site URL
- * and updates the local ~/.fit/pathway/ installation.
+ * and updates the local ~/.fit/data/pathway/ installation.
  * Updates the global @forwardimpact/pathway package if the version changed.
  */
 
@@ -10,9 +10,11 @@ import { cp, mkdir, rm, readFile, writeFile, access } from "fs/promises";
 import { join } from "path";
 import { homedir } from "os";
 import { execFileSync } from "child_process";
+import { tmpdir } from "os";
 import { createDataLoader } from "@forwardimpact/map/loader";
 
-const INSTALL_DIR = join(homedir(), ".fit", "pathway");
+const BASE_DIR = join(homedir(), ".fit", "data");
+const INSTALL_DIR = join(BASE_DIR, "pathway");
 
 /**
  * Run the update command.
@@ -24,13 +26,11 @@ const INSTALL_DIR = join(homedir(), ".fit", "pathway");
  * @param {Object} params.options - Command options
  */
 export async function runUpdateCommand({ dataDir: _dataDir, options }) {
-  const installDataDir = join(INSTALL_DIR, "data");
-
   // Verify we have a home-directory installation
   try {
-    await access(installDataDir);
+    await access(INSTALL_DIR);
   } catch {
-    console.error("Error: No local installation found at ~/.fit/pathway/");
+    console.error("Error: No local installation found at ~/.fit/data/pathway/");
     console.error(
       "Install first using the install.sh script from your organization's pathway site.",
     );
@@ -39,12 +39,12 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
 
   // Load framework config to get siteUrl
   const loader = createDataLoader();
-  const framework = await loader.loadFrameworkConfig(installDataDir);
+  const framework = await loader.loadFrameworkConfig(INSTALL_DIR);
   const siteUrl = options.url || framework.distribution?.siteUrl;
 
   if (!siteUrl) {
     console.error(
-      "Error: No siteUrl found in ~/.fit/pathway/data/framework.yaml (distribution.siteUrl)",
+      "Error: No siteUrl found in ~/.fit/data/pathway/framework.yaml (distribution.siteUrl)",
     );
     console.error("Provide one with --url=<URL> or add it to framework.yaml.");
     process.exit(1);
@@ -56,7 +56,7 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
   console.log(`\n🔄 Updating from ${baseUrl}...\n`);
 
   // 1. Download bundle to temp location
-  const tmpDir = join(INSTALL_DIR, "_update_tmp");
+  const tmpDir = join(tmpdir(), "fit-pathway-update");
   await mkdir(tmpDir, { recursive: true });
 
   const tmpBundle = join(tmpDir, bundleName);
@@ -86,7 +86,7 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
 
     // 3. Compare versions from bundle's package.json (version manifest)
     const newPkgPath = join(extractDir, "package.json");
-    const oldPkgPath = join(INSTALL_DIR, "package.json");
+    const oldPkgPath = join(BASE_DIR, "package.json");
     const newPkg = JSON.parse(await readFile(newPkgPath, "utf8"));
     let oldPkg;
     try {
@@ -102,8 +102,8 @@ export async function runUpdateCommand({ dataDir: _dataDir, options }) {
 
     // 4. Replace data
     console.log("   Updating data files...");
-    await rm(installDataDir, { recursive: true });
-    await cp(join(extractDir, "data"), installDataDir, { recursive: true });
+    await rm(INSTALL_DIR, { recursive: true });
+    await cp(join(extractDir, "data"), INSTALL_DIR, { recursive: true });
     console.log("   ✓ Data updated");
 
     // 5. Update version manifest

package/src/formatters/agent/dom.js

@@ -18,6 +18,7 @@ import { getStageEmoji } from "../stage/shared.js";
  * @param {Array} deployment.skills - Agent skills
  * @param {Array} [deployment.roleAgents] - Role variant agents (plan, review)
  * @param {Object} [deployment.claudeCodeSettings] - Claude Code settings to include in download
+ * @param {string|null} [deployment.teamInstructions] - Team instructions content for CLAUDE.md
  * @returns {HTMLElement}
  */
 export function agentDeploymentToDOM({
@@ -25,6 +26,7 @@ export function agentDeploymentToDOM({
   skills,
   roleAgents = [],
   claudeCodeSettings = {},
+  teamInstructions = null,
 }) {
   const profileContent = formatAgentProfile(profile);
   const agentName = profile.frontmatter.name;
@@ -39,6 +41,7 @@ export function agentDeploymentToDOM({
       roleAgents,
       claudeCodeSettings,
       agentName,
+      teamInstructions,
     ),
 
     // Profile section
@@ -92,6 +95,7 @@ export function agentDeploymentToDOM({
  * @param {Array} roleAgents - Role variant agents
  * @param {Object} claudeCodeSettings - Claude Code settings to include
  * @param {string} agentName - Agent name for zip filename
+ * @param {string|null} teamInstructions - Team instructions content for CLAUDE.md
  * @returns {HTMLElement}
  */
 function createDownloadButton(
@@ -100,6 +104,7 @@ function createDownloadButton(
   roleAgents,
   claudeCodeSettings,
   agentName,
+  teamInstructions,
 ) {
   const btn = button(
     { className: "btn btn-primary download-all-btn" },
@@ -117,6 +122,7 @@ function createDownloadButton(
         roleAgents,
         claudeCodeSettings,
         agentName,
+        teamInstructions,
       );
     } finally {
       btn.disabled = false;
@@ -169,6 +175,7 @@ function createRoleAgentCard(agent) {
  * @param {Array} roleAgents - Role variant agents
  * @param {Object} claudeCodeSettings - Claude Code settings to include
  * @param {string} agentName - Agent name for zip filename
+ * @param {string|null} teamInstructions - Team instructions content for CLAUDE.md
  */
 async function downloadAllAsZip(
   profile,
@@ -176,6 +183,7 @@ async function downloadAllAsZip(
   roleAgents,
   claudeCodeSettings,
   agentName,
+  teamInstructions,
 ) {
   // Dynamically import JSZip
   const JSZip = await importJSZip();
@@ -185,6 +193,11 @@ async function downloadAllAsZip(
   const profileContent = formatAgentProfile(profile);
   zip.file(`.claude/agents/${profile.filename}`, profileContent);
 
+  // Add team instructions to .claude/CLAUDE.md
+  if (teamInstructions) {
+    zip.file(".claude/CLAUDE.md", teamInstructions.trim() + "\n");
+  }
+
   // Add role agent profiles to .claude/agents/ folder
   for (const roleAgent of roleAgents) {
     const roleContent = formatAgentProfile(roleAgent);

package/templates/install.template.sh

@@ -3,7 +3,7 @@
 # Generated by @forwardimpact/pathway v{{{version}}}
 #
 # Installs fit-pathway globally via bun and downloads organization data
-# to ~/.fit/pathway/data/.
+# to ~/.fit/data/pathway/.
 #
 # Usage:
 #   curl -fsSL {{{siteUrl}}}/install.sh | bash
@@ -11,7 +11,7 @@
 set -euo pipefail
 
 SITE_URL="{{{siteUrl}}}"
-INSTALL_DIR="${HOME}/.fit/pathway"
+INSTALL_DIR="${HOME}/.fit/data/pathway"
 
 command -v bun >/dev/null 2>&1 || { echo "Error: Bun 1.2+ is required. https://bun.sh"; exit 1; }
 
@@ -19,14 +19,16 @@ command -v bun >/dev/null 2>&1 || { echo "Error: Bun 1.2+ is required. https://b
 echo "Installing @forwardimpact/pathway globally..."
 bun install -g @forwardimpact/pathway@{{{version}}}
 
-# Download organization data to ~/.fit/pathway/data/
-echo "Downloading organization data to ${INSTALL_DIR}/data/..."
+# Download organization data to ~/.fit/data/pathway/
+echo "Downloading organization data to ${INSTALL_DIR}..."
 mkdir -p "${INSTALL_DIR}"
 
-TMPFILE=$(mktemp)
-trap 'rm -f "$TMPFILE"' EXIT
-curl -fsSL "${SITE_URL}/bundle.tar.gz" -o "$TMPFILE"
-tar -xzf "$TMPFILE" -C "${INSTALL_DIR}" --strip-components=1
+TMPDIR_INSTALL=$(mktemp -d)
+trap 'rm -rf "$TMPDIR_INSTALL"' EXIT
+curl -fsSL "${SITE_URL}/bundle.tar.gz" -o "${TMPDIR_INSTALL}/bundle.tar.gz"
+tar -xzf "${TMPDIR_INSTALL}/bundle.tar.gz" -C "${TMPDIR_INSTALL}" --strip-components=1
+cp -R "${TMPDIR_INSTALL}/data/." "${INSTALL_DIR}/"
+cp "${TMPDIR_INSTALL}/package.json" "${HOME}/.fit/data/package.json" 2>/dev/null || true
 
 echo ""
 echo "Done. Usage:"