agentic-qe 3.6.0 → 3.6.2

package/v3/dist/hooks/teammate-idle-hook.d.ts

@@ -0,0 +1,167 @@
+/**
+ * TeammateIdle Hook - ADR-064, Phase 1B
+ *
+ * Monitors agents for idle state and auto-assigns pending tasks
+ * from the task queue when an agent exceeds its idle threshold.
+ * Uses dependency injection for the task queue to avoid circular
+ * dependencies with the claim system.
+ *
+ * @module teammate-idle-hook
+ * @version 1.0.0
+ */
+/** A pending task that can be assigned to an idle agent. */
+export interface PendingTask {
+    /** Unique task identifier */
+    readonly id: string;
+    /** Domain the task belongs to */
+    readonly domain: string;
+    /** Priority level (p0 = highest) */
+    readonly priority: string;
+    /** Human-readable title */
+    readonly title: string;
+    /** When the task was created (epoch ms) */
+    readonly createdAt: number;
+}
+/**
+ * Abstraction over the claim/task system for dependency injection.
+ * Allows the hook to query and claim tasks without importing ClaimService directly.
+ */
+export interface TaskQueue {
+    /** Retrieve pending tasks filtered by domains and limited in count */
+    getPendingTasks(filter: {
+        readonly domains?: string[];
+        readonly limit?: number;
+    }): Promise<PendingTask[]>;
+    /** Attempt to claim a task for an agent. Returns true on success. */
+    claimTask(taskId: string, agentId: string): Promise<boolean>;
+}
+/** Configuration for the TeammateIdle hook. */
+export interface TeammateIdleHookConfig {
+    /** Idle threshold before hook fires (default: 5000ms) */
+    readonly idleThresholdMs: number;
+    /** Auto-assign from pending task queue */
+    readonly autoAssign: boolean;
+    /** Domains this agent can claim from */
+    readonly claimableDomains: string[];
+    /** Maximum tasks to assign per idle cycle */
+    readonly maxAssignPerCycle: number;
+    /** Whether to prefer same-domain tasks */
+    readonly preferSameDomain: boolean;
+    /** Priority threshold - only assign tasks at or above this priority (e.g. 'p1') */
+    readonly minPriority?: string;
+}
+/** Result of an idle check. Describes the action taken when an agent becomes idle. */
+export type IdleAction = {
+    readonly action: 'assigned';
+    readonly taskId: string;
+    readonly domain: string;
+} | {
+    readonly action: 'wait';
+    readonly reason: string;
+} | {
+    readonly action: 'shutdown';
+    readonly reason: string;
+};
+/** Statistics snapshot returned by getStats() */
+export interface TeammateIdleStats {
+    readonly monitoredAgents: number;
+    readonly idleAgents: number;
+    readonly totalIdleEvents: number;
+    readonly totalAssigned: number;
+    readonly totalWaits: number;
+}
+/**
+ * Hook that monitors agents for idle state and auto-assigns pending tasks.
+ *
+ * When an agent exceeds its configured idle threshold, the hook queries the
+ * injected TaskQueue for pending work, applies domain and priority filters,
+ * and attempts to claim a task on the agent's behalf.
+ */
+export declare class TeammateIdleHook {
+    private readonly config;
+    private readonly taskQueue;
+    private readonly agents;
+    private checkInterval;
+    private checkIntervalMs;
+    private idleCb;
+    private assignCb;
+    private stats;
+    /**
+     * @param config - Hook configuration (merged with defaults)
+     * @param taskQueue - Optional task queue for auto-assignment
+     * @param checkIntervalMs - Interval for periodic idle checking (default: 2000ms)
+     */
+    constructor(config?: Partial<TeammateIdleHookConfig>, taskQueue?: TaskQueue, checkIntervalMs?: number);
+    /**
+     * Start monitoring an agent for idle state. Records current time as last
+     * activity and begins periodic checking if not already running.
+     * @param agentId - Unique identifier for the agent
+     * @param domain - Domain the agent operates in
+     */
+    start(agentId: string, domain: string): void;
+    /**
+     * Stop monitoring an agent for idle state.
+     * Clears the periodic interval if no agents remain.
+     * @param agentId - Agent to stop monitoring
+     */
+    stop(agentId: string): void;
+    /** Tear down the hook entirely, stopping all monitoring and clearing timers. */
+    dispose(): void;
+    /**
+     * Record activity for an agent, resetting its idle timer.
+     * Call this whenever the agent performs meaningful work.
+     * @param agentId - Agent that performed activity
+     */
+    recordActivity(agentId: string): void;
+    /**
+     * Manually check if an agent is idle and take action if so.
+     * Also called automatically by the periodic checker.
+     * @param agentId - Agent to check
+     * @returns The idle action taken, or null if agent is not idle or not found
+     */
+    checkIdle(agentId: string): Promise<IdleAction | null>;
+    /**
+     * Called when an agent exceeds the idle threshold.
+     * Attempts to auto-assign a task if configured, otherwise returns a wait action.
+     * @param agentId - The idle agent
+     * @returns The action taken
+     */
+    onIdle(agentId: string): Promise<IdleAction>;
+    /**
+     * Get all agents currently past the idle threshold.
+     * @returns Array of objects with agentId, domain, and idle duration
+     */
+    getIdleAgents(): Array<{
+        agentId: string;
+        domain: string;
+        idleSinceMs: number;
+    }>;
+    /** Get monitoring statistics. */
+    getStats(): TeammateIdleStats;
+    /** Register a callback invoked when an agent becomes idle and an action is taken. */
+    onIdleCallback(callback: (agentId: string, action: IdleAction) => void): void;
+    /** Register a callback invoked when a task is successfully assigned to an idle agent. */
+    onAssignCallback(callback: (agentId: string, taskId: string, domain: string) => void): void;
+    /** Sort tasks by domain preference, priority, then creation time. */
+    private sortTasks;
+    /** Build a wait result, notify callback, and bump stats. */
+    private waitResult;
+    /** Start the periodic idle check interval if not already running. */
+    private ensureCheckInterval;
+    /** Clear the periodic idle check interval. */
+    private clearCheckInterval;
+    /** Run idle check across all monitored agents. */
+    private runIdleCheck;
+    /** Notify the idle callback if registered. */
+    private notifyIdle;
+    /** Notify the assign callback if registered. */
+    private notifyAssign;
+}
+/**
+ * Create a new TeammateIdleHook with the given configuration and task queue.
+ * @param config - Partial configuration (merged with defaults)
+ * @param taskQueue - Optional task queue for auto-assignment
+ * @returns A new TeammateIdleHook instance
+ */
+export declare function createTeammateIdleHook(config?: Partial<TeammateIdleHookConfig>, taskQueue?: TaskQueue): TeammateIdleHook;
+//# sourceMappingURL=teammate-idle-hook.d.ts.map

package/v3/dist/hooks/teammate-idle-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teammate-idle-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/teammate-idle-hook.ts"],"names":[],"mappings":"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"}

package/v3/dist/hooks/teammate-idle-hook.js

@@ -0,0 +1,332 @@
+/**
+ * TeammateIdle Hook - ADR-064, Phase 1B
+ *
+ * Monitors agents for idle state and auto-assigns pending tasks
+ * from the task queue when an agent exceeds its idle threshold.
+ * Uses dependency injection for the task queue to avoid circular
+ * dependencies with the claim system.
+ *
+ * @module teammate-idle-hook
+ * @version 1.0.0
+ */
+/** Priority ordering map -- lower index = higher priority */
+const PRIORITY_ORDER = { p0: 0, p1: 1, p2: 2, p3: 3 };
+const DEFAULT_CONFIG = {
+    idleThresholdMs: 5000,
+    autoAssign: true,
+    claimableDomains: [],
+    maxAssignPerCycle: 1,
+    preferSameDomain: true,
+    minPriority: undefined,
+};
+/** Default interval for periodic idle checking (ms) */
+const DEFAULT_CHECK_INTERVAL_MS = 2000;
+// =============================================================================
+// TeammateIdleHook
+// =============================================================================
+/**
+ * Hook that monitors agents for idle state and auto-assigns pending tasks.
+ *
+ * When an agent exceeds its configured idle threshold, the hook queries the
+ * injected TaskQueue for pending work, applies domain and priority filters,
+ * and attempts to claim a task on the agent's behalf.
+ */
+export class TeammateIdleHook {
+    config;
+    taskQueue;
+    agents = new Map();
+    checkInterval = null;
+    checkIntervalMs;
+    idleCb = null;
+    assignCb = null;
+    stats = { totalIdleEvents: 0, totalAssigned: 0, totalWaits: 0 };
+    /**
+     * @param config - Hook configuration (merged with defaults)
+     * @param taskQueue - Optional task queue for auto-assignment
+     * @param checkIntervalMs - Interval for periodic idle checking (default: 2000ms)
+     */
+    constructor(config, taskQueue, checkIntervalMs) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.taskQueue = taskQueue ?? null;
+        this.checkIntervalMs = checkIntervalMs ?? DEFAULT_CHECK_INTERVAL_MS;
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Start monitoring an agent for idle state. Records current time as last
+     * activity and begins periodic checking if not already running.
+     * @param agentId - Unique identifier for the agent
+     * @param domain - Domain the agent operates in
+     */
+    start(agentId, domain) {
+        if (this.agents.has(agentId)) {
+            console.log(`[TeammateIdleHook] Agent ${agentId} already monitored, updating domain to ${domain}`);
+        }
+        else {
+            console.log(`[TeammateIdleHook] Starting idle monitoring for agent ${agentId} in domain ${domain}`);
+        }
+        this.agents.set(agentId, { lastActivity: Date.now(), domain, monitoring: true });
+        this.ensureCheckInterval();
+    }
+    /**
+     * Stop monitoring an agent for idle state.
+     * Clears the periodic interval if no agents remain.
+     * @param agentId - Agent to stop monitoring
+     */
+    stop(agentId) {
+        if (!this.agents.has(agentId)) {
+            console.log(`[TeammateIdleHook] Agent ${agentId} not found, nothing to stop`);
+            return;
+        }
+        this.agents.delete(agentId);
+        console.log(`[TeammateIdleHook] Stopped idle monitoring for agent ${agentId}`);
+        if (this.agents.size === 0)
+            this.clearCheckInterval();
+    }
+    /** Tear down the hook entirely, stopping all monitoring and clearing timers. */
+    dispose() {
+        console.log(`[TeammateIdleHook] Disposing — stopping all ${this.agents.size} monitored agents`);
+        this.agents.clear();
+        this.clearCheckInterval();
+        this.idleCb = null;
+        this.assignCb = null;
+    }
+    // ---------------------------------------------------------------------------
+    // Activity Recording
+    // ---------------------------------------------------------------------------
+    /**
+     * Record activity for an agent, resetting its idle timer.
+     * Call this whenever the agent performs meaningful work.
+     * @param agentId - Agent that performed activity
+     */
+    recordActivity(agentId) {
+        const state = this.agents.get(agentId);
+        if (state)
+            state.lastActivity = Date.now();
+    }
+    // ---------------------------------------------------------------------------
+    // Idle Detection
+    // ---------------------------------------------------------------------------
+    /**
+     * Manually check if an agent is idle and take action if so.
+     * Also called automatically by the periodic checker.
+     * @param agentId - Agent to check
+     * @returns The idle action taken, or null if agent is not idle or not found
+     */
+    async checkIdle(agentId) {
+        const state = this.agents.get(agentId);
+        if (!state || !state.monitoring)
+            return null;
+        const elapsed = Date.now() - state.lastActivity;
+        if (elapsed < this.config.idleThresholdMs)
+            return null;
+        return this.onIdle(agentId);
+    }
+    /**
+     * Called when an agent exceeds the idle threshold.
+     * Attempts to auto-assign a task if configured, otherwise returns a wait action.
+     * @param agentId - The idle agent
+     * @returns The action taken
+     */
+    async onIdle(agentId) {
+        const state = this.agents.get(agentId);
+        if (!state) {
+            return { action: 'wait', reason: `agent ${agentId} not found` };
+        }
+        this.stats.totalIdleEvents++;
+        console.log(`[TeammateIdleHook] Agent ${agentId} is idle (domain: ${state.domain})`);
+        if (!this.config.autoAssign) {
+            return this.waitResult(agentId, 'auto-assign disabled');
+        }
+        if (!this.taskQueue) {
+            return this.waitResult(agentId, 'no task queue configured');
+        }
+        // Query pending tasks
+        const domains = this.config.claimableDomains.length > 0
+            ? this.config.claimableDomains
+            : undefined;
+        let tasks;
+        try {
+            tasks = await this.taskQueue.getPendingTasks({
+                domains,
+                limit: this.config.maxAssignPerCycle * 3,
+            });
+        }
+        catch (err) {
+            console.log(`[TeammateIdleHook] Failed to fetch pending tasks: ${err}`);
+            return this.waitResult(agentId, 'task queue error');
+        }
+        // Filter by minimum priority
+        if (this.config.minPriority) {
+            const threshold = PRIORITY_ORDER[this.config.minPriority];
+            if (threshold !== undefined) {
+                tasks = tasks.filter(t => {
+                    const taskPri = PRIORITY_ORDER[t.priority];
+                    return taskPri !== undefined && taskPri <= threshold;
+                });
+            }
+        }
+        if (tasks.length === 0) {
+            return this.waitResult(agentId, 'no pending tasks');
+        }
+        // Sort: same-domain first if preferred, then by priority, then by creation time
+        tasks = this.sortTasks(tasks, state.domain);
+        // Try to claim the highest-priority task
+        for (const task of tasks.slice(0, this.config.maxAssignPerCycle)) {
+            try {
+                const claimed = await this.taskQueue.claimTask(task.id, agentId);
+                if (claimed) {
+                    state.lastActivity = Date.now();
+                    const result = { action: 'assigned', taskId: task.id, domain: task.domain };
+                    this.stats.totalAssigned++;
+                    this.notifyIdle(agentId, result);
+                    this.notifyAssign(agentId, task.id, task.domain);
+                    console.log(`[TeammateIdleHook] Assigned task ${task.id} (${task.domain}, ${task.priority}) to agent ${agentId}`);
+                    return result;
+                }
+            }
+            catch (err) {
+                console.log(`[TeammateIdleHook] Failed to claim task ${task.id}: ${err}`);
+            }
+        }
+        return this.waitResult(agentId, 'claim attempts failed');
+    }
+    // ---------------------------------------------------------------------------
+    // Query Methods
+    // ---------------------------------------------------------------------------
+    /**
+     * Get all agents currently past the idle threshold.
+     * @returns Array of objects with agentId, domain, and idle duration
+     */
+    getIdleAgents() {
+        const now = Date.now();
+        const idle = [];
+        for (const [agentId, state] of this.agents.entries()) {
+            if (!state.monitoring)
+                continue;
+            const elapsed = now - state.lastActivity;
+            if (elapsed >= this.config.idleThresholdMs) {
+                idle.push({ agentId, domain: state.domain, idleSinceMs: elapsed });
+            }
+        }
+        return idle;
+    }
+    /** Get monitoring statistics. */
+    getStats() {
+        return {
+            monitoredAgents: this.agents.size,
+            idleAgents: this.getIdleAgents().length,
+            totalIdleEvents: this.stats.totalIdleEvents,
+            totalAssigned: this.stats.totalAssigned,
+            totalWaits: this.stats.totalWaits,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Callbacks
+    // ---------------------------------------------------------------------------
+    /** Register a callback invoked when an agent becomes idle and an action is taken. */
+    onIdleCallback(callback) {
+        this.idleCb = callback;
+    }
+    /** Register a callback invoked when a task is successfully assigned to an idle agent. */
+    onAssignCallback(callback) {
+        this.assignCb = callback;
+    }
+    // ---------------------------------------------------------------------------
+    // Private Helpers
+    // ---------------------------------------------------------------------------
+    /** Sort tasks by domain preference, priority, then creation time. */
+    sortTasks(tasks, agentDomain) {
+        return [...tasks].sort((a, b) => {
+            if (this.config.preferSameDomain) {
+                const aSame = a.domain === agentDomain ? 0 : 1;
+                const bSame = b.domain === agentDomain ? 0 : 1;
+                if (aSame !== bSame)
+                    return aSame - bSame;
+            }
+            const aPri = PRIORITY_ORDER[a.priority] ?? 999;
+            const bPri = PRIORITY_ORDER[b.priority] ?? 999;
+            if (aPri !== bPri)
+                return aPri - bPri;
+            return a.createdAt - b.createdAt;
+        });
+    }
+    /** Build a wait result, notify callback, and bump stats. */
+    waitResult(agentId, reason) {
+        const result = { action: 'wait', reason };
+        this.notifyIdle(agentId, result);
+        this.stats.totalWaits++;
+        return result;
+    }
+    /** Start the periodic idle check interval if not already running. */
+    ensureCheckInterval() {
+        if (this.checkInterval !== null)
+            return;
+        this.checkInterval = setInterval(() => {
+            void this.runIdleCheck();
+        }, this.checkIntervalMs);
+        // Allow the interval to not keep the process alive
+        if (this.checkInterval && typeof this.checkInterval === 'object' && 'unref' in this.checkInterval) {
+            this.checkInterval.unref();
+        }
+    }
+    /** Clear the periodic idle check interval. */
+    clearCheckInterval() {
+        if (this.checkInterval !== null) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = null;
+        }
+    }
+    /** Run idle check across all monitored agents. */
+    async runIdleCheck() {
+        const now = Date.now();
+        for (const [agentId, state] of this.agents.entries()) {
+            if (!state.monitoring)
+                continue;
+            if (now - state.lastActivity >= this.config.idleThresholdMs) {
+                try {
+                    await this.onIdle(agentId);
+                }
+                catch (err) {
+                    console.log(`[TeammateIdleHook] Error during idle check for ${agentId}: ${err}`);
+                }
+            }
+        }
+    }
+    /** Notify the idle callback if registered. */
+    notifyIdle(agentId, action) {
+        if (this.idleCb) {
+            try {
+                this.idleCb(agentId, action);
+            }
+            catch (err) {
+                console.log(`[TeammateIdleHook] Idle callback error: ${err}`);
+            }
+        }
+    }
+    /** Notify the assign callback if registered. */
+    notifyAssign(agentId, taskId, domain) {
+        if (this.assignCb) {
+            try {
+                this.assignCb(agentId, taskId, domain);
+            }
+            catch (err) {
+                console.log(`[TeammateIdleHook] Assign callback error: ${err}`);
+            }
+        }
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a new TeammateIdleHook with the given configuration and task queue.
+ * @param config - Partial configuration (merged with defaults)
+ * @param taskQueue - Optional task queue for auto-assignment
+ * @returns A new TeammateIdleHook instance
+ */
+export function createTeammateIdleHook(config, taskQueue) {
+    return new TeammateIdleHook(config, taskQueue);
+}
+//# sourceMappingURL=teammate-idle-hook.js.map

package/v3/dist/hooks/teammate-idle-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teammate-idle-hook.js","sourceRoot":"","sources":["../../src/hooks/teammate-idle-hook.ts"],"names":[],"mappings":"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"}

package/v3/dist/index.d.ts

@@ -8,6 +8,9 @@ export * from './shared/events';
 export * as Entities from './shared/entities';
 export * from './kernel';
 export * from './coordination';
+export { CrossPhaseHookExecutor, getCrossPhaseHookExecutor, resetCrossPhaseHookExecutor, TeammateIdleHook, createTeammateIdleHook, TaskCompletedHook, createTaskCompletedHook, QualityGateEnforcer, createQualityGateEnforcer, ReasoningBankPatternStore, createReasoningBankPatternStore, } from './hooks';
+export type { TeammateIdleHookConfig, TaskQueue, PendingTask, TeammateIdleStats, TaskCompletedHookConfig, ExtractedPattern, PatternStore, CompletionAction, CompletionHandler, GateCheckResult, } from './hooks';
+export { DevilsAdvocate, ClaimVerifier } from './agents';
 export * from './domains';
 export { MCPServer, createMCPServer, ToolRegistry, createToolRegistry, } from './mcp';
 export { createQEReasoningBank, QEReasoningBank, RealQEReasoningBank, createRealQEReasoningBank, detectQEDomain, detectQEDomains, mapQEDomainToAQE, QE_DOMAIN_LIST, QE_DOMAINS, } from './learning';

package/v3/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/v3/dist/index.js

@@ -17,6 +17,10 @@ export * as Entities from './shared/entities';
 export * from './kernel';
 // Coordination Layer - export coordination components
 export * from './coordination';
+// Hooks Layer - cross-phase hooks and ADR-064 agent team hooks
+export { CrossPhaseHookExecutor, getCrossPhaseHookExecutor, resetCrossPhaseHookExecutor, TeammateIdleHook, createTeammateIdleHook, TaskCompletedHook, createTaskCompletedHook, QualityGateEnforcer, createQualityGateEnforcer, ReasoningBankPatternStore, createReasoningBankPatternStore, } from './hooks';
+// Agents Layer - specialized QE agents (namespaced to avoid collisions)
+export { DevilsAdvocate, ClaimVerifier } from './agents';
 // Domain Interfaces - export as namespaces
 export * from './domains';
 // MCP Server - Model Context Protocol integration

package/v3/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/v3/dist/init/agents-installer.d.ts

@@ -71,6 +71,8 @@ export declare class AgentsInstaller {
     private copyDirectoryRecursive;
     /**
      * Copy helpers directory (agent-specific reference files, templates, scripts)
+     * Installed to .claude/helpers/v3/ (NOT .claude/agents/v3/helpers/) to avoid
+     * claude doctor parsing .md helper files as agent definitions (Issue #243).
      */
     private copyHelpersDirectory;
     /**
@@ -86,7 +88,9 @@ export declare class AgentsInstaller {
      */
     private getAgentDomain;
     /**
-     * Create an agents index file for easy reference
+     * Create an agents index file for easy reference.
+     * Written to .claude/docs/ instead of .claude/agents/v3/ to avoid
+     * claude doctor parsing it as an agent definition (Issue #243).
      */
     private createAgentsIndex;
 }

package/v3/dist/init/agents-installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-installer.d.ts","sourceRoot":"","sources":["../../src/init/agents-installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAiHD,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,sBAAsB;IAe3C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA4D3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA4D7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;YACW,YAAY;IA0C1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;OAEG;YACW,oBAAoB;IASlC;;OAEG;YACW,sBAAsB;IASpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyDtB;;OAEG;YACW,iBAAiB;CA6DhC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAEtF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAGrF"}
+{"version":3,"file":"agents-installer.d.ts","sourceRoot":"","sources":["../../src/init/agents-installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAiHD,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,sBAAsB;IAe3C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA4D3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA4D7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;YACW,YAAY;IA0C1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;;;OAIG;YACW,oBAAoB;IASlC;;OAEG;YACW,sBAAsB;IASpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyDtB;;;;OAIG;YACW,iBAAiB;CAiEhC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAEtF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAGrF"}

package/v3/dist/init/agents-installer.js

@@ -360,10 +360,12 @@ export class AgentsInstaller {
     }
     /**
      * Copy helpers directory (agent-specific reference files, templates, scripts)
+     * Installed to .claude/helpers/v3/ (NOT .claude/agents/v3/helpers/) to avoid
+     * claude doctor parsing .md helper files as agent definitions (Issue #243).
      */
-    async copyHelpersDirectory(targetAgentsDir) {
+    async copyHelpersDirectory(_targetAgentsDir) {
         const sourceHelpersDir = join(this.sourceAgentsDir, 'helpers');
-        const targetHelpersDir = join(targetAgentsDir, 'helpers');
+        const targetHelpersDir = join(this.projectRoot, '.claude', 'helpers', 'v3');
         if (existsSync(sourceHelpersDir)) {
             this.copyDirectoryRecursive(sourceHelpersDir, targetHelpersDir);
         }
@@ -464,9 +466,11 @@ export class AgentsInstaller {
         return domainMap[key];
     }
     /**
-     * Create an agents index file for easy reference
+     * Create an agents index file for easy reference.
+     * Written to .claude/docs/ instead of .claude/agents/v3/ to avoid
+     * claude doctor parsing it as an agent definition (Issue #243).
      */
-    async createAgentsIndex(agentsDir, installed) {
+    async createAgentsIndex(_agentsDir, installed) {
         const qeAgents = installed.filter(a => a.type === 'v3-qe');
         const subagents = installed.filter(a => a.type === 'v3-subagent');
         // Group QE agents by domain
@@ -522,7 +526,11 @@ ${subagents.map(a => `- **${a.name}**${a.description ? `: ${a.description}` : ''
 
 *Generated by AQE v3 init on ${new Date().toISOString()}*
 `;
-        writeFileSync(join(agentsDir, 'README.md'), indexContent, 'utf-8');
+        const docsDir = join(this.projectRoot, '.claude', 'docs');
+        if (!existsSync(docsDir)) {
+            mkdirSync(docsDir, { recursive: true });
+        }
+        writeFileSync(join(docsDir, 'v3-agents-index.md'), indexContent, 'utf-8');
     }
 }
 /**