@teammates/cli 0.2.2 → 0.2.4

package/dist/adapter.d.ts

@@ -24,6 +24,8 @@ export interface AgentAdapter {
      * Falls back to startSession if not implemented.
      */
     resumeSession?(teammate: TeammateConfig, sessionId: string): Promise<string>;
+    /** Get the session file path for a teammate (if session is active). */
+    getSessionFile?(teammateName: string): string | undefined;
     /** Clean up a session. */
     destroySession?(sessionId: string): Promise<void>;
     /**

package/dist/adapters/cli-proxy.d.ts

@@ -70,6 +70,7 @@ export declare class CliProxyAdapter implements AgentAdapter {
     startSession(teammate: TeammateConfig): Promise<string>;
     executeTask(_sessionId: string, teammate: TeammateConfig, prompt: string): Promise<TaskResult>;
     routeTask(task: string, roster: RosterEntry[]): Promise<string | null>;
+    getSessionFile(teammateName: string): string | undefined;
     destroySession(_sessionId: string): Promise<void>;
     /**
      * Spawn the agent, stream its output live, and capture it.

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(() => "");
@@ -269,6 +270,9 @@ export class CliProxyAdapter {
             await unlink(promptFile).catch(() => { });
         }
     }
+    getSessionFile(teammateName) {
+        return this.sessionFiles.get(teammateName);
+    }
     async destroySession(_sessionId) {
         // Clean up any leaked temp prompt files
         for (const file of this.pendingTempFiles) {

package/dist/adapters/copilot.d.ts

@@ -42,6 +42,7 @@ export declare class CopilotAdapter implements AgentAdapter {
     startSession(teammate: TeammateConfig): Promise<string>;
     executeTask(_sessionId: string, teammate: TeammateConfig, prompt: string): Promise<TaskResult>;
     routeTask(task: string, roster: RosterEntry[]): Promise<string | null>;
+    getSessionFile(teammateName: string): string | undefined;
     destroySession(_sessionId: string): Promise<void>;
     /**
      * Ensure the CopilotClient is started.

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/")) {
@@ -173,6 +174,9 @@ export class CopilotAdapter {
             await session.disconnect().catch(() => { });
         }
     }
+    getSessionFile(teammateName) {
+        return this.sessionFiles.get(teammateName);
+    }
     async destroySession(_sessionId) {
         // Disconnect all sessions
         for (const [, session] of this.sessions) {

package/dist/cli.js

@@ -8,10 +8,10 @@
  *   teammates --dir <path>        Override .teammates/ location
  */
 import { spawn as cpSpawn, exec as execCb, execSync, } from "node:child_process";
-import { readFileSync, writeFileSync } from "node:fs";
+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);
@@ -24,7 +24,7 @@ import { findAtMention, isImagePath, relativeTime, wrapLine, } from "./cli-utils
 import { compactEpisodic } from "./compact.js";
 import { PromptInput } from "./console/prompt-input.js";
 import { buildTitle } from "./console/startup.js";
-import { buildAdaptationPrompt, copyTemplateFiles, getOnboardingPrompt, importTeammates, } from "./onboard.js";
+import { buildImportAdaptationPrompt, copyTemplateFiles, getOnboardingPrompt, importTeammates, } from "./onboard.js";
 import { Orchestrator } from "./orchestrator.js";
 import { colorToHex, theme } from "./theme.js";
 // ─── Version ─────────────────────────────────────────────────────────
@@ -465,6 +465,28 @@ class TeammatesREPL {
     lastCleanedOutput = ""; // last teammate output for clipboard copy
     dispatching = false;
     autoApproveHandoffs = false;
+    /** Read .teammates/settings.json (returns { version, services, ... } or defaults). */
+    readSettings() {
+        try {
+            const raw = JSON.parse(readFileSync(join(this.teammatesDir, "settings.json"), "utf-8"));
+            return {
+                version: raw.version ?? 1,
+                services: Array.isArray(raw.services) ? raw.services : [],
+                ...raw,
+            };
+        }
+        catch {
+            return { version: 1, services: [] };
+        }
+    }
+    /** Write .teammates/settings.json. */
+    writeSettings(settings) {
+        writeFileSync(join(this.teammatesDir, "settings.json"), `${JSON.stringify(settings, null, 2)}\n`);
+    }
+    /** Check whether a specific service is installed. */
+    isServiceInstalled(name) {
+        return this.readSettings().services.some((s) => s.name === name);
+    }
     /** Pending handoffs awaiting user approval. */
     pendingHandoffs = [];
     /** Pending retro proposals awaiting user approval. */
@@ -1420,14 +1442,17 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 chalk.cyan(teammates.join(", ")));
             console.log(chalk.gray(`    (${files.length} files copied)`));
             console.log();
+            // Copy framework files so the agent has TEMPLATE.md etc. available
+            await copyTemplateFiles(teammatesDir);
             // Ask if user wants the agent to adapt teammates to this codebase
             console.log(chalk.white("  Adapt teammates to this codebase?"));
-            console.log(chalk.gray("  The agent will update ownership patterns, file paths, and boundaries."));
+            console.log(chalk.gray("  The agent will scan this project, evaluate which teammates are needed,"));
+            console.log(chalk.gray("  adapt their files, and create any new teammates the project needs."));
             console.log(chalk.gray("  You can also do this later with /init."));
             console.log();
             const adapt = await this.askChoice("Adapt now? (y/n): ", ["y", "n"]);
             if (adapt === "y") {
-                await this.runAdaptationAgent(this.adapter, projectDir, teammates);
+                await this.runAdaptationAgent(this.adapter, projectDir, teammates, sourceDir);
             }
             else {
                 console.log(chalk.gray("  Skipped adaptation. Run /init to adapt later."));
@@ -1439,53 +1464,52 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         console.log();
     }
     /**
-     * Run the agent to adapt imported teammates' ownership/boundaries
-     * to the current codebase. Queues one task per teammate so the user
-     * can review and approve each adaptation individually.
+     * Run the agent to adapt imported teammates to the current codebase.
+     * Uses a single comprehensive session that scans the project, evaluates
+     * which teammates to keep/drop/create, adapts kept teammates (with
+     * Previous Projects sections), and creates any new teammates needed.
      */
-    async runAdaptationAgent(adapter, projectDir, teammateNames) {
+    async runAdaptationAgent(adapter, projectDir, teammateNames, sourceProjectPath) {
         const teammatesDir = join(projectDir, ".teammates");
         console.log();
-        console.log(chalk.blue("  Queuing adaptation tasks...") +
-            chalk.gray(` ${this.adapterName} will adapt each teammate individually`));
+        console.log(chalk.blue("  Starting adaptation...") +
+            chalk.gray(` ${this.adapterName} will scan this project and adapt the team`));
         console.log();
-        for (const name of teammateNames) {
-            const prompt = await buildAdaptationPrompt(teammatesDir, name);
-            const tempConfig = {
-                name: this.adapterName,
-                role: "Adaptation agent",
-                soul: "",
-                wisdom: "",
-                dailyLogs: [],
-                weeklyLogs: [],
-                ownership: { primary: [], secondary: [] },
-                routingKeywords: [],
-            };
-            const sessionId = await adapter.startSession(tempConfig);
-            const spinner = ora({
-                text: chalk.blue(this.adapterName) +
-                    chalk.gray(` is adapting @${name} to this codebase...`),
-                spinner: "dots",
-            }).start();
-            try {
-                const result = await adapter.executeTask(sessionId, tempConfig, prompt);
-                spinner.stop();
-                this.printAgentOutput(result.rawOutput);
-                if (result.success) {
-                    console.log(chalk.green(`  ✔ @${name} adaptation complete!`));
-                }
-                else {
-                    console.log(chalk.yellow(`  ⚠ @${name} adaptation finished with issues: ${result.summary}`));
-                }
-            }
-            catch (err) {
-                spinner.fail(chalk.red(`@${name} adaptation failed: ${err.message}`));
+        const prompt = await buildImportAdaptationPrompt(teammatesDir, teammateNames, sourceProjectPath);
+        const tempConfig = {
+            name: this.adapterName,
+            role: "Adaptation agent",
+            soul: "",
+            wisdom: "",
+            dailyLogs: [],
+            weeklyLogs: [],
+            ownership: { primary: [], secondary: [] },
+            routingKeywords: [],
+        };
+        const sessionId = await adapter.startSession(tempConfig);
+        const spinner = ora({
+            text: chalk.blue(this.adapterName) +
+                chalk.gray(" is scanning the project and adapting teammates..."),
+            spinner: "dots",
+        }).start();
+        try {
+            const result = await adapter.executeTask(sessionId, tempConfig, prompt);
+            spinner.stop();
+            this.printAgentOutput(result.rawOutput);
+            if (result.success) {
+                console.log(chalk.green("  ✔ Team adaptation complete!"));
             }
-            if (adapter.destroySession) {
-                await adapter.destroySession(sessionId);
+            else {
+                console.log(chalk.yellow(`  ⚠ Adaptation finished with issues: ${result.summary}`));
             }
-            console.log();
         }
+        catch (err) {
+            spinner.fail(chalk.red(`Adaptation failed: ${err.message}`));
+        }
+        if (adapter.destroySession) {
+            await adapter.destroySession(sessionId);
+        }
+        console.log();
     }
     /**
      * Simple blocking prompt — reads one line from stdin and validates.
@@ -1950,6 +1974,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" });
@@ -1963,21 +1988,15 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 return { name: t.name, role: t.role, ownership: t.ownership };
             });
         }
-        // Detect installed services from services.json and tell the adapter
+        // Detect installed services from settings.json and tell the adapter
         if ("services" in this.adapter) {
             const services = [];
-            try {
-                const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-                if (svcJson && "recall" in svcJson) {
-                    services.push({
-                        name: "recall",
-                        description: "Local semantic search across teammate memories and daily logs. Use this to find relevant context before starting a task.",
-                        usage: 'teammates-recall search "your query" --dir .teammates',
-                    });
-                }
-            }
-            catch {
-                /* no services.json or invalid */
+            if (this.isServiceInstalled("recall")) {
+                services.push({
+                    name: "recall",
+                    description: "Local semantic search across teammate memories and daily logs. Use this to find relevant context before starting a task.",
+                    usage: 'teammates-recall search "your query" --dir .teammates',
+                });
             }
             this.adapter.services = services;
         }
@@ -2034,14 +2053,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         // ── Build animated banner for ChatView ─────────────────────────────
         const names = this.orchestrator.listTeammates();
         const reg = this.orchestrator.getRegistry();
-        let hasRecall = false;
-        try {
-            const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-            hasRecall = !!(svcJson && "recall" in svcJson);
-        }
-        catch {
-            /* no services.json */
-        }
+        const hasRecall = this.isServiceInstalled("recall");
         const bannerWidget = new AnimatedBanner({
             adapterName: this.adapterName,
             teammateCount: names.length,
@@ -2432,15 +2444,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
     printBanner(teammates) {
         const registry = this.orchestrator.getRegistry();
         const termWidth = process.stdout.columns || 100;
-        // Detect recall from services.json
-        let recallInstalled = false;
-        try {
-            const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-            recallInstalled = !!(svcJson && "recall" in svcJson);
-        }
-        catch {
-            /* no services.json or invalid */
-        }
+        // Detect recall from settings.json
+        const recallInstalled = this.isServiceInstalled("recall");
         this.feedLine();
         this.feedLine(concat(tp.bold("  Teammates"), tp.muted(` v${PKG_VERSION}`)));
         this.feedLine(concat(tp.text(`  ${this.adapterName}`), tp.muted(` · ${teammates.length} teammate${teammates.length === 1 ? "" : "s"}`)));
@@ -2782,45 +2787,61 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
     }
     async cmdDebug(argsStr) {
         const arg = argsStr.trim().replace(/^@/, "");
-        // Resolve targets
-        let targets;
+        // Resolve which teammates to show debug info for
+        let targetNames;
         if (arg === "everyone") {
-            targets = [];
-            for (const [name, result] of this.lastResults) {
-                if (name !== this.adapterName && result.rawOutput) {
-                    targets.push({ name, result });
-                }
+            targetNames = [];
+            for (const [name] of this.lastResults) {
+                if (name !== this.adapterName)
+                    targetNames.push(name);
             }
-            if (targets.length === 0) {
-                this.feedLine(tp.muted("  No raw output available from any teammate."));
+            if (targetNames.length === 0) {
+                this.feedLine(tp.muted("  No debug info available from any teammate."));
                 this.refreshView();
                 return;
             }
         }
+        else if (arg) {
+            targetNames = [arg];
+        }
+        else if (this.lastResult) {
+            targetNames = [this.lastResult.teammate];
+        }
         else {
-            const result = arg ? this.lastResults.get(arg) : this.lastResult;
-            if (!result?.rawOutput) {
-                this.feedLine(tp.muted("  No raw output available." +
-                    (arg ? "" : " Try: /debug <teammate>")));
-                this.refreshView();
-                return;
-            }
-            targets = [{ name: result.teammate, result }];
+            this.feedLine(tp.muted("  No debug info available. Try: /debug [teammate]"));
+            this.refreshView();
+            return;
         }
-        for (const { name, result } of targets) {
-            this.feedLine();
-            this.feedLine(tp.muted(`  ── raw output from ${name} ──`));
+        let debugText = "";
+        for (const name of targetNames) {
             this.feedLine();
-            this.feedMarkdown(result.rawOutput);
+            this.feedLine(tp.muted(`  ── debug for ${name} ──`));
+            // Read the last debug entry from the session file
+            const sessionEntry = this.readLastDebugEntry(name);
+            if (sessionEntry) {
+                this.feedLine();
+                this.feedMarkdown(sessionEntry);
+                debugText += (debugText ? "\n\n" : "") + sessionEntry;
+            }
+            else {
+                // Fall back to raw output from lastResults
+                const result = this.lastResults.get(name);
+                if (result?.rawOutput) {
+                    this.feedLine();
+                    this.feedMarkdown(result.rawOutput);
+                    debugText += (debugText ? "\n\n" : "") + result.rawOutput;
+                }
+                else {
+                    this.feedLine(tp.muted("  No debug info available."));
+                }
+            }
             this.feedLine();
-            this.feedLine(tp.muted("  ── end raw output ──"));
+            this.feedLine(tp.muted("  ── end debug ──"));
         }
         // [copy] action for the debug output
-        if (this.chatView) {
+        if (this.chatView && debugText) {
             const t = theme();
-            this.lastCleanedOutput = targets
-                .map((t) => t.result.rawOutput)
-                .join("\n\n");
+            this.lastCleanedOutput = debugText;
             this.chatView.appendActionList([
                 {
                     id: "copy",
@@ -2838,6 +2859,28 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         this.feedLine();
         this.refreshView();
     }
+    /**
+     * Read the last debug entry from a teammate's session file.
+     * Debug entries are delimited by "## Debug — " headings.
+     */
+    readLastDebugEntry(teammate) {
+        try {
+            const sessionFile = this.adapter.getSessionFile?.(teammate);
+            if (!sessionFile)
+                return null;
+            const content = readFileSync(sessionFile, "utf-8");
+            // Split on debug entry headings and return the last one
+            const entries = content.split(/(?=^## Debug — )/m);
+            const last = entries[entries.length - 1];
+            if (last && last.startsWith("## Debug — ")) {
+                return last.trim();
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
     async cmdCancel(argsStr) {
         const n = parseInt(argsStr.trim(), 10);
         if (Number.isNaN(n) || n < 1 || n > this.taskQueue.length) {
@@ -2862,6 +2905,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 break;
             const entry = this.taskQueue.splice(idx, 1)[0];
             this.agentActive.set(agent, entry);
+            const startTime = Date.now();
             try {
                 if (entry.type === "compact") {
                     await this.runCompact(entry.teammate);
@@ -2874,6 +2918,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                         task: entry.task,
                         extraContext: extraContext || undefined,
                     });
+                    // Write debug entry to session file
+                    this.writeDebugEntry(entry.teammate, entry.task, result, startTime);
                     // btw results are not stored in conversation history
                     if (entry.type !== "btw") {
                         this.storeResult(result);
@@ -2884,6 +2930,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 }
             }
             catch (err) {
+                // Write error debug entry to session file
+                this.writeDebugEntry(entry.teammate, entry.task, null, startTime, err);
                 // Handle spawn failures, network errors, etc. gracefully
                 this.activeTasks.delete(agent);
                 if (this.activeTasks.size === 0)
@@ -2895,6 +2943,52 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             this.agentActive.delete(agent);
         }
     }
+    /**
+     * Append a debug entry to the teammate's session file.
+     * Captures task prompt, result summary, raw output, timing, and errors.
+     */
+    writeDebugEntry(teammate, task, result, startTime, error) {
+        try {
+            const sessionFile = this.adapter.getSessionFile?.(teammate);
+            if (!sessionFile)
+                return;
+            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+            const timestamp = new Date().toISOString();
+            const lines = [
+                "",
+                `## Debug — ${timestamp}`,
+                "",
+                `**Duration:** ${elapsed}s`,
+                `**Task:** ${task.length > 200 ? `${task.slice(0, 200)}…` : task}`,
+                "",
+            ];
+            if (error) {
+                lines.push(`**Status:** ERROR`);
+                lines.push(`**Error:** ${error?.message ?? String(error)}`);
+            }
+            else if (result) {
+                lines.push(`**Status:** ${result.success ? "OK" : "FAILED"}`);
+                lines.push(`**Summary:** ${result.summary || "(no summary)"}`);
+                if (result.changedFiles.length > 0) {
+                    lines.push(`**Changed files:** ${result.changedFiles.join(", ")}`);
+                }
+                if (result.handoffs.length > 0) {
+                    lines.push(`**Handoffs:** ${result.handoffs.map((h) => `@${h.to}`).join(", ")}`);
+                }
+                lines.push("");
+                lines.push("<details><summary>Raw output</summary>");
+                lines.push("");
+                lines.push(result.rawOutput ?? "(empty)");
+                lines.push("");
+                lines.push("</details>");
+            }
+            lines.push("");
+            appendFileSync(sessionFile, lines.join("\n"), "utf-8");
+        }
+        catch {
+            // Don't let debug logging break task execution
+        }
+    }
     async cmdInit(argsStr) {
         const cwd = process.cwd();
         const teammatesDir = join(cwd, ".teammates");
@@ -2924,16 +3018,16 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                     return;
                 }
                 this.feedLine(tp.success(`  Imported ${teammates.length} teammate${teammates.length > 1 ? "s" : ""}: ${teammates.join(", ")} (${files.length} files)`));
-                // Queue one adaptation task per teammate
-                this.feedLine(tp.muted(`  Queuing ${this.adapterName} to adapt each teammate individually...`));
-                for (const name of teammates) {
-                    const prompt = await buildAdaptationPrompt(teammatesDir, name);
-                    this.taskQueue.push({
-                        type: "agent",
-                        teammate: this.adapterName,
-                        task: prompt,
-                    });
-                }
+                // 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);
+                this.taskQueue.push({
+                    type: "agent",
+                    teammate: this.adapterName,
+                    task: prompt,
+                });
                 this.kickDrain();
             }
             catch (err) {
@@ -3022,19 +3116,12 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             return;
         }
         this.feedLine(tp.success(`  ✔ ${serviceName} installed successfully`));
-        // Register in services.json
-        const svcPath = join(this.teammatesDir, "services.json");
-        let svcJson = {};
-        try {
-            svcJson = JSON.parse(readFileSync(svcPath, "utf-8"));
-        }
-        catch {
-            /* new file */
-        }
-        if (!(serviceName in svcJson)) {
-            svcJson[serviceName] = {};
-            writeFileSync(svcPath, `${JSON.stringify(svcJson, null, 2)}\n`);
-            this.feedLine(tp.muted(`  Registered in services.json`));
+        // Register in settings.json
+        const settings = this.readSettings();
+        if (!settings.services.some((s) => s.name === serviceName)) {
+            settings.services.push({ name: serviceName });
+            this.writeSettings(settings);
+            this.feedLine(tp.muted(`  Registered in settings.json`));
         }
         // Build initial index if this service supports it
         if (service.indexCmd) {
@@ -3133,15 +3220,9 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             .catch(() => { });
     }
     startRecallWatch() {
-        // Only start if recall is installed (check services.json)
-        try {
-            const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-            if (!svcJson || !("recall" in svcJson))
-                return;
-        }
-        catch {
-            return; // No services.json — recall not installed
-        }
+        // Only start if recall is installed (check settings.json)
+        if (!this.isServiceInstalled("recall"))
+            return;
         try {
             this.recallWatchProcess = cpSpawn("teammates-recall", ["watch", "--dir", this.teammatesDir, "--json"], {
                 stdio: ["ignore", "ignore", "ignore"],
@@ -3245,9 +3326,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             if (this.chatView)
                 this.chatView.setProgress(null);
             // Trigger recall sync if installed
-            try {
-                const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-                if (svcJson && "recall" in svcJson) {
+            if (this.isServiceInstalled("recall")) {
+                try {
                     if (this.chatView) {
                         this.chatView.setProgress(`Syncing ${name} index...`);
                         this.refreshView();
@@ -3267,9 +3347,9 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                         this.feedLine(tp.success(`  ✔ ${name}: index synced`));
                     }
                 }
-            }
-            catch {
-                /* recall not installed or sync failed — non-fatal */
+                catch {
+                    /* sync failed — non-fatal */
+                }
             }
         }
         catch (err) {
@@ -3394,14 +3474,7 @@ Issues that can't be resolved unilaterally — they need input from other teamma
         if (teammates.length === 0)
             return;
         // Check if recall is installed
-        let recallInstalled = false;
-        try {
-            const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-            recallInstalled = !!(svcJson && "recall" in svcJson);
-        }
-        catch {
-            /* no services.json */
-        }
+        const recallInstalled = this.isServiceInstalled("recall");
         // 1. Check each teammate for stale daily logs (older than 7 days)
         const oneWeekAgo = new Date();
         oneWeekAgo.setDate(oneWeekAgo.getDate() - 7);

package/dist/onboard.d.ts

@@ -28,14 +28,15 @@ export declare function importTeammates(sourceDir: string, targetDir: string): P
     files: string[];
 }>;
 /**
- * Build the adaptation prompt for a single imported teammate.
- * Tells the agent to update ownership patterns, file paths, and boundaries
- * for the new codebase while preserving identity, principles, and wisdom.
+ * 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 teammateName - The name of the teammate to adapt
+ * @param teammateNames - Names of all imported teammates
+ * @param sourceProjectPath - Path to the source project (for Previous Projects section)
  */
-export declare function buildAdaptationPrompt(teammatesDir: string, teammateName: string): Promise<string>;
+export declare function buildImportAdaptationPrompt(teammatesDir: string, teammateNames: string[], sourceProjectPath: string): Promise<string>;
 /**
  * Load ONBOARDING.md from the project dir, package root, or built-in fallback.
  */

package/dist/onboard.js

@@ -60,7 +60,7 @@ export async function copyTemplateFiles(teammatesDir) {
         await stat(gitignoreDest);
     }
     catch {
-        const gitignoreContent = "USER.md\n.index/\n";
+        const gitignoreContent = "USER.md\n.*/\n";
         const { writeFile } = await import("node:fs/promises");
         await writeFile(gitignoreDest, gitignoreContent, "utf-8");
         copied.push(".gitignore");
@@ -92,7 +92,7 @@ export async function copyTemplateFiles(teammatesDir) {
  * Directories starting with "_" are shared non-teammate folders.
  * Files (non-directories) and special names are also excluded.
  */
-const NON_TEAMMATE_NAMES = new Set(["example", "services.json"]);
+const NON_TEAMMATE_NAMES = new Set(["example", "settings.json"]);
 function isNonTeammateEntry(name) {
     return (name.startsWith(".") || name.startsWith("_") || NON_TEAMMATE_NAMES.has(name));
 }
@@ -182,66 +182,124 @@ export async function importTeammates(sourceDir, targetDir) {
         await stat(gitignoreDest);
     }
     catch {
-        await writeFile(gitignoreDest, "USER.md\n.index/\n", "utf-8");
+        await writeFile(gitignoreDest, "USER.md\n.*/\n", "utf-8");
         files.push(".gitignore");
     }
     return { teammates, files };
 }
 /**
- * Build the adaptation prompt for a single imported teammate.
- * Tells the agent to update ownership patterns, file paths, and boundaries
- * for the new codebase while preserving identity, principles, and wisdom.
+ * 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 teammateName - The name of the teammate to adapt
+ * @param teammateNames - Names of all imported teammates
+ * @param sourceProjectPath - Path to the source project (for Previous Projects section)
  */
-export async function buildAdaptationPrompt(teammatesDir, teammateName) {
-    const teammateDir = join(teammatesDir, teammateName);
-    // Read the teammate's current SOUL.md and WISDOM.md
-    let soulContent = "";
-    let wisdomContent = "";
-    try {
-        soulContent = await readFile(join(teammateDir, "SOUL.md"), "utf-8");
-    }
-    catch {
-        /* missing — agent will create from scratch */
-    }
-    try {
-        wisdomContent = await readFile(join(teammateDir, "WISDOM.md"), "utf-8");
-    }
-    catch {
-        /* missing — that's fine */
+export async function buildImportAdaptationPrompt(teammatesDir, teammateNames, sourceProjectPath) {
+    const teammateSections = [];
+    for (const name of teammateNames) {
+        const dir = join(teammatesDir, name);
+        let soulContent = "";
+        let wisdomContent = "";
+        try {
+            soulContent = await readFile(join(dir, "SOUL.md"), "utf-8");
+        }
+        catch {
+            /* missing */
+        }
+        try {
+            wisdomContent = await readFile(join(dir, "WISDOM.md"), "utf-8");
+        }
+        catch {
+            /* missing */
+        }
+        const soulBlock = soulContent
+            ? `**SOUL.md:**\n\`\`\`markdown\n${soulContent}\n\`\`\``
+            : "*No SOUL.md found*";
+        const wisdomBlock = wisdomContent
+            ? `\n**WISDOM.md:**\n\`\`\`markdown\n${wisdomContent}\n\`\`\``
+            : "";
+        teammateSections.push(`### @${name}\n${soulBlock}${wisdomBlock}`);
     }
-    const soulSection = soulContent
-        ? `\n\n## Current SOUL.md\n\n\`\`\`markdown\n${soulContent}\n\`\`\``
-        : "\n\n*No SOUL.md found — create one from the template.*";
-    const wisdomSection = wisdomContent
-        ? `\n\n## Current WISDOM.md\n\n\`\`\`markdown\n${wisdomContent}\n\`\`\``
-        : "";
-    return `You are adapting the imported teammate **${teammateName}** to this new codebase.
+    const projectDir = dirname(teammatesDir);
+    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.
 
-**Teammate directory:** \`${teammateDir}\`
+## Imported Teammates (from source project)
 
-This teammate was imported from another project. Their SOUL.md and WISDOM.md contain identity, principles, and accumulated wisdom that should be preserved, but their **ownership patterns**, **file paths**, **boundaries**, **capabilities**, and **routing keywords** need to be updated for this codebase.
-${soulSection}${wisdomSection}
+${teammateSections.join("\n\n---\n\n")}
 
-## Your job:
+## Instructions
 
-1. **Analyze this codebase** — read the project structure, entry points, package manifest, and key files to understand the architecture.
+Complete these steps in order. Do NOT pause, ask questions, or wait for approval. Make all changes directly.
 
-2. **Update ${teammateName}'s SOUL.md**:
-   - **Preserve**: Identity, Core Principles, Ethics, personality, tone
-   - **Update**: Ownership patterns (primary/secondary file globs), Boundaries (reference correct teammate names), Capabilities (commands, file patterns, technologies), Routing keywords, Quality Bar
-   - **Adapt**: Any codebase-specific references (paths, package names, tools)
+### Step 1: Scan This Project
 
-3. **Update ${teammateName}'s WISDOM.md**:
-   - **Preserve**: Wisdom entries that are universal (principles, patterns, lessons)
-   - **Remove or update**: Entries referencing old project paths, file names, or architecture
-   - **Add**: A creation entry noting this teammate was imported and adapted
+Read the project root to understand its structure:
+- Package manifest, README, config files
+- Major subsystems, languages, frameworks, file patterns
+- Dependency flow and architecture
 
-4. **Verify** that ownership globs are valid for this codebase.
+### Step 2: Adapt EVERY Imported Teammate
 
-Present your proposed changes before applying them. Focus only on **${teammateName}** — other teammates will be adapted separately.`;
+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.
+
+For each teammate's **SOUL.md**:
+
+1. **Add a "Previous Projects" section** (place it after Ethics). Compress what the teammate did in the source project:
+   \`\`\`markdown
+   ## Previous Projects
+
+   ### <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 project-specific sections** for THIS project:
+   - **Preserve**: Identity (name, personality), Core Principles, Ethics
+   - **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 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
+
+### Step 3: Evaluate Gaps and Create New Teammates
+
+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
+
+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
+
+### Step 5: Verify
+
+- 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
+
+## 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.
@@ -288,7 +346,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.
 
 ---
 
@@ -312,26 +372,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

@@ -5,17 +5,22 @@
  * (SOUL.md, WISDOM.md, daily logs, ownership rules).
  */
 import { readdir, readFile, stat } from "node:fs/promises";
-import { basename, join } from "node:path";
+import { basename, dirname, join } from "node:path";
 export class Registry {
     teammatesDir;
     teammates = new Map();
     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) {
@@ -50,6 +55,7 @@ export class Registry {
             weeklyLogs,
             ownership,
             routingKeywords,
+            cwd: dirname(this.teammatesDir),
         };
         this.teammates.set(name, config);
         return 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.2",
+  "version": "0.2.4",
   "description": "Agent-agnostic CLI for teammates. Routes tasks, manages handoffs, and plugs into any coding agent backend.",
   "type": "module",
   "main": "dist/index.js",