@amrhas82/agentic-kit 1.0.0 → 1.2.0

package/packages/ampcode/hooks/register-agents.js

@@ -0,0 +1,128 @@
+/**
+ * register-agents.js
+ * Auto-discovery mechanism that scans agents/ directory
+ * Extracts metadata from agent files
+ * Registers all agents in context.agentRegistry
+ * Enables auto-invocation for amplified development workflows
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Parse agent metadata from markdown file
+ * Looks for frontmatter and specific headers
+ */
+function parseAgentMetadata(filePath) {
+  const content = fs.readFileSync(filePath, 'utf-8');
+
+  const agent = {
+    id: path.basename(filePath, '.md'),
+    name: '',
+    description: '',
+    role: '',
+    capabilities: [],
+    filePath: filePath,
+    tool: 'ampcode'
+  };
+
+  // Extract title/name from first heading
+  const titleMatch = content.match(/^#\s+(.+)$/m);
+  if (titleMatch) {
+    agent.name = titleMatch[1].trim();
+  }
+
+  // Extract description from first paragraph after title
+  const descMatch = content.match(/^#\s+.+\n\n(.+?)(?:\n\n|##)/s);
+  if (descMatch) {
+    agent.description = descMatch[1].trim();
+  }
+
+  // Extract role section if it exists
+  const roleMatch = content.match(/##\s+Role\n\n(.+?)(?=\n##)/s);
+  if (roleMatch) {
+    agent.role = roleMatch[1].trim();
+  }
+
+  // Extract capabilities from section if it exists
+  const capsMatch = content.match(/##\s+Capabilities\n\n([\s\S]+?)(?=\n##|$)/);
+  if (capsMatch) {
+    const capsText = capsMatch[1];
+    agent.capabilities = capsText
+      .split('\n')
+      .filter(line => line.trim().startsWith('-'))
+      .map(line => line.replace(/^-\s+/, '').trim());
+  }
+
+  return agent;
+}
+
+/**
+ * Scan agents/ directory and register all agents
+ * Ampcode uses same structure as Claude for installer compatibility
+ */
+function registerAgents(agentsDir) {
+  const registry = {};
+
+  try {
+    if (!fs.existsSync(agentsDir)) {
+      console.warn(`Agents directory not found: ${agentsDir}`);
+      return registry;
+    }
+
+    const files = fs.readdirSync(agentsDir);
+    const mdFiles = files.filter(f => f.endsWith('.md'));
+
+    mdFiles.forEach(file => {
+      try {
+        const filePath = path.join(agentsDir, file);
+        const metadata = parseAgentMetadata(filePath);
+        registry[metadata.id] = metadata;
+        console.log(`[Ampcode] Registered agent: ${metadata.id} - ${metadata.name}`);
+      } catch (error) {
+        console.error(`Failed to register agent ${file}:`, error.message);
+      }
+    });
+
+  } catch (error) {
+    console.error(`Failed to scan agents directory: ${error.message}`);
+  }
+
+  return registry;
+}
+
+/**
+ * Auto-invocation handler for amplified workflows
+ * Matches user commands to available agents and invokes them
+ * Optimized for velocity and automation
+ */
+function createAutoInvocationHandler(registry) {
+  return function invokeAgent(agentId, context) {
+    const agent = registry[agentId];
+
+    if (!agent) {
+      throw new Error(`Agent not found: ${agentId}`);
+    }
+
+    // Agent would be invoked here with appropriate context
+    // Amplified mode: fast execution, automation-ready
+    return {
+      agentId: agent.id,
+      name: agent.name,
+      description: agent.description,
+      role: agent.role,
+      capabilities: agent.capabilities,
+      context: context,
+      optimization: 'amplified-codegen'
+    };
+  };
+}
+
+/**
+ * Module exports
+ */
+module.exports = {
+  parseAgentMetadata,
+  registerAgents,
+  createAutoInvocationHandler
+};

package/packages/ampcode/hooks/session-start.js

@@ -0,0 +1,168 @@
+/**
+ * session-start.js
+ *
+ * This hook runs at the start of every Ampcode session.
+ * It ensures all skills defined in the active variant are loaded and available.
+ *
+ * Purpose:
+ * - Load variant-specific skills automatically
+ * - Register agents for auto-invocation
+ * - Initialize any session-specific resources
+ * - Provide amplified development session startup feedback
+ * - Optimize for velocity and automation workflows
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Load and activate skills for the current variant
+ * Ampcode uses same structure as Claude for installer compatibility
+ */
+function loadSkills(skillsDir, skillsList) {
+  const loadedSkills = [];
+
+  if (!skillsList || skillsList.length === 0) {
+    console.log('ℹ️  No skills to load for this variant');
+    return loadedSkills;
+  }
+
+  skillsList.forEach(skill => {
+    try {
+      const skillPath = path.join(skillsDir, skill.path);
+
+      if (fs.existsSync(skillPath)) {
+        loadedSkills.push({
+          id: skill.id,
+          name: skill.name,
+          path: skill.path,
+          status: 'loaded'
+        });
+        console.log(`✅ Loaded skill: ${skill.name}`);
+      } else {
+        console.warn(`⚠️  Skill not found: ${skill.name} at ${skillPath}`);
+      }
+    } catch (error) {
+      console.error(`❌ Failed to load skill ${skill.name}:`, error.message);
+    }
+  });
+
+  return loadedSkills;
+}
+
+/**
+ * Initialize agents for the session
+ * Ampcode uses same structure as Claude for installer compatibility
+ */
+function initializeAgents(agentsDir, agentsList) {
+  const activeAgents = [];
+
+  agentsList.forEach(agent => {
+    try {
+      const agentPath = path.join(agentsDir, agent.path);
+
+      if (fs.existsSync(agentPath)) {
+        activeAgents.push({
+          id: agent.id,
+          name: agent.name,
+          status: 'ready'
+        });
+      }
+    } catch (error) {
+      console.error(`❌ Failed to initialize agent ${agent.name}:`, error.message);
+    }
+  });
+
+  return activeAgents;
+}
+
+/**
+ * Display amplified development session start banner
+ */
+function displayBanner(variant, agentCount, skillCount) {
+  const variantColors = {
+    lite: '\x1b[32m',      // Green
+    standard: '\x1b[34m',   // Blue
+    pro: '\x1b[35m'        // Magenta
+  };
+
+  const color = variantColors[variant] || '\x1b[36m'; // Default cyan
+  const reset = '\x1b[0m';
+  const bold = '\x1b[1m';
+
+  console.log(`
+${bold}${color}╔═══════════════════════════════════════════════╗${reset}
+${bold}${color}║      Ampcode - ${variant.charAt(0).toUpperCase() + variant.slice(1)} Variant${' '.repeat(Math.max(0, 20 - variant.length))}║${reset}
+${bold}${color}║      Amplified AI Code Generation            ║${reset}
+${bold}${color}╚═══════════════════════════════════════════════╝${reset}
+
+✨ Session started successfully!
+
+📊 Active Components:
+   • Agents: ${agentCount}
+   • Skills: ${skillCount}
+
+💡 Quick Start (Amplified Mode):
+   • Invoke agents: ${color}@Master:${reset} help
+   • Execute skills: ${color}ampcode <skill> <args>${reset}
+   • Automation ready: ${color}ampcode --auto${reset}
+
+🚀 Optimization: ${bold}${color}amplified-codegen${reset}
+   Maximum velocity, automation-focused workflows
+
+⚡ ${bold}Accelerated development mode active!${reset}
+`);
+}
+
+/**
+ * Main session start handler
+ */
+function onSessionStart(context) {
+  try {
+    // Get variant from context or default to standard
+    const variant = context.variant || 'standard';
+    const manifest = context.manifest || {};
+
+    const agentsList = manifest.agents || [];
+    const skillsList = manifest.skills || [];
+
+    // Load skills (same structure as Claude for installer compatibility)
+    const loadedSkills = loadSkills(context.skillsPath || './skills', skillsList);
+
+    // Initialize agents (same structure as Claude for installer compatibility)
+    const activeAgents = initializeAgents(context.agentsPath || './agents', agentsList);
+
+    // Display amplified development banner
+    displayBanner(variant, activeAgents.length, loadedSkills.length);
+
+    // Return session context with amplified optimization metadata
+    return {
+      variant,
+      agents: activeAgents,
+      skills: loadedSkills,
+      timestamp: new Date().toISOString(),
+      status: 'ready',
+      optimization: 'amplified-codegen',
+      tool: 'ampcode'
+    };
+
+  } catch (error) {
+    console.error('❌ Session start failed:', error.message);
+    console.log('⚠️  Plugin may not function correctly. Please restart or reinstall.');
+
+    return {
+      status: 'error',
+      error: error.message
+    };
+  }
+}
+
+/**
+ * Module exports
+ */
+module.exports = {
+  onSessionStart,
+  loadSkills,
+  initializeAgents,
+  displayBanner
+};

package/packages/ampcode/resources/agent-teams.yaml

@@ -0,0 +1,50 @@
+teams:
+  team-all:
+    bundle:
+      name: Team All
+      icon: "\U0001F465"
+      description: Includes every core system agent.
+    agents: -orchestrator - "*"
+    workflows:
+    - brownfield-fullstack.yaml
+    - brownfield-service.yaml
+    - brownfield-ui.yaml
+    - greenfield-fullstack.yaml
+    - greenfield-service.yaml
+    - greenfield-ui.yaml
+  team-fullstack:
+    bundle:
+      name: Team Fullstack
+      icon: "\U0001F680"
+      description: Team capable of full stack, front end only, or service development.
+    agents: -orchestrator - business-analyst - product-manager - ux-expert - architect
+      - product-owner
+    workflows:
+    - brownfield-fullstack.yaml
+    - brownfield-service.yaml
+    - brownfield-ui.yaml
+    - greenfield-fullstack.yaml
+    - greenfield-service.yaml
+    - greenfield-ui.yaml
+  team-ide-minimal:
+    bundle:
+      name: Team IDE Minimal
+      icon: "\u26A1"
+      description: Only the bare minimum for the IDE PO scrum-master dev qa cycle.
+    agents:
+    - product-owner
+    - scrum-master
+    - full-stack-dev
+    - qa-test-architect
+    workflows: null
+  team-no-ui:
+    bundle:
+      name: Team No UI
+      icon: "\U0001F527"
+      description: Team with no UX or UI Planning.
+    agents: -orchestrator - business-analyst - product-manager - architect - product-owner
+    workflows:
+    - greenfield-service.yaml
+    - brownfield-service.yaml
+created: '2025-11-01T17:48:47.232609'
+total_teams: 4