@forwardimpact/pathway 0.25.8 → 0.25.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.25.8",
+  "version": "0.25.9",
   "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/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);