multi-agents-custom 2.0.0

package/dist/cli/index.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import {
+  ConfigGenerator
+} from "../chunk-C62CM2KR.mjs";
+
+// src/cli/index.ts
+var VALID_TARGETS = ["cursor", "copilot", "qwen", "antigravity", "all"];
+function parseArgs(argv) {
+  const config = {
+    targets: "all",
+    projectRoot: process.cwd(),
+    overwrite: false,
+    verbose: true,
+    help: false
+  };
+  for (const arg of argv) {
+    if (arg === "--help" || arg === "-h") {
+      config.help = true;
+    } else if (arg === "--overwrite") {
+      config.overwrite = true;
+    } else if (arg === "--quiet" || arg === "-q") {
+      config.verbose = false;
+    } else if (arg.startsWith("--targets=")) {
+      const raw = arg.slice("--targets=".length).split(",").map((s) => s.trim());
+      const valid = raw.filter((t) => VALID_TARGETS.includes(t));
+      if (valid.length !== raw.length) {
+        const invalid = raw.filter((t) => !VALID_TARGETS.includes(t));
+        console.error(`Unknown target(s): ${invalid.join(", ")}. Valid: ${VALID_TARGETS.join(", ")}`);
+        process.exit(1);
+      }
+      config.targets = valid.length === 1 ? valid[0] : valid;
+    } else if (arg.startsWith("--root=")) {
+      config.projectRoot = arg.slice("--root=".length);
+    }
+  }
+  return config;
+}
+function printHelp() {
+  console.log(`
+Usage: npx multi-agents-custom [options]
+
+Generates AI tool config files for the multi-agent development pipeline into:
+  .cursor/rules/          \u2014 Cursor rules (*.mdc)
+  .github/prompts/        \u2014 GitHub Copilot prompt files (*.prompt.md)
+  .qwen/                  \u2014 Qwen instruction files (*.md)
+  .antigravity/           \u2014 Antigravity persona files (*.md)
+
+Options:
+  --targets=<list>    Comma-separated list of tools to target.
+                      Valid: cursor, copilot, qwen, antigravity, all
+                      Default: all
+  --root=<path>       Project root directory. Default: current working directory
+  --overwrite         Overwrite existing config files (default: skip existing)
+  --quiet, -q         Suppress progress output
+  --help, -h          Show this help message
+`);
+}
+async function main() {
+  if (process.env.SKIP_MULTI_AGENTS_POSTINSTALL === "1") {
+    return;
+  }
+  const installRoot = process.env.INIT_CWD ?? process.cwd();
+  const args = process.argv.slice(2);
+  const config = parseArgs(args);
+  if (config.help) {
+    printHelp();
+    return;
+  }
+  if (!args.some((a) => a.startsWith("--root="))) {
+    config.projectRoot = installRoot;
+  }
+  const generator = new ConfigGenerator(config);
+  try {
+    const result = await generator.generate();
+    if (!result.success) {
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error("multi-agents-custom: unexpected error during config generation:", err);
+    process.exit(1);
+  }
+}
+main();

package/dist/index.d.mts

@@ -0,0 +1,224 @@
+/**
+ * Supported AI tool targets that can receive generated config files.
+ */
+type ToolTarget = 'cursor' | 'copilot' | 'qwen' | 'antigravity' | 'all';
+/**
+ * The five agent roles in the software development pipeline.
+ */
+type AgentRole = 'pm' | 'ba' | 'techlead' | 'developer' | 'tester';
+/**
+ * A single agent persona definition used to generate config files.
+ */
+interface AgentPersona {
+    /** Agent role identifier */
+    role: AgentRole;
+    /** Human-readable display name */
+    name: string;
+    /** Short description of the agent's responsibilities */
+    description: string;
+    /** The system prompt / instruction content written into config files */
+    systemPrompt: string;
+    /** Optional tags/metadata embedded in the config file */
+    tags?: string[];
+}
+/**
+ * Configuration for the config-file generator.
+ */
+interface GeneratorConfig {
+    /**
+     * Which AI tool(s) to generate config files for.
+     * Use 'all' to generate for every supported tool.
+     * @default 'all'
+     */
+    targets?: ToolTarget | ToolTarget[];
+    /**
+     * Root directory of the project where config folders will be written.
+     * @default process.cwd()
+     */
+    projectRoot?: string;
+    /**
+     * Per-agent overrides for system prompts or metadata.
+     */
+    agents?: Partial<Record<AgentRole, Partial<AgentPersona>>>;
+    /**
+     * Whether to overwrite existing config files.
+     * @default false
+     */
+    overwrite?: boolean;
+    /**
+     * Whether to print progress to stdout.
+     * @default true
+     */
+    verbose?: boolean;
+}
+/**
+ * Result returned by a single file-write operation.
+ */
+interface WriteResult {
+    /** Absolute path of the file that was written (or skipped) */
+    filePath: string;
+    /** Whether the file was actually written */
+    written: boolean;
+    /** 'created' | 'overwritten' | 'skipped' (already exists, overwrite=false) */
+    status: 'created' | 'overwritten' | 'skipped';
+    /** Error message if the write failed */
+    error?: string;
+}
+/**
+ * Summary result returned after running the generator.
+ */
+interface GeneratorResult {
+    /** Whether all writes succeeded (no errors) */
+    success: boolean;
+    /** Per-file results */
+    files: WriteResult[];
+    /** Total files written (created + overwritten) */
+    written: number;
+    /** Total files skipped */
+    skipped: number;
+    /** Total files that encountered errors */
+    errors: number;
+}
+/**
+ * Interface every provider-specific writer must implement.
+ */
+interface IProviderWriter {
+    /** Tool target this writer handles */
+    readonly target: ToolTarget;
+    /**
+     * Generate all config files for the given personas into `projectRoot`.
+     * @returns array of WriteResult, one per file attempted
+     */
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+}
+
+/**
+ * ConfigGenerator orchestrates writing AI tool config files for all five
+ * agent personas into the appropriate native config folders of each target tool.
+ *
+ * No network calls are made — all operations are local file-system writes.
+ *
+ * @example
+ * ```ts
+ * import { ConfigGenerator } from 'multi-agents-custom';
+ *
+ * const generator = new ConfigGenerator({ targets: 'all', verbose: true });
+ * const result = await generator.generate();
+ * console.log(`Written: ${result.written}, Skipped: ${result.skipped}`);
+ * ```
+ */
+declare class ConfigGenerator {
+    private readonly config;
+    private readonly logger;
+    constructor(config?: GeneratorConfig);
+    /**
+     * Run the generator: resolve writers, build personas, and write all config files.
+     */
+    generate(): Promise<GeneratorResult>;
+}
+
+/**
+ * Default agent persona definitions aligned with the ai-devkit SDLC workflow.
+ *
+ * Each persona maps to one or more phases of the 8-phase development lifecycle:
+ *   1. New Requirement           (PM)
+ *   2. Review Requirements       (BA)
+ *   3. Review Design             (Tech Lead)
+ *   4. Execute Plan + 5. Update Planning  (Developer)
+ *   6. Check Implementation + 7. Write Tests + 8. Code Review  (Tester)
+ *
+ * Workflow conventions (ai-devkit):
+ *   - Phase docs:  docs/ai/{requirements,design,planning,implementation,testing}/feature-{name}.md
+ *   - Memory:      npx ai-devkit@latest memory search/store
+ *   - Clarification loops: actively ask questions; never proceed with ambiguity
+ *   - Mermaid diagrams required in every design doc
+ *   - 100 % test coverage target
+ *
+ * @see https://github.com/codeaholicguy/ai-devkit
+ */
+declare const DEFAULT_PERSONAS: AgentPersona[];
+/**
+ * Returns all default personas, optionally merged with per-role overrides.
+ */
+declare function buildPersonas(overrides?: Partial<Record<string, Partial<AgentPersona>>>): AgentPersona[];
+
+/**
+ * Generates `.cursor/rules/<role>.mdc` files.
+ *
+ * Cursor reads `.mdc` files from the `.cursor/rules/` directory and surfaces
+ * them as "Rules" in the Cursor editor — the content is applied as a system
+ * prompt when the matching file or context is active.
+ *
+ * Format: YAML front-matter followed by the instruction body.
+ *
+ * @see https://docs.cursor.com/context/rules-for-ai
+ */
+declare class CursorWriter implements IProviderWriter {
+    readonly target: "cursor";
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+    private renderMdc;
+}
+
+/**
+ * Generates `.github/prompts/<role>.prompt.md` files.
+ *
+ * GitHub Copilot (VS Code extension ≥ 0.22 / Copilot Chat) reads prompt files
+ * from `.github/prompts/` and exposes them as reusable slash-command prompts.
+ * The YAML front-matter `mode` and `description` fields control how Copilot
+ * presents and applies the prompt.
+ *
+ * @see https://code.visualstudio.com/docs/copilot/copilot-customization#_prompt-files-experimental
+ */
+declare class CopilotWriter implements IProviderWriter {
+    readonly target: "copilot";
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+    private renderPrompt;
+}
+
+/**
+ * Generates `.qwen/<role>.md` files.
+ *
+ * Qwen (Alibaba Cloud's AI coding assistant) reads markdown instruction files
+ * from the `.qwen/` directory in the project root.  Each file represents a
+ * named persona / mode that the assistant can adopt.
+ *
+ * @see https://qwen.readthedocs.io/en/latest/getting_started/quickstart.html
+ */
+declare class QwenWriter implements IProviderWriter {
+    readonly target: "qwen";
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+    private renderInstruction;
+}
+
+/**
+ * Generates `.antigravity/<role>.md` files.
+ *
+ * Antigravity reads markdown persona files from the `.antigravity/` directory.
+ * The front-matter `role` field is used by the tool to match the persona to
+ * its internal routing — the body becomes the system prompt.
+ */
+declare class AntigravityWriter implements IProviderWriter {
+    readonly target: "antigravity";
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+    private renderPersona;
+}
+
+/**
+ * Returns the list of writers to use for the given target(s).
+ *
+ * @param targets - A single target, array of targets, or 'all'.
+ */
+declare function resolveWriters(targets: ToolTarget | ToolTarget[]): IProviderWriter[];
+
+declare class Logger {
+    private readonly verbose;
+    constructor(verbose?: boolean);
+    info(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    skip(msg: string): void;
+    heading(msg: string): void;
+}
+
+export { type AgentPersona, type AgentRole, AntigravityWriter, ConfigGenerator, CopilotWriter, CursorWriter, DEFAULT_PERSONAS, type GeneratorConfig, type GeneratorResult, type IProviderWriter, Logger, QwenWriter, type ToolTarget, type WriteResult, buildPersonas, resolveWriters };

package/dist/index.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Supported AI tool targets that can receive generated config files.
+ */
+type ToolTarget = 'cursor' | 'copilot' | 'qwen' | 'antigravity' | 'all';
+/**
+ * The five agent roles in the software development pipeline.
+ */
+type AgentRole = 'pm' | 'ba' | 'techlead' | 'developer' | 'tester';
+/**
+ * A single agent persona definition used to generate config files.
+ */
+interface AgentPersona {
+    /** Agent role identifier */
+    role: AgentRole;
+    /** Human-readable display name */
+    name: string;
+    /** Short description of the agent's responsibilities */
+    description: string;
+    /** The system prompt / instruction content written into config files */
+    systemPrompt: string;
+    /** Optional tags/metadata embedded in the config file */
+    tags?: string[];
+}
+/**
+ * Configuration for the config-file generator.
+ */
+interface GeneratorConfig {
+    /**
+     * Which AI tool(s) to generate config files for.
+     * Use 'all' to generate for every supported tool.
+     * @default 'all'
+     */
+    targets?: ToolTarget | ToolTarget[];
+    /**
+     * Root directory of the project where config folders will be written.
+     * @default process.cwd()
+     */
+    projectRoot?: string;
+    /**
+     * Per-agent overrides for system prompts or metadata.
+     */
+    agents?: Partial<Record<AgentRole, Partial<AgentPersona>>>;
+    /**
+     * Whether to overwrite existing config files.
+     * @default false
+     */
+    overwrite?: boolean;
+    /**
+     * Whether to print progress to stdout.
+     * @default true
+     */
+    verbose?: boolean;
+}
+/**
+ * Result returned by a single file-write operation.
+ */
+interface WriteResult {
+    /** Absolute path of the file that was written (or skipped) */
+    filePath: string;
+    /** Whether the file was actually written */
+    written: boolean;
+    /** 'created' | 'overwritten' | 'skipped' (already exists, overwrite=false) */
+    status: 'created' | 'overwritten' | 'skipped';
+    /** Error message if the write failed */
+    error?: string;
+}
+/**
+ * Summary result returned after running the generator.
+ */
+interface GeneratorResult {
+    /** Whether all writes succeeded (no errors) */
+    success: boolean;
+    /** Per-file results */
+    files: WriteResult[];
+    /** Total files written (created + overwritten) */
+    written: number;
+    /** Total files skipped */
+    skipped: number;
+    /** Total files that encountered errors */
+    errors: number;
+}
+/**
+ * Interface every provider-specific writer must implement.
+ */
+interface IProviderWriter {
+    /** Tool target this writer handles */
+    readonly target: ToolTarget;
+    /**
+     * Generate all config files for the given personas into `projectRoot`.
+     * @returns array of WriteResult, one per file attempted
+     */
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+}
+
+/**
+ * ConfigGenerator orchestrates writing AI tool config files for all five
+ * agent personas into the appropriate native config folders of each target tool.
+ *
+ * No network calls are made — all operations are local file-system writes.
+ *
+ * @example
+ * ```ts
+ * import { ConfigGenerator } from 'multi-agents-custom';
+ *
+ * const generator = new ConfigGenerator({ targets: 'all', verbose: true });
+ * const result = await generator.generate();
+ * console.log(`Written: ${result.written}, Skipped: ${result.skipped}`);
+ * ```
+ */
+declare class ConfigGenerator {
+    private readonly config;
+    private readonly logger;
+    constructor(config?: GeneratorConfig);
+    /**
+     * Run the generator: resolve writers, build personas, and write all config files.
+     */
+    generate(): Promise<GeneratorResult>;
+}
+
+/**
+ * Default agent persona definitions aligned with the ai-devkit SDLC workflow.
+ *
+ * Each persona maps to one or more phases of the 8-phase development lifecycle:
+ *   1. New Requirement           (PM)
+ *   2. Review Requirements       (BA)
+ *   3. Review Design             (Tech Lead)
+ *   4. Execute Plan + 5. Update Planning  (Developer)
+ *   6. Check Implementation + 7. Write Tests + 8. Code Review  (Tester)
+ *
+ * Workflow conventions (ai-devkit):
+ *   - Phase docs:  docs/ai/{requirements,design,planning,implementation,testing}/feature-{name}.md
+ *   - Memory:      npx ai-devkit@latest memory search/store
+ *   - Clarification loops: actively ask questions; never proceed with ambiguity
+ *   - Mermaid diagrams required in every design doc
+ *   - 100 % test coverage target
+ *
+ * @see https://github.com/codeaholicguy/ai-devkit
+ */
+declare const DEFAULT_PERSONAS: AgentPersona[];
+/**
+ * Returns all default personas, optionally merged with per-role overrides.
+ */
+declare function buildPersonas(overrides?: Partial<Record<string, Partial<AgentPersona>>>): AgentPersona[];
+
+/**
+ * Generates `.cursor/rules/<role>.mdc` files.
+ *
+ * Cursor reads `.mdc` files from the `.cursor/rules/` directory and surfaces
+ * them as "Rules" in the Cursor editor — the content is applied as a system
+ * prompt when the matching file or context is active.
+ *
+ * Format: YAML front-matter followed by the instruction body.
+ *
+ * @see https://docs.cursor.com/context/rules-for-ai
+ */
+declare class CursorWriter implements IProviderWriter {
+    readonly target: "cursor";
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+    private renderMdc;
+}
+
+/**
+ * Generates `.github/prompts/<role>.prompt.md` files.
+ *
+ * GitHub Copilot (VS Code extension ≥ 0.22 / Copilot Chat) reads prompt files
+ * from `.github/prompts/` and exposes them as reusable slash-command prompts.
+ * The YAML front-matter `mode` and `description` fields control how Copilot
+ * presents and applies the prompt.
+ *
+ * @see https://code.visualstudio.com/docs/copilot/copilot-customization#_prompt-files-experimental
+ */
+declare class CopilotWriter implements IProviderWriter {
+    readonly target: "copilot";
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+    private renderPrompt;
+}
+
+/**
+ * Generates `.qwen/<role>.md` files.
+ *
+ * Qwen (Alibaba Cloud's AI coding assistant) reads markdown instruction files
+ * from the `.qwen/` directory in the project root.  Each file represents a
+ * named persona / mode that the assistant can adopt.
+ *
+ * @see https://qwen.readthedocs.io/en/latest/getting_started/quickstart.html
+ */
+declare class QwenWriter implements IProviderWriter {
+    readonly target: "qwen";
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+    private renderInstruction;
+}
+
+/**
+ * Generates `.antigravity/<role>.md` files.
+ *
+ * Antigravity reads markdown persona files from the `.antigravity/` directory.
+ * The front-matter `role` field is used by the tool to match the persona to
+ * its internal routing — the body becomes the system prompt.
+ */
+declare class AntigravityWriter implements IProviderWriter {
+    readonly target: "antigravity";
+    write(personas: AgentPersona[], projectRoot: string, overwrite: boolean): Promise<WriteResult[]>;
+    private renderPersona;
+}
+
+/**
+ * Returns the list of writers to use for the given target(s).
+ *
+ * @param targets - A single target, array of targets, or 'all'.
+ */
+declare function resolveWriters(targets: ToolTarget | ToolTarget[]): IProviderWriter[];
+
+declare class Logger {
+    private readonly verbose;
+    constructor(verbose?: boolean);
+    info(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    skip(msg: string): void;
+    heading(msg: string): void;
+}
+
+export { type AgentPersona, type AgentRole, AntigravityWriter, ConfigGenerator, CopilotWriter, CursorWriter, DEFAULT_PERSONAS, type GeneratorConfig, type GeneratorResult, type IProviderWriter, Logger, QwenWriter, type ToolTarget, type WriteResult, buildPersonas, resolveWriters };