@wipal/agent-team 1.0.3 → 1.1.0

package/src/commands/add.js

@@ -8,11 +8,14 @@ import path from 'path';
 import {
   getClaudeDir,
   getAgentDir,
+  getAgentFilePath,
+  getAgentMemoryDir,
   isInitialized,
   agentExists,
   readTemplate,
   processTemplate,
-  copySkills
+  readRoleTemplate,
+  copyRoleRules
 } from '../utils/file-utils.js';
 import {
   resolveSkills,
@@ -22,6 +25,66 @@ import {
 } from '../utils/skill-resolver.js';
 import { runInteractiveAdd } from '../interactive/prompts.js';
 
+// Role configurations
+const ROLE_CONFIGS = {
+  'dev-fe': {
+    displayName: 'Frontend Developer',
+    description: 'Frontend development specialist. Use for React/Vue/Angular tasks, UI implementation, component design.',
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: '- [ ] Code runs, tests pass'
+  },
+  'dev-be': {
+    displayName: 'Backend Developer',
+    description: 'Backend development specialist. Use for API design, database work, server-side logic.',
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: '- [ ] Code runs, tests pass'
+  },
+  'sa': {
+    displayName: 'Solution Architect',
+    description: 'Solution Architect specialist. Use for system design, architecture decisions, tech selection.',
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: '- [ ] Architecture validated, ADRs complete'
+  },
+  'tech-lead': {
+    displayName: 'Tech Lead',
+    description: 'Technical leadership specialist. Use for code review, mentoring, technical decisions.',
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: '- [ ] Code reviewed, tests pass'
+  },
+  'devops': {
+    displayName: 'DevOps Engineer',
+    description: 'DevOps specialist. Use for CI/CD, deployment, infrastructure.',
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: '- [ ] Deployment verified'
+  },
+  'pm': {
+    displayName: 'Product Manager',
+    description: 'Product management specialist. Use for requirements, user stories, sprint planning.',
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: '- [ ] Requirements traceable, stakeholders aligned'
+  },
+  'ba': {
+    displayName: 'Business Analyst',
+    description: 'Business analysis specialist. Use for requirements analysis, PRD creation, stakeholder communication.',
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: '- [ ] Documentation accurate, acceptance criteria met'
+  },
+  'qa': {
+    displayName: 'QA Engineer',
+    description: 'Quality assurance specialist. Use for testing, bug reporting, test automation.',
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: '- [ ] Tests pass, bugs documented'
+  }
+};
+
 /**
  * Add a new agent
  */
@@ -84,7 +147,8 @@ export async function addCommand(name, role, options) {
  * Create agent with given configuration
  */
 export async function createAgent(name, role, variants, projectRoot) {
-  const agentDir = getAgentDir(name, projectRoot);
+  const agentFilePath = getAgentFilePath(name, projectRoot);
+  const agentMemoryDir = getAgentMemoryDir(name, projectRoot);
   const projectName = path.basename(projectRoot);
 
   console.log(chalk.blue('🚀 Creating agent...'));
@@ -98,9 +162,14 @@ export async function createAgent(name, role, variants, projectRoot) {
   }
   console.log('');
 
-  // Create agent directory
-  await fs.ensureDir(agentDir);
-  await fs.ensureDir(path.join(agentDir, 'skills'));
+  // Get role config
+  const roleConfig = ROLE_CONFIGS[role] || {
+    displayName: role,
+    description: `${role} specialist.`,
+    tools: 'Read, Write, Edit, Bash, Grep, Glob',
+    model: 'inherit',
+    verificationChecklist: ''
+  };
 
   // Resolve skills
   console.log(chalk.blue('   Resolving skills...'));
@@ -113,46 +182,53 @@ export async function createAgent(name, role, variants, projectRoot) {
     console.log(chalk.gray(`   Variant skills: ${skills.variants.join(', ')}`));
   }
 
-  // Copy skills
-  console.log(chalk.blue('   Copying skills...'));
-  const copiedSkills = await copySkills(allSkills, agentDir);
-  console.log(chalk.green(`   ✓ Copied ${copiedSkills.length} skills`));
+  // Create agent memory directory
+  console.log(chalk.blue('   Creating agent memory directory...'));
+  await fs.ensureDir(agentMemoryDir);
+
+  // Ensure agents directory exists
+  await fs.ensureDir(path.dirname(agentFilePath));
+
+  // Copy role-specific rules
+  console.log(chalk.blue('   Copying role rules...'));
+  const copiedRule = await copyRoleRules(role, projectRoot);
+  if (copiedRule) {
+    console.log(chalk.green(`   ✓ Copied role rules: ${copiedRule}`));
+  } else {
+    console.log(chalk.gray('   ℹ No additional role rules needed'));
+  }
 
-  // Create CLAUDE.md
-  console.log(chalk.blue('   Creating CLAUDE.md...'));
-  await createClaudeMd(name, role, variants, skills, projectName, agentDir);
-  console.log(chalk.green('   ✓ Created CLAUDE.md'));
+  // Create agent .md file
+  console.log(chalk.blue('   Creating agent file...'));
+  await createAgentMd(name, role, variants, skills, roleConfig, projectName, agentFilePath);
+  console.log(chalk.green(`   ✓ Created ${name}.md`));
 
-  // Create knowledge.md
+  // Create knowledge.md in agent-memory
   console.log(chalk.blue('   Creating knowledge.md...'));
-  await createKnowledgeMd(name, role, agentDir);
+  await createKnowledgeMd(name, role, agentMemoryDir);
   console.log(chalk.green('   ✓ Created knowledge.md'));
 
-  // Create variants.json
-  console.log(chalk.blue('   Creating variants.json...'));
-  await createVariantsJson(name, role, variants, skills, agentDir);
-  console.log(chalk.green('   ✓ Created variants.json'));
-
   // Summary
   console.log('');
   console.log(chalk.green('✅ Agent created successfully!'));
   console.log('');
-  console.log(chalk.blue('Agent location:'));
-  console.log(chalk.gray(`   ${agentDir}`));
+  console.log(chalk.blue('Agent files:'));
+  console.log(chalk.gray(`   ${agentFilePath}`));
+  console.log(chalk.gray(`   ${agentMemoryDir}/knowledge.md`));
   console.log('');
-  console.log(chalk.blue('To use this agent in Claude Code:'));
-  console.log(chalk.cyan(`   npx @wipal/agent-team switch ${name}`));
+  console.log(chalk.blue('To use this agent:'));
+  console.log(chalk.cyan(`   /${name} <task>`));
+  console.log(chalk.gray('   or Claude will auto-delegate based on task description'));
   console.log('');
 }
 
 /**
- * Create CLAUDE.md for agent
+ * Create agent .md file with frontmatter
  */
-async function createClaudeMd(name, role, variants, skills, projectName, agentDir) {
-  const roleInfo = AVAILABLE_ROLES.find(r => r.name === role);
-
-  // Build role skills list
-  const roleSkillsList = skills.role.map(s => `  - ${s}`).join('\n');
+async function createAgentMd(name, role, variants, skills, roleConfig, projectName, agentFilePath) {
+  // Build skills YAML
+  const allSkillsList = [...skills.core, ...skills.role, ...skills.variants];
+  const skillsYaml = allSkillsList.map(s => `  - ${s}`).join('\n');
 
   // Build tech stack from variants
   const techStack = Object.entries(variants)
@@ -166,27 +242,42 @@ async function createClaudeMd(name, role, variants, skills, projectName, agentDi
     .map(([k, v]) => `- ${k}: ${v}`)
     .join('\n');
 
-  // Build skills list
-  const skillsList = allSkills => allSkills.map(s => `- ${s}`).join('\n');
+  // Build skills list for display
+  const skillsList = allSkillsList.map(s => `- ${s}`).join('\n');
+
+  // Get role behavioral template
+  let roleBehavioralTemplate = '';
+  const roleTemplate = await readRoleTemplate(role);
+  if (roleTemplate) {
+    roleBehavioralTemplate = roleTemplate;
+  }
+
+  // Build role skills description
+  const roleSkillsDesc = skills.role.map(s => `- ${s}`).join('\n');
 
-  const template = await readTemplate('CLAUDE.md.tmpl');
+  const template = await readTemplate('agent.md.tmpl');
   const content = processTemplate(template, {
-    PROJECT_NAME: projectName,
     AGENT_NAME: name,
-    ROLE_NAME: role,
-    ROLE_SKILLS: roleSkillsList,
+    AGENT_DESCRIPTION: roleConfig.description,
+    AGENT_TOOLS: roleConfig.tools,
+    AGENT_MODEL: roleConfig.model,
+    AGENT_SKILLS_YAML: skillsYaml,
+    ROLE_DISPLAY_NAME: roleConfig.displayName,
+    ROLE_SKILLS: roleSkillsDesc || `- ${role} tasks`,
+    ROLE_BEHAVIORAL_TEMPLATE: roleBehavioralTemplate,
+    ROLE_VERIFICATION_CHECKLIST: roleConfig.verificationChecklist,
     TECH_STACK: techStack || '- [Configure your tech stack]',
     VARIANTS_LIST: variantsList || '- [No variants selected]',
-    SKILLS_LIST: skillsList(getAllSkills(role, variants))
+    SKILLS_LIST: skillsList || '- [No skills]'
   });
 
-  await fs.writeFile(path.join(agentDir, 'CLAUDE.md'), content);
+  await fs.writeFile(agentFilePath, content);
 }
 
 /**
  * Create knowledge.md for agent
  */
-async function createKnowledgeMd(name, role, agentDir) {
+async function createKnowledgeMd(name, role, agentMemoryDir) {
   const now = new Date().toISOString();
   const template = await readTemplate('knowledge.md.tmpl');
   const content = processTemplate(template, {
@@ -196,32 +287,5 @@ async function createKnowledgeMd(name, role, agentDir) {
     DATE: now.split('T')[0]
   });
 
-  await fs.writeFile(path.join(agentDir, 'knowledge.md'), content);
-}
-
-/**
- * Create variants.json for agent
- */
-async function createVariantsJson(name, role, variants, skills, agentDir) {
-  const now = new Date().toISOString();
-
-  const content = {
-    agent_name: name,
-    base_role: role,
-    created_at: now,
-    updated_at: now,
-    installed_variants: variants,
-    skills: {
-      core: skills.core,
-      role: skills.role,
-      variants: skills.variants
-    },
-    skill_status: {
-      last_checked: now,
-      all_available: true,
-      missing_skills: []
-    }
-  };
-
-  await fs.writeJson(path.join(agentDir, 'variants.json'), content, { spaces: 2 });
+  await fs.writeFile(path.join(agentMemoryDir, 'knowledge.md'), content);
 }