@teammates/cli 0.2.3 → 0.2.5

package/dist/adapters/cli-proxy.js

@@ -114,8 +114,9 @@ export class CliProxyAdapter {
         // Create session file inside .teammates/.tmp so sandboxed agents can access it
         if (!this.sessionsDir) {
             const tmpBase = join(teammate.cwd ?? process.cwd(), ".teammates", ".tmp");
-            this.sessionsDir = join(tmpBase, "sessions");
-            await mkdir(this.sessionsDir, { recursive: true });
+            const dir = join(tmpBase, "sessions");
+            await mkdir(dir, { recursive: true });
+            this.sessionsDir = dir;
             // Ensure .tmp is gitignored
             const gitignorePath = join(tmpBase, "..", ".gitignore");
             const existing = await readFile(gitignorePath, "utf-8").catch(() => "");

package/dist/adapters/copilot.js

@@ -39,8 +39,9 @@ export class CopilotAdapter {
         // Create session file inside .teammates/.tmp so the agent can access it
         if (!this.sessionsDir) {
             const tmpBase = join(teammate.cwd ?? process.cwd(), ".teammates", ".tmp");
-            this.sessionsDir = join(tmpBase, "sessions");
-            await mkdir(this.sessionsDir, { recursive: true });
+            const dir = join(tmpBase, "sessions");
+            await mkdir(dir, { recursive: true });
+            this.sessionsDir = dir;
             const gitignorePath = join(tmpBase, "..", ".gitignore");
             const existing = await readFile(gitignorePath, "utf-8").catch(() => "");
             if (!existing.includes(".tmp/")) {

package/dist/cli.js

@@ -11,7 +11,7 @@ import { spawn as cpSpawn, exec as execCb, execSync, } from "node:child_process"
 import { appendFileSync, readFileSync, writeFileSync } from "node:fs";
 import { mkdir, readdir, rm, stat, unlink } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join, resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline";
 import { promisify } from "node:util";
 const execAsync = promisify(execCb);
@@ -1431,16 +1431,22 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         const teammatesDir = join(projectDir, ".teammates");
         console.log();
         try {
-            const { teammates, files } = await importTeammates(sourceDir, teammatesDir);
-            if (teammates.length === 0) {
+            const { teammates, skipped, files } = await importTeammates(sourceDir, teammatesDir);
+            const allTeammates = [...teammates, ...skipped];
+            if (allTeammates.length === 0) {
                 console.log(chalk.yellow("  No teammates found at ") + chalk.white(sourceDir));
                 console.log(chalk.gray("  The directory should contain teammate folders (each with a SOUL.md)."));
                 return;
             }
-            console.log(chalk.green("  ✔") +
-                chalk.white(` Imported ${teammates.length} teammate${teammates.length > 1 ? "s" : ""}: `) +
-                chalk.cyan(teammates.join(", ")));
-            console.log(chalk.gray(`    (${files.length} files copied)`));
+            if (teammates.length > 0) {
+                console.log(chalk.green("  ✔") +
+                    chalk.white(` Imported ${teammates.length} teammate${teammates.length > 1 ? "s" : ""}: `) +
+                    chalk.cyan(teammates.join(", ")));
+                console.log(chalk.gray(`    (${files.length} files copied)`));
+            }
+            if (skipped.length > 0) {
+                console.log(chalk.gray(`  ${skipped.length} already present: ${skipped.join(", ")} (will re-adapt)`));
+            }
             console.log();
             // Copy framework files so the agent has TEMPLATE.md etc. available
             await copyTemplateFiles(teammatesDir);
@@ -1452,7 +1458,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             console.log();
             const adapt = await this.askChoice("Adapt now? (y/n): ", ["y", "n"]);
             if (adapt === "y") {
-                await this.runAdaptationAgent(this.adapter, projectDir, teammates, sourceDir);
+                await this.runAdaptationAgent(this.adapter, projectDir, allTeammates, sourceDir);
             }
             else {
                 console.log(chalk.gray("  Skipped adaptation. Run /init to adapt later."));
@@ -1974,6 +1980,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             weeklyLogs: [],
             ownership: { primary: [], secondary: [] },
             routingKeywords: [],
+            cwd: dirname(this.teammatesDir),
         });
         // Add status entry (init() already ran, so we add it manually)
         this.orchestrator.getAllStatuses().set(this.adapterName, { state: "idle" });
@@ -3010,18 +3017,25 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 sourceDir = resolved;
             }
             try {
-                const { teammates, files } = await importTeammates(sourceDir, teammatesDir);
-                if (teammates.length === 0) {
+                const { teammates, skipped, files } = await importTeammates(sourceDir, teammatesDir);
+                // Combine newly imported + already existing for adaptation
+                const allTeammates = [...teammates, ...skipped];
+                if (allTeammates.length === 0) {
                     this.feedLine(tp.warning(`  No teammates found at ${sourceDir}`));
                     this.refreshView();
                     return;
                 }
-                this.feedLine(tp.success(`  Imported ${teammates.length} teammate${teammates.length > 1 ? "s" : ""}: ${teammates.join(", ")} (${files.length} files)`));
+                if (teammates.length > 0) {
+                    this.feedLine(tp.success(`  Imported ${teammates.length} teammate${teammates.length > 1 ? "s" : ""}: ${teammates.join(", ")} (${files.length} files)`));
+                }
+                if (skipped.length > 0) {
+                    this.feedLine(tp.muted(`  ${skipped.length} already present: ${skipped.join(", ")} (will re-adapt)`));
+                }
                 // Copy framework files so the agent has TEMPLATE.md etc. available
                 await copyTemplateFiles(teammatesDir);
                 // Queue a single adaptation task that handles all teammates
                 this.feedLine(tp.muted(`  Queuing ${this.adapterName} to scan this project and adapt the team...`));
-                const prompt = await buildImportAdaptationPrompt(teammatesDir, teammates, sourceDir);
+                const prompt = await buildImportAdaptationPrompt(teammatesDir, allTeammates, sourceDir);
                 this.taskQueue.push({
                     type: "agent",
                     teammate: this.adapterName,

package/dist/onboard.d.ts

@@ -25,16 +25,13 @@ export declare function copyTemplateFiles(teammatesDir: string): Promise<string[
  */
 export declare function importTeammates(sourceDir: string, targetDir: string): Promise<{
     teammates: string[];
+    skipped: string[];
     files: string[];
 }>;
 /**
- * Build a comprehensive import-adaptation prompt that runs as a single agent session.
- * The agent will:
- * 1. Scan the current project
- * 2. Evaluate which imported teammates are needed
- * 3. Adapt kept teammates (add Previous Projects section + rewrite for new project)
- * 4. Create any new teammates the project needs
- * 5. Remove teammates that don't apply
+ * Build an import-adaptation prompt that runs as a single non-interactive agent session.
+ * The agent scans the target project and adapts all imported teammates in one pass.
+ * No pauses or approval gates — the agent must complete all work autonomously.
  *
  * @param teammatesDir - The .teammates/ directory in the target project
  * @param teammateNames - Names of all imported teammates

package/dist/onboard.js

@@ -129,6 +129,7 @@ export async function importTeammates(sourceDir, targetDir) {
     }
     await mkdir(targetDir, { recursive: true });
     const teammates = [];
+    const skipped = [];
     const files = [];
     const entries = await readdir(sourceDir, { withFileTypes: true });
     for (const entry of entries) {
@@ -140,6 +141,7 @@ export async function importTeammates(sourceDir, targetDir) {
                 // Skip if teammate already exists in target
                 try {
                     await stat(destPath);
+                    skipped.push(entry.name);
                     continue;
                 }
                 catch {
@@ -185,16 +187,12 @@ export async function importTeammates(sourceDir, targetDir) {
         await writeFile(gitignoreDest, "USER.md\n.*/\n", "utf-8");
         files.push(".gitignore");
     }
-    return { teammates, files };
+    return { teammates, skipped, files };
 }
 /**
- * Build a comprehensive import-adaptation prompt that runs as a single agent session.
- * The agent will:
- * 1. Scan the current project
- * 2. Evaluate which imported teammates are needed
- * 3. Adapt kept teammates (add Previous Projects section + rewrite for new project)
- * 4. Create any new teammates the project needs
- * 5. Remove teammates that don't apply
+ * Build an import-adaptation prompt that runs as a single non-interactive agent session.
+ * The agent scans the target project and adapts all imported teammates in one pass.
+ * No pauses or approval gates — the agent must complete all work autonomously.
  *
  * @param teammatesDir - The .teammates/ directory in the target project
  * @param teammateNames - Names of all imported teammates
@@ -227,101 +225,83 @@ export async function buildImportAdaptationPrompt(teammatesDir, teammateNames, s
         teammateSections.push(`### @${name}\n${soulBlock}${wisdomBlock}`);
     }
     const projectDir = dirname(teammatesDir);
-    return `You are adapting an imported team to a new project.
+    return `You are adapting an imported team to a new project. This is a non-interactive session — complete ALL work without pausing. Do not ask for confirmation or wait for user input.
 
 **Source project:** \`${sourceProjectPath}\`
 **Target project:** \`${projectDir}\`
 **Target .teammates/ directory:** \`${teammatesDir}\`
 **Imported teammates:** ${teammateNames.map((n) => `@${n}`).join(", ")}
 
+> **IMPORTANT:** The \`example/\` directory inside \`.teammates/\` is a **template reference**, NOT a teammate. Do not adapt it, rename it, or treat it as a teammate. When creating new teammates, never use "example" as a folder name.
+
 ## Imported Teammates (from source project)
 
 ${teammateSections.join("\n\n---\n\n")}
 
 ## Instructions
 
-Work through these phases in order. **Pause after Phase 1 and Phase 2** to present your analysis and get user approval before making changes.
-
-### Phase 1: Scan This Project
-
-Analyze the current project to understand its structure:
-- Read the project root: package manifest, README, config files
-- Identify major subsystems, languages, frameworks, file patterns
-- Understand the dependency flow and architecture
-
-**Present your analysis to the user and wait for confirmation.**
+Complete these steps in order. Do NOT pause, ask questions, or wait for approval. Make all changes directly.
 
-### Phase 2: Evaluate Imported Teammates
+### Step 1: Scan This Project
 
-For each imported teammate, decide:
-- **KEEP** — their domain or expertise is relevant to this project (even if specific details need updating)
-- **DROP** — their domain doesn't exist here and their skills aren't transferable
+Read the project root to understand its structure:
+- Package manifest, README, config files
+- Major subsystems, languages, frameworks, file patterns
+- Dependency flow and architecture
 
-Also identify **gaps** — major subsystems in this project that none of the imported teammates cover. Propose new teammates for these gaps.
+### Step 2: Adapt EVERY Imported Teammate
 
-**Present your evaluation as a structured plan and wait for user approval:**
-\`\`\`
-KEEP: @name1, @name2
-DROP: @name3
-CREATE: @newname (role description)
-\`\`\`
+This is the most important step. For EACH imported teammate listed above, you MUST edit their SOUL.md and WISDOM.md to reflect THIS project, not the source project.
 
-### Phase 3: Adapt Kept Teammates
+For each teammate's **SOUL.md**:
 
-For each KEEP teammate, edit their SOUL.md and WISDOM.md:
-
-1. **Add a "Previous Projects" section** to SOUL.md (place it after Ethics, before any appendix). Compress what the teammate did in the source project into a portable summary:
+1. **Add a "Previous Projects" section** (place it after Ethics). Compress what the teammate did in the source project:
    \`\`\`markdown
    ## Previous Projects
 
-   ### <project-name>
+   ### <source-project-name>
    - **Role**: <one-line summary of what they did>
    - **Stack**: <key technologies they worked with>
    - **Domains**: <what they owned — file patterns or subsystem names>
    - **Key learnings**: <1-3 bullets of notable patterns, decisions, or lessons>
    \`\`\`
 
-2. **Rewrite the rest of SOUL.md** for this project:
+2. **Rewrite project-specific sections** for THIS project:
    - **Preserve**: Identity (name, personality), Core Principles, Ethics
-   - **Rewrite**: Ownership (primary/secondary file globs for THIS project), Boundaries, Capabilities (commands, file patterns, technologies), Routing keywords, Quality Bar
-   - **Update**: Any codebase-specific references (paths, package names, tools, teammate names)
-
-3. **Update WISDOM.md**:
-   - **Add** a "Previous Projects" section at the top with a compressed note:
-     \`\`\`markdown
-     ## Previous Projects
-
-     ### <project-name>
-     - Carried over universal wisdom entries from the source project
-     - Project-specific entries removed or adapted
-     \`\`\`
-   - **Keep** wisdom entries that are universal (general principles, patterns, lessons)
-   - **Remove** entries that reference source project paths, architecture, or tools not used here
-   - **Adapt** entries with transferable knowledge but old-project-specific details
-
-### Phase 4: Handle Dropped Teammates
+   - **Rewrite completely**: Ownership (primary/secondary file globs for THIS project's actual files), Boundaries, Capabilities (commands, file patterns, technologies for THIS project), Routing keywords, Quality Bar
+   - **Update**: All codebase-specific references — paths, package names, tools, teammate names must reference THIS project
 
-For each DROP teammate, delete their directory under \`${teammatesDir}\`.
+For each teammate's **WISDOM.md**:
+- Add a "Previous Projects" note at the top
+- Keep universal wisdom entries (general principles, patterns)
+- Remove entries that reference source project paths, architecture, or tools not used here
+- Adapt entries with transferable knowledge but old-project-specific details
 
-### Phase 5: Create New Teammates
+### Step 3: Evaluate Gaps and Create New Teammates
 
-For each new teammate proposed in Phase 2 (after user approval):
+After adapting all existing teammates, check if THIS project has major subsystems that no teammate covers. If so, create new teammates:
 - Create \`${teammatesDir}/<name>/\` with SOUL.md, WISDOM.md, and \`memory/\`
 - Use the template at \`${teammatesDir}/TEMPLATE.md\` for structure
 - WISDOM.md starts with one creation entry
 
-### Phase 6: Update Framework Files
+If a teammate's domain doesn't exist at all in this project and their skills aren't transferable, delete their directory under \`${teammatesDir}\`.
+
+### Step 4: Update Framework Files
 
 - Update \`${teammatesDir}/README.md\` with the final roster
 - Update \`${teammatesDir}/CROSS-TEAM.md\` ownership table
 
-### Phase 7: Verify
+### Step 5: Verify
 
-- Every kept/new teammate has SOUL.md and WISDOM.md
-- Ownership globs cover the codebase without major gaps
-- Boundaries reference the correct owning teammate
+- Every teammate has SOUL.md and WISDOM.md adapted to THIS project
+- Ownership globs reference actual files in THIS project
+- Boundaries reference correct teammate names
 - Previous Projects sections are present for all imported teammates
-- CROSS-TEAM.md has one row per teammate`;
+- CROSS-TEAM.md has one row per teammate
+
+## Critical Reminder
+
+The PRIMARY goal is adapting the imported teammates. Every SOUL.md must be rewritten so the teammate understands THIS project's codebase, not the source project's. If you only have time for one thing, adapt the existing teammates — that is more important than creating new ones.`;
 }
 /**
  * Load ONBOARDING.md from the project dir, package root, or built-in fallback.
@@ -368,7 +348,9 @@ function wrapPrompt(onboardingContent, projectDir) {
 
 You do NOT need to create the framework files listed above — they're already there.
 
-Follow the onboarding instructions below. Work through each step, pausing after Step 1 and Step 2 to present your analysis and proposed roster to the user for approval before proceeding.
+> **IMPORTANT:** The \`example/\` directory is a **template reference**, NOT a teammate. Do not modify it or treat it as a teammate. Never name a new teammate "example".
+
+Follow the onboarding instructions below. This is a non-interactive session — complete ALL work without pausing. Do not ask for confirmation or wait for user input. Work through each step and make all changes directly.
 
 ---
 
@@ -392,26 +374,22 @@ Identify:
 3. **Key technologies** — languages, frameworks, tools per area
 4. **File patterns** — glob patterns for each domain
 
-**Present your analysis to the user and get confirmation before proceeding.**
-
 ## Step 2: Design the Team
 
-Propose a roster of teammates:
+Based on your analysis, design a roster of teammates:
 - **Aim for 3–7 teammates.** Fewer for small projects, more for monorepos.
 - **Each teammate owns a distinct domain** with minimal overlap.
 - **Pick short, memorable names** — one word, evocative of the domain.
 
-For each proposed teammate, define:
+For each teammate, define:
 - Name and one-line persona
 - Primary ownership (file patterns)
 - Key technologies
 - Boundaries (what they do NOT own)
 
-**Present the proposed roster to the user for approval.**
-
 ## Step 3: Create the Directory Structure
 
-Once approved, create teammate folders under \`.teammates/\`:
+Create teammate folders under \`.teammates/\`:
 
 ### Teammate folders
 For each teammate, create \`.teammates/<name>/\` with:

package/dist/registry.d.ts

@@ -9,6 +9,8 @@ export declare class Registry {
     private teammatesDir;
     private teammates;
     constructor(teammatesDir: string);
+    /** Names that are never teammates (template references, config files) */
+    private static NON_TEAMMATE_NAMES;
     /** Discover and load all teammates from .teammates/ */
     loadAll(): Promise<Map<string, TeammateConfig>>;
     /** Load a single teammate by name */

package/dist/registry.js

@@ -12,10 +12,15 @@ export class Registry {
     constructor(teammatesDir) {
         this.teammatesDir = teammatesDir;
     }
+    /** Names that are never teammates (template references, config files) */
+    static NON_TEAMMATE_NAMES = new Set(["example"]);
     /** Discover and load all teammates from .teammates/ */
     async loadAll() {
         const entries = await readdir(this.teammatesDir, { withFileTypes: true });
-        const dirs = entries.filter((e) => e.isDirectory() && !e.name.startsWith(".") && !e.name.startsWith("_"));
+        const dirs = entries.filter((e) => e.isDirectory() &&
+            !e.name.startsWith(".") &&
+            !e.name.startsWith("_") &&
+            !Registry.NON_TEAMMATE_NAMES.has(e.name));
         for (const dir of dirs) {
             const config = await this.loadTeammate(dir.name);
             if (config) {

package/dist/registry.test.js

@@ -56,6 +56,13 @@ describe("Registry.loadAll", () => {
         await registry.loadAll();
         expect(registry.list()).toEqual(["beacon"]);
     });
+    it("skips the example directory even if it has SOUL.md", async () => {
+        await createTeammate("beacon", "# Beacon\n\nPlatform engineer.");
+        await createTeammate("example", "# Example\n\nTemplate reference.");
+        const registry = new Registry(tempDir);
+        await registry.loadAll();
+        expect(registry.list()).toEqual(["beacon"]);
+    });
 });
 describe("Registry.loadTeammate", () => {
     it("loads soul content", async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teammates/cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Agent-agnostic CLI for teammates. Routes tasks, manages handoffs, and plugs into any coding agent backend.",
   "type": "module",
   "main": "dist/index.js",