@tacuchi/agent-factory 0.2.0 → 0.4.0

package/bin/agent-factory.js

@@ -38,6 +38,8 @@ program
   .option('-s, --scope <path>', 'Repository path (for stack detection)')
   .option('-o, --output <path>', 'Output directory (default: current dir)')
   .option('-t, --target <target>', 'Target: claude, codex, all', 'all')
+  .option('--stack <csv>', 'Override detected stack (comma-separated)')
+  .option('--dry-run', 'Preview generated agent without writing files')
   .option('--tools <tools>', 'Comma-separated tools: Read,Write,Edit,Bash')
   .option('--specialists <list>', 'CSV list of specialist agent names (for coordinator role)')
   .option('--repo-count <n>', 'Number of repos in workspace (for coordinator role)', parseInt)

package/package.json

@@ -1,45 +1 @@
-{
-"name": "@tacuchi/agent-factory",
-"version": "0.2.0",
-  "description": "CLI to create AI agents for Claude Code, Codex, Gemini CLI and more",
-  "bin": {
-    "agent-factory": "bin/agent-factory.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "templates/",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=16"
-  },
-  "scripts": {
-    "test": "node --test tests/",
-    "start": "node bin/agent-factory.js"
-  },
-  "keywords": [
-    "claude-code",
-    "agents",
-    "codex",
-    "gemini",
-    "ai",
-    "cli",
-    "agent-factory"
-  ],
-  "author": "tacuchi",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/tacuchi/agent-factory"
-  },
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "commander": "^11.1.0",
-    "fs-extra": "^11.2.0",
-    "inquirer": "^8.2.6",
-    "js-yaml": "^4.1.0",
-    "ora": "^5.4.1"
-  }
-}
+{"name":"@tacuchi/agent-factory","version":"0.4.0","description":"CLI to create AI agents for Claude Code, Codex, Gemini CLI and more","bin":{"agent-factory":"bin/agent-factory.js"},"files":["bin/","src/","templates/","README.md","LICENSE"],"engines":{"node":">=16"},"scripts":{"test":"node --test tests/*.test.js","start":"node bin/agent-factory.js"},"keywords":["claude-code","agents","codex","gemini","ai","cli","agent-factory"],"author":"tacuchi","license":"MIT","repository":{"type":"git","url":"https://github.com/tacuchi/agent-factory"},"dependencies":{"chalk":"^4.1.2","commander":"^11.1.0","fs-extra":"^11.2.0","inquirer":"^8.2.6","js-yaml":"^4.1.0","ora":"^5.4.1"}}

package/src/commands/create.js

@@ -10,7 +10,7 @@ async function runCreate(options = {}) {
   const isInteractive = !options.name;
   const config = isInteractive ? await askCreateOptions() : normalizeFlags(options);
 
-  const { name, role, model, scope, output, target, tools, specialists, repoCount, description, instructions } = config;
+  const { name, role, model, scope, output, target, tools, specialists, repoCount, description, instructions, stack, dryRun } = config;
 
   const spin = spinner('Generating agent...').start();
 
@@ -21,13 +21,27 @@ async function runCreate(options = {}) {
     spin.succeed('Custom agent generated');
   } else {
     let stackResult = { primaryTech: 'Generic', framework: '', verifyCommands: '', stackParts: [], stackCsv: 'Generic' };
-    if (scope) {
+    if (stack) {
+      const parts = stack.split(',').map(s => s.trim()).filter(Boolean);
+      stackResult = {
+        primaryTech: parts[0] || 'Generic',
+        framework: parts[1] || '',
+        verifyCommands: '',
+        stackParts: parts,
+        stackCsv: parts.join(', '),
+      };
+    } else if (scope) {
       stackResult = await detect(scope);
     }
 
+    const techLabel = stackResult.framework
+      ? `${stackResult.framework} (${stackResult.primaryTech})`
+      : stackResult.primaryTech;
+
     const templateData = {
       name,
       primary_tech: stackResult.primaryTech,
+      tech_label: techLabel,
       framework: stackResult.framework,
       scope: scope || '.',
       stack_list: stackResult.stackParts.length > 0
@@ -38,8 +52,6 @@ async function runCreate(options = {}) {
       specialist_list: formatSpecialistList(specialists),
       N: repoCount ? String(repoCount) : '',
       repos_word: repoCount === 1 ? 'repositorio' : 'repositorios',
-      skills_section: '',
-      mcp_section: '',
     };
 
     const templateFile = `${role}.md.tmpl`;
@@ -58,6 +70,13 @@ async function runCreate(options = {}) {
   if (target === 'claude' || target === 'all') targetDirs.push('.claude/agents/');
   if (target === 'codex' || target === 'all') targetDirs.push('.agents/');
 
+  if (dryRun) {
+    log.info('--- DRY RUN: Agent preview ---');
+    console.log(body);
+    log.info('--- End preview ---');
+    return;
+  }
+
   if (!options.yes && isInteractive) {
     const confirmed = await confirmGeneration(name, targetDirs);
     if (!confirmed) {
@@ -113,6 +132,8 @@ function normalizeFlags(options) {
     repoCount: options.repoCount || 0,
     description: options.description || '',
     instructions: options.instructions || '',
+    stack: options.stack || '',
+    dryRun: options.dryRun || false,
   };
 }
 
@@ -138,4 +159,4 @@ async function resolveCustomBody(instructions, name, description) {
   return `# ${name}\n\n${instructions}\n`;
 }
 
-module.exports = { runCreate };
+module.exports = { runCreate, normalizeFlags, formatSpecialistList };

package/src/core/agent-writer.js

@@ -37,7 +37,12 @@ function buildSkillsFormat(name, description, body) {
   return `---\nname: ${name}\ndescription: "${description}"\n---\n\n${body}\n`;
 }
 
-async function writeAgent({ name, role, model, tools, body, outputDir, target, description: customDesc }) {
+function ensureAgentSuffix(name) {
+  return name.endsWith('-agent') ? name : `${name}-agent`;
+}
+
+async function writeAgent({ name: rawName, role, model, tools, body, outputDir, target, description: customDesc }) {
+  const name = ensureAgentSuffix(rawName);
   const results = { claude: null, codex: null, skills: null };
   const description = customDesc || body.split('\n').find((l) => l.trim() && !l.startsWith('#'))?.trim() || name;
 
@@ -73,4 +78,4 @@ async function writeAgent({ name, role, model, tools, body, outputDir, target, d
   return results;
 }
 
-module.exports = { writeAgent, buildClaudeFormat, buildCodexFormat, buildSkillsFormat, buildDescription, TOOLS_BY_ROLE };
+module.exports = { writeAgent, buildClaudeFormat, buildCodexFormat, buildSkillsFormat, buildDescription, ensureAgentSuffix, TOOLS_BY_ROLE };

package/src/core/stack-detector.js

@@ -112,6 +112,20 @@ async function detect(repoPath) {
         verifyCommands = 'npm run build, npm test';
         stackParts.push('Node.js');
       }
+
+      // Fallback: Node.js CLI (has bin field) or plain JS
+      if (!primaryTech && pkg) {
+        if (pkg.bin) {
+          primaryTech = 'Node.js';
+          framework = 'CLI';
+          verifyCommands = 'npm test';
+          stackParts.push('Node.js', 'CLI');
+        } else {
+          primaryTech = 'JavaScript';
+          verifyCommands = 'npm test';
+          stackParts.push('JavaScript');
+        }
+      }
     }
   }
 
@@ -267,6 +281,26 @@ async function detect(repoPath) {
     }
   }
 
+  // --- Shell / Bash ---
+  if (!primaryTech) {
+    const shFiles = await findFiles(abs, ['.sh'], 1);
+    if (shFiles.length > 0) {
+      primaryTech = 'Bash';
+      framework = 'Shell';
+      verifyCommands = 'bash -n *.sh, shellcheck *.sh';
+      stackParts.push('Bash', 'Shell');
+    }
+  }
+
+  // --- Makefile (standalone) ---
+  if (!primaryTech) {
+    if (await fs.pathExists(path.join(abs, 'Makefile'))) {
+      primaryTech = 'Make';
+      verifyCommands = 'make';
+      stackParts.push('Make');
+    }
+  }
+
   // --- Supplementary ---
   if (await fs.pathExists(path.join(abs, 'tsconfig.json'))) {
     if (!stackParts.includes('TypeScript') && primaryTech !== 'TypeScript') {

package/templates/roles/coordinator.md.tmpl

@@ -32,5 +32,3 @@ Cada especialista opera exclusivamente dentro de su repo asignado. Para ejecutar
 ## Agentes globales (gestionados por el usuario)
 
 Si el usuario ha creado agentes globales/personales en el workspace (por ejemplo, agentes transversales de arquitectura, estilo o revision de codigo), puedes invocarlos para obtener analisis cross-repo. Estos agentes son gestionados directamente por el usuario y pueden no estar presentes en todos los workspaces.
-{{skills_section}}
-{{mcp_section}}

package/templates/roles/specialist.md.tmpl

@@ -1,6 +1,6 @@
 # {{name}}
 
-Especialista {{primary_tech}} — scope exclusivo: `{{scope}}`
+Especialista {{tech_label}} — scope exclusivo: `{{scope}}`
 
 ## Stack