agentsys 5.2.1 → 5.3.1

package/bin/cli.js

@@ -22,7 +22,7 @@ const discovery = require('../lib/discovery');
 const transforms = require('../lib/adapter-transforms');
 
 // Valid tool names
-const VALID_TOOLS = ['claude', 'opencode', 'codex', 'cursor'];
+const VALID_TOOLS = ['claude', 'opencode', 'codex', 'cursor', 'kiro'];
 
 function getInstallDir() {
   const home = process.env.HOME || process.env.USERPROFILE;
@@ -949,6 +949,9 @@ function detectInstalledPlatforms() {
   // Cursor rules are project-scoped; detect only if Cursor rules/commands/skills exist in CWD
   const cursorDir = path.join(process.cwd(), '.cursor');
   if (fs.existsSync(path.join(cursorDir, 'rules')) || fs.existsSync(path.join(cursorDir, 'commands')) || fs.existsSync(path.join(cursorDir, 'skills'))) platforms.push('cursor');
+  // Kiro is project-scoped; detect if .kiro/ directory exists in CWD
+  const kiroDir = path.join(process.cwd(), '.kiro');
+  if (fs.existsSync(path.join(kiroDir, 'steering')) || fs.existsSync(path.join(kiroDir, 'skills')) || fs.existsSync(path.join(kiroDir, 'agents'))) platforms.push('kiro');
   return platforms;
 }
 
@@ -1045,7 +1048,7 @@ async function installPlugin(nameWithVersion, args) {
 
   // Use cache as install source
   const installDir = getInstallDir();
-  const needsLocal = platforms.includes('opencode') || platforms.includes('codex') || platforms.includes('cursor');
+  const needsLocal = platforms.includes('opencode') || platforms.includes('codex') || platforms.includes('cursor') || platforms.includes('kiro');
   if (needsLocal && !fs.existsSync(path.join(installDir, 'lib'))) {
     // Need local install for transforms
     cleanOldInstallation(installDir);
@@ -1082,6 +1085,9 @@ async function installPlugin(nameWithVersion, args) {
   if (platforms.includes('cursor') && installDir) {
     installForCursor(installDir, { filter });
   }
+  if (platforms.includes('kiro') && installDir) {
+    installForKiro(installDir, { filter });
+  }
 
   // Record in installed.json
   for (const depName of toFetch) {
@@ -1693,6 +1699,158 @@ function installForCursor(installDir, options = {}) {
   return true;
 }
 
+function installForKiro(installDir, options = {}) {
+  console.log('\n[INSTALL] Installing for Kiro...\n');
+  const { filter = null } = options;
+  const cwd = process.cwd();
+
+  // Create target directories (all project-scoped)
+  const skillsDir = path.join(cwd, '.kiro', 'skills');
+  const steeringDir = path.join(cwd, '.kiro', 'steering');
+  const agentsDir = path.join(cwd, '.kiro', 'agents');
+  fs.mkdirSync(skillsDir, { recursive: true });
+  fs.mkdirSync(steeringDir, { recursive: true });
+  fs.mkdirSync(agentsDir, { recursive: true });
+
+  // Cleanup old agentsys steering files (only those matching known commands)
+  const steeringMappingsForCleanup = discovery.getKiroSteeringMappings(installDir);
+  const knownSteeringFiles = new Set(steeringMappingsForCleanup.map(([name]) => `${name}.md`));
+  for (const f of fs.readdirSync(steeringDir).filter(f => f.endsWith('.md'))) {
+    if (knownSteeringFiles.has(f)) {
+      fs.unlinkSync(path.join(steeringDir, f));
+    }
+  }
+
+  // Collect known skill names from discovery before cleanup
+  const pluginDirs = discovery.discoverPlugins(installDir);
+  const knownSkillNames = new Set();
+  for (const pluginName of pluginDirs) {
+    const srcSkillsDir = path.join(installDir, 'plugins', pluginName, 'skills');
+    if (!fs.existsSync(srcSkillsDir)) continue;
+    for (const d of fs.readdirSync(srcSkillsDir, { withFileTypes: true })) {
+      if (d.isDirectory() && /^[a-zA-Z0-9_-]+$/.test(d.name)) knownSkillNames.add(d.name);
+    }
+  }
+
+  // Cleanup old agentsys skill dirs (only known names, preserve user-created skills)
+  for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
+    if (entry.isDirectory() && knownSkillNames.has(entry.name)) {
+      fs.rmSync(path.join(skillsDir, entry.name), { recursive: true, force: true });
+    }
+  }
+
+  // Cleanup old agentsys agent JSON files (only those matching known agents)
+  const knownAgentFiles = new Set();
+  for (const pluginName of pluginDirs) {
+    const srcAgentsDir = path.join(installDir, 'plugins', pluginName, 'agents');
+    if (!fs.existsSync(srcAgentsDir)) continue;
+    for (const f of fs.readdirSync(srcAgentsDir).filter(f => f.endsWith('.md'))) {
+      knownAgentFiles.add(f.replace(/\.md$/, '.json'));
+    }
+  }
+  for (const f of fs.readdirSync(agentsDir).filter(f => f.endsWith('.json'))) {
+    if (knownAgentFiles.has(f)) {
+      fs.unlinkSync(path.join(agentsDir, f));
+    }
+  }
+
+  // Install skills
+  let skillCount = 0;
+  for (const pluginName of pluginDirs) {
+    const srcSkillsDir = path.join(installDir, 'plugins', pluginName, 'skills');
+    if (!fs.existsSync(srcSkillsDir)) continue;
+    const entries = fs.readdirSync(srcSkillsDir, { withFileTypes: true }).filter(d => d.isDirectory());
+    for (const entry of entries) {
+      if (!/^[a-zA-Z0-9_-]+$/.test(entry.name)) continue;
+      if (filter && filter.skills && filter.skills.length > 0 && !filter.skills.includes(entry.name)) continue;
+      const srcPath = path.join(srcSkillsDir, entry.name, 'SKILL.md');
+      if (!fs.existsSync(srcPath)) continue;
+      const destDir = path.join(skillsDir, entry.name);
+      fs.mkdirSync(destDir, { recursive: true });
+      let content = fs.readFileSync(srcPath, 'utf8');
+      content = transforms.transformSkillForKiro(content, {
+        pluginInstallPath: path.join(installDir, 'plugins', pluginName)
+      });
+      fs.writeFileSync(path.join(destDir, 'SKILL.md'), content);
+      skillCount++;
+    }
+  }
+
+  // Install commands as steering files
+  const steeringMappings = discovery.getKiroSteeringMappings(installDir);
+  let steeringCount = 0;
+  for (const [steeringName, plugin, sourceFile, description] of steeringMappings) {
+    if (filter && filter.commands && filter.commands.length > 0) {
+      if (!filter.commands.includes(steeringName)) continue;
+    }
+    const srcPath = path.join(installDir, 'plugins', plugin, 'commands', sourceFile);
+    if (!fs.existsSync(srcPath)) {
+      console.log(`  [WARN] Source file not found: ${srcPath}`);
+      continue;
+    }
+    let content = fs.readFileSync(srcPath, 'utf8');
+    content = transforms.transformCommandForKiro(content, {
+      pluginInstallPath: path.join(installDir, 'plugins', plugin),
+      name: steeringName,
+      description
+    });
+    fs.writeFileSync(path.join(steeringDir, `${steeringName}.md`), content);
+    steeringCount++;
+  }
+
+  // Install agents as JSON files
+  let agentCount = 0;
+  for (const pluginName of pluginDirs) {
+    const srcAgentsDir = path.join(installDir, 'plugins', pluginName, 'agents');
+    if (!fs.existsSync(srcAgentsDir)) continue;
+    const agentFiles = fs.readdirSync(srcAgentsDir).filter(f => f.endsWith('.md'));
+    for (const agentFile of agentFiles) {
+      const agentName = agentFile.replace(/\.md$/, '');
+      if (filter && filter.agents && filter.agents.length > 0 && !filter.agents.includes(agentName)) continue;
+      const srcPath = path.join(srcAgentsDir, agentFile);
+      let content = fs.readFileSync(srcPath, 'utf8');
+      const jsonContent = transforms.transformAgentForKiro(content, {
+        pluginInstallPath: path.join(installDir, 'plugins', pluginName)
+      });
+      fs.writeFileSync(path.join(agentsDir, `${agentName}.json`), jsonContent);
+      agentCount++;
+    }
+  }
+
+  // Generate combined reviewer agents for Kiro's 4-agent experimental limit.
+  // These are fallback agents that merge 2 review passes into 1 agent session.
+  const combinedReviewers = [
+    {
+      name: 'reviewer-quality-security',
+      description: 'Combined code quality and security reviewer for Kiro',
+      roles: [
+        { name: 'Code Quality', focus: 'Error handling, maintainability, naming, duplication, dead code, logging quality' },
+        { name: 'Security', focus: 'Auth vulnerabilities, input validation, injection risks, secrets exposure, OWASP top 10' },
+      ]
+    },
+    {
+      name: 'reviewer-perf-test',
+      description: 'Combined performance and test coverage reviewer for Kiro',
+      roles: [
+        { name: 'Performance', focus: 'Hot paths, algorithmic complexity, unnecessary allocations, N+1 queries, caching opportunities' },
+        { name: 'Test Coverage', focus: 'Missing tests, edge cases, assertion quality, test isolation, mock correctness' },
+      ]
+    },
+  ];
+  for (const cr of combinedReviewers) {
+    const json = transforms.generateCombinedReviewerAgent(cr.roles, cr.name, cr.description);
+    fs.writeFileSync(path.join(agentsDir, `${cr.name}.json`), json);
+    agentCount++;
+  }
+
+  console.log(`\n[OK] Kiro installation complete!`);
+  console.log(`   Skills: ${skillCount} installed to ${skillsDir}`);
+  console.log(`   Steering: ${steeringCount} installed to ${steeringDir}`);
+  console.log(`   Agents: ${agentCount} installed to ${agentsDir} (includes 2 combined reviewers)`);
+  console.log('   All content is project-scoped under .kiro/.\n');
+  return true;
+}
+
 function removeInstallation() {
   const installDir = getInstallDir();
 
@@ -1710,6 +1868,7 @@ function removeInstallation() {
   console.log('  - OpenCode: Remove files under ~/.config/opencode/ (commands/*.md, agents/*.md, skills/*/SKILL.md) and ~/.config/opencode/plugins/agentsys.ts');
   console.log('  - Codex: Remove ~/.codex/skills/*/');
   console.log('  - Cursor: Remove .cursor/skills/, .cursor/commands/, and .cursor/rules/agentsys-*.mdc from your project');
+  console.log('  - Kiro: Remove .kiro/skills/, .kiro/steering/, and .kiro/agents/ from your project');
 }
 
 function printSubcommandHelp(subcommand) {
@@ -1730,7 +1889,7 @@ Examples:
   agentsys install perf@1.2.0            Install perf at version 1.2.0
 
 Options:
-  --tool <name>     Install for a specific platform (claude, opencode, codex, cursor)
+  --tool <name>     Install for a specific platform (claude, opencode, codex, cursor, kiro)
   --tools <list>    Install for multiple platforms (comma-separated)
 
 Notes:
@@ -1824,7 +1983,7 @@ agentsys v${VERSION} - Workflow automation for AI coding assistants
 
 Usage:
   agentsys                    Interactive installer (select platforms)
-  agentsys --tool <name>      Install for single tool (claude, opencode, codex, cursor)
+  agentsys --tool <name>      Install for single tool (claude, opencode, codex, cursor, kiro)
   agentsys --tools <list>     Install for multiple tools (comma-separated)
   agentsys --only <plugins>   Install only specified plugins (comma-separated, resolves deps)
   agentsys --development      Development mode: install to ~/.claude/plugins
@@ -1851,7 +2010,7 @@ Non-Interactive Examples:
   agentsys --tool claude              # Install for Claude Code only
   agentsys --tool opencode            # Install for OpenCode only
   agentsys --tools "claude,opencode"  # Install for both
-  agentsys --tools claude,opencode,codex,cursor  # Install for all
+  agentsys --tools claude,opencode,codex,cursor,kiro  # Install for all
   agentsys --only next-task           # Install next-task + its dependencies
   agentsys --only "next-task,perf"    # Install specific plugins + deps
 
@@ -1871,7 +2030,8 @@ Supported Platforms:
   claude   - Claude Code (marketplace install or development mode)
   opencode - OpenCode (local commands + native plugin)
   codex    - Codex CLI (local skills)
-  cursor   - Cursor (project-scoped .mdc rules)
+  cursor   - Cursor (project-scoped skills + commands)
+  kiro     - Kiro (project-scoped steering + skills + agents)
 
 Install:  npm install -g agentsys && agentsys
 Update:   npm update -g agentsys && agentsys
@@ -1977,7 +2137,8 @@ async function main() {
       { value: 'claude', label: 'Claude Code' },
       { value: 'opencode', label: 'OpenCode' },
       { value: 'codex', label: 'Codex CLI' },
-      { value: 'cursor', label: 'Cursor' }
+      { value: 'cursor', label: 'Cursor' },
+      { value: 'kiro', label: 'Kiro' }
     ];
 
     selected = await multiSelect(
@@ -2007,7 +2168,7 @@ async function main() {
   }
 
   // Only copy to ~/.agentsys if OpenCode, Codex, or Cursor selected (they need local files)
-  const needsLocalInstall = selected.includes('opencode') || selected.includes('codex') || selected.includes('cursor');
+  const needsLocalInstall = selected.includes('opencode') || selected.includes('codex') || selected.includes('cursor') || selected.includes('kiro');
   let installDir = null;
 
   if (needsLocalInstall) {
@@ -2047,6 +2208,11 @@ async function main() {
           failedPlatforms.push('cursor');
         }
         break;
+      case 'kiro':
+        if (!installForKiro(installDir)) {
+          failedPlatforms.push('kiro');
+        }
+        break;
     }
   }
 
@@ -2100,5 +2266,6 @@ module.exports = {
   buildFilterFromComponent,
   resolvePluginSource,
   parseGitHubSource,
-  installForCursor
+  installForCursor,
+  installForKiro
 };

package/lib/adapter-transforms.js

@@ -429,6 +429,225 @@ function transformCommandForCursor(content, options) {
   return content;
 }
 
+/**
+ * Transform skill content for Kiro.
+ *
+ * Minimal transform - Kiro reads standard SKILL.md format natively so we
+ * preserve it. Only replaces PLUGIN_ROOT paths and strips namespace prefixes.
+ *
+ * @param {string} content - Source SKILL.md content
+ * @param {Object} options
+ * @param {string} options.pluginInstallPath - Absolute path to plugin install dir
+ * @returns {string} Transformed skill content
+ */
+function transformSkillForKiro(content, options) {
+  const { pluginInstallPath } = options;
+
+  content = content.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, () => pluginInstallPath);
+  content = content.replace(/\$CLAUDE_PLUGIN_ROOT/g, () => pluginInstallPath);
+  content = content.replace(/\$\{PLUGIN_ROOT\}/g, () => pluginInstallPath);
+  content = content.replace(/\$PLUGIN_ROOT/g, () => pluginInstallPath);
+
+  content = content.replace(/(?:next-task|deslop|ship|sync-docs|audit-project|enhance|perf|repo-map|drift-detect|consult|debate|learn|web-ctl):([a-z][a-z0-9-]*)/g, '$1');
+
+  return content;
+}
+
+/**
+ * Transform command content for Kiro steering files.
+ *
+ * Strips existing frontmatter, prepends inclusion: manual frontmatter,
+ * replaces PLUGIN_ROOT paths, removes require()/Task() calls, strips namespaces.
+ */
+function transformCommandForKiro(content, options) {
+  const { pluginInstallPath, name = '', description = '' } = options;
+
+  if (content.startsWith('---')) {
+    content = content.replace(/^---\n[\s\S]*?\n---\n?/, '');
+  }
+
+  const cleanDescription = description.replace(/[\x00-\x1f\x7f]/g, ' ');
+  const escapedDescription = cleanDescription.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+  let frontmatter = '---\n';
+  frontmatter += 'inclusion: manual\n';
+  if (name) frontmatter += `name: "${name}"\n`;
+  if (description) frontmatter += `description: "${escapedDescription}"\n`;
+  frontmatter += '---\n';
+
+  content = frontmatter + content;
+
+  content = content.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, () => pluginInstallPath);
+  content = content.replace(/\$CLAUDE_PLUGIN_ROOT/g, () => pluginInstallPath);
+  content = content.replace(/\$\{PLUGIN_ROOT\}/g, () => pluginInstallPath);
+  content = content.replace(/\$PLUGIN_ROOT/g, () => pluginInstallPath);
+
+  content = content.replace(/(?:const|let|var)\s+\{?[^}=\n]+\}?\s*=\s*require\s*\([^)]+\);?/g, '');
+  content = content.replace(/require\s*\(['"][^'"]+['"]\)/g, '');
+
+  // Transform code blocks containing Promise.all + Task() (parallel reviewer spawns).
+  // The bare Task() regex below can't reach inside fenced code blocks.
+  // Fence boundaries must be at line start (^```) to avoid matching backtick
+  // template literals inside the code as false fence endings.
+  content = content.replace(/^```(?:javascript|js)?\n([\s\S]*?)^```$/gm, (fullBlock, codeContent) => {
+    if (!codeContent.includes('Promise.all') || !codeContent.includes('Task(')) return fullBlock;
+    const taskMatches = [...codeContent.matchAll(/Task\s*\(\s*\{[\s\S]*?subagent_type:\s*['"](?:[^"':]+:)?([^'"]+)['"][\s\S]*?prompt:\s*`((?:[^`]|\$\{[^}]*\})*)`/gs)];
+    if (taskMatches.length < 2) return fullBlock;
+
+    const delegations = taskMatches.map(m => {
+      const agent = m[1];
+      const promptFirstLine = m[2].split('\n').find(l => l.trim()) || '';
+      return `Delegate to the \`${agent}\` subagent:\n> ${promptFirstLine.trim()}`;
+    });
+
+    let result = delegations.join('\n\n');
+
+    const hasReviewKeyword = delegations.some(d =>
+      /review|quality|security|performance|test|coverage/i.test(d)
+    );
+    if (delegations.length >= 4 && hasReviewKeyword) {
+      result = `**Review phase (Kiro - max 4 agents, fallback to 2 sequential):**\n\nTry delegating to these subagents (experimental parallel spawning):\n\n${result}\n\nIf parallel spawning is unavailable, run 2 combined reviewers sequentially:\n1. Delegate to the \`reviewer-quality-security\` subagent (code quality + security)\n2. Then delegate to the \`reviewer-perf-test\` subagent (performance + test coverage)\n\nAggregate all findings from whichever execution path succeeded.`;
+    }
+
+    return result;
+  });
+
+  // Transform bare Task() calls outside code blocks
+  content = content.replace(/await\s+Task\s*\(\s*\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}\s*\);?/g, (match) => {
+    const agentMatch = match.match(/subagent_type:\s*["'](?:[^"':]+:)?([^"']+)["']/);
+    const promptMatch = match.match(/prompt:\s*[`"']([\s\S]*?)[`"']/);
+    if (agentMatch) {
+      const agentName = agentMatch[1];
+      const prompt = promptMatch ? promptMatch[1].replace(/\\n/g, '\n').trim() : '';
+      if (prompt) {
+        return `Delegate to the \`${agentName}\` subagent:\n> ${prompt.split('\n')[0]}`;
+      }
+      return `Delegate to the \`${agentName}\` subagent.`;
+    }
+    return '';
+  });
+
+  // Transform AskUserQuestion to markdown prompt for Kiro chat
+  content = content.replace(/(?:await\s+)?AskUserQuestion\s*\(\s*\{[\s\S]*?\}\s*\);?/g, (match) => {
+    const questionMatch = match.match(/question:\s*["'`]([\s\S]*?)["'`]/);
+    const question = questionMatch ? questionMatch[1] : 'Please choose:';
+    const optionMatches = [...match.matchAll(/label:\s*["'`]([^"'`]+)["'`][\s\S]*?description:\s*["'`]([^"'`]+)["'`]/g)];
+    if (optionMatches.length > 0) {
+      const options = optionMatches.map((m, i) => `${i + 1}. **${m[1]}** - ${m[2]}`).join('\n');
+      return `**${question}**\n\n${options}\n\nReply with the number or name of your choice.`;
+    }
+    return `**${question}**\n\nReply in chat with your choice.`;
+  });
+
+  content = content.replace(/(?:next-task|deslop|ship|sync-docs|audit-project|enhance|perf|repo-map|drift-detect|consult|debate|learn|web-ctl):([a-z][a-z0-9-]*)/g, '$1');
+
+  // Batch parallel reviewer delegations for Kiro's agent limit.
+  // Detects 4+ consecutive "Delegate to" lines with review-related names
+  // and rewrites as try-4-then-fallback-to-2 pattern.
+  const reviewerBatchPattern = /((?:Delegate to the `[^`]*` subagent[^\n]*\n){4,})/g;
+  content = content.replace(reviewerBatchPattern, (block) => {
+    const delegations = block.match(/Delegate to the `([^`]+)` subagent/g) || [];
+    if (delegations.length < 4) return block;
+
+    const hasReviewKeyword = delegations.some(d =>
+      /review|quality|security|performance|test|coverage/i.test(d)
+    );
+    if (!hasReviewKeyword) return block;
+
+    return `**Review phase (Kiro - max 4 agents, fallback to 2 sequential):**
+
+Try delegating to these subagents (experimental parallel spawning):
+${block}
+If parallel spawning is unavailable, run 2 combined reviewers sequentially:
+1. Delegate to the \`reviewer-quality-security\` subagent (code quality + security)
+2. Then delegate to the \`reviewer-perf-test\` subagent (performance + test coverage)
+
+Aggregate all findings from whichever execution path succeeded.\n`;
+  });
+
+  return content;
+}
+
+/**
+ * Transform agent markdown+frontmatter to Kiro JSON format.
+ *
+ * Parses frontmatter for name/description/model/tools, uses body as prompt.
+ * Returns a JSON string matching Kiro's agent schema.
+ */
+function transformAgentForKiro(content, options) {
+  const { pluginInstallPath } = options || {};
+
+  const frontmatter = discovery.parseFrontmatter(content);
+  let body = content;
+  if (content.startsWith('---')) {
+    const endIdx = content.indexOf('\n---', 3);
+    if (endIdx !== -1) {
+      body = content.substring(endIdx + 4).replace(/^\n/, '');
+    }
+  }
+
+  if (pluginInstallPath) {
+    body = body.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, () => pluginInstallPath);
+    body = body.replace(/\$CLAUDE_PLUGIN_ROOT/g, () => pluginInstallPath);
+    body = body.replace(/\$\{PLUGIN_ROOT\}/g, () => pluginInstallPath);
+    body = body.replace(/\$PLUGIN_ROOT/g, () => pluginInstallPath);
+  }
+
+  body = body.replace(/(?:next-task|deslop|ship|sync-docs|audit-project|enhance|perf|repo-map|drift-detect|consult|debate|learn|web-ctl):([a-z][a-z0-9-]*)/g, '$1');
+
+  const agent = {
+    name: frontmatter.name || '',
+    description: frontmatter.description || '',
+    prompt: body.trim()
+  };
+
+  if (frontmatter.tools) {
+    // parseFrontmatter returns arrays for YAML list syntax, string for inline
+    const toolItems = Array.isArray(frontmatter.tools)
+      ? frontmatter.tools.map(t => t.toLowerCase())
+      : [frontmatter.tools.toLowerCase()];
+    const toolStr = toolItems.join(' ');
+    const tools = [];
+    if (toolStr.includes('read')) tools.push('read');
+    if (toolStr.includes('edit') || toolStr.includes('write')) tools.push('write');
+    if (toolStr.includes('bash') || toolStr.includes('shell')) tools.push('shell');
+    if (toolStr.includes('glob')) tools.push('read');
+    if (toolStr.includes('grep')) tools.push('read');
+    const deduped = [...new Set(tools)];
+    agent.tools = deduped.length > 0 ? deduped : ['read'];
+  } else {
+    agent.tools = ['read'];
+  }
+
+  agent.resources = ['file://.kiro/steering/**/*.md'];
+
+  return JSON.stringify(agent, null, 2);
+}
+
+/**
+ * Generate a combined reviewer agent JSON for Kiro's 4-agent limit.
+ * Merges multiple review responsibilities into a single agent.
+ *
+ * @param {Array<{name: string, focus: string}>} roles - Review passes to combine
+ * @param {string} name - Agent name
+ * @param {string} description - Agent description
+ * @returns {string} JSON string for .kiro/agents/*.json
+ */
+function generateCombinedReviewerAgent(roles, name, description) {
+  const sections = roles.map(r =>
+    `## ${r.name} Review\n\nFocus: ${r.focus}`
+  ).join('\n\n---\n\n');
+
+  const agent = {
+    name,
+    description,
+    prompt: `You are a combined code reviewer covering multiple review passes in a single session.\n\n${sections}\n\nFor each file you review, check ALL of the above review dimensions. Return findings as a JSON array with objects containing: pass (which review), file, line, severity (critical/high/medium/low), description, suggestion.`,
+    tools: ['read'],
+    resources: ['file://.kiro/steering/**/*.md'],
+  };
+
+  return JSON.stringify(agent, null, 2);
+}
+
 module.exports = {
   transformBodyForOpenCode,
   transformCommandFrontmatterForOpenCode,
@@ -438,5 +657,9 @@ module.exports = {
   transformRuleForCursor,
   transformSkillForCursor,
   transformCommandForCursor,
-  transformForCursor: transformRuleForCursor
+  transformForCursor: transformRuleForCursor,
+  transformSkillForKiro,
+  transformCommandForKiro,
+  transformAgentForKiro,
+  generateCombinedReviewerAgent
 };

package/lib/cross-platform/index.js

@@ -5,6 +5,8 @@
  * - Claude Code (Anthropic)
  * - OpenCode (multi-model)
  * - Codex CLI (OpenAI)
+ * - Cursor (AI-first editor)
+ * - Kiro (AWS agentic IDE)
  *
  * Based on research from official documentation:
  * - Anthropic Claude 4 Best Practices
@@ -45,7 +47,8 @@ const PLATFORMS = {
   CLAUDE_CODE: 'claude-code',
   OPENCODE: 'opencode',
   CODEX_CLI: 'codex-cli',
-  CURSOR: 'cursor'
+  CURSOR: 'cursor',
+  KIRO: 'kiro'
 };
 
 /**
@@ -56,7 +59,8 @@ const STATE_DIRS = {
   [PLATFORMS.CLAUDE_CODE]: '.claude',
   [PLATFORMS.OPENCODE]: '.opencode',
   [PLATFORMS.CODEX_CLI]: '.codex',
-  [PLATFORMS.CURSOR]: '.cursor'
+  [PLATFORMS.CURSOR]: '.cursor',
+  [PLATFORMS.KIRO]: '.kiro'
 };
 
 /**
@@ -79,6 +83,7 @@ function detectPlatform() {
   if (stateDir === '.opencode') return PLATFORMS.OPENCODE;
   if (stateDir === '.codex') return PLATFORMS.CODEX_CLI;
   if (stateDir === '.cursor') return PLATFORMS.CURSOR;
+  if (stateDir === '.kiro') return PLATFORMS.KIRO;
   return PLATFORMS.CLAUDE_CODE;
 }
 
@@ -487,7 +492,8 @@ const INSTRUCTION_FILES = {
   [PLATFORMS.CLAUDE_CODE]: ['CLAUDE.md', '.claude/CLAUDE.md'],
   [PLATFORMS.OPENCODE]: ['AGENTS.md', 'CLAUDE.md'],
   [PLATFORMS.CODEX_CLI]: ['AGENTS.md', 'AGENTS.override.md'],
-  [PLATFORMS.CURSOR]: ['.cursor/rules/*.mdc']
+  [PLATFORMS.CURSOR]: ['.cursor/rules/*.mdc'],
+  [PLATFORMS.KIRO]: ['AGENTS.md', '.kiro/steering/*.md']
 };
 
 /**

package/lib/discovery/index.js

@@ -361,6 +361,27 @@ function getCursorRuleMappings(repoRoot) {
   });
 }
 
+/**
+ * Build Kiro steering mappings from discovered commands.
+ * Returns [steeringName, pluginName, sourceFile, description] tuples.
+ * Uses kiro-description frontmatter field, falls back to cursor-description,
+ * codex-description, then description.
+ *
+ * @param {string} [repoRoot] - Repository root path
+ * @returns {Array<[string, string, string, string]>}
+ */
+function getKiroSteeringMappings(repoRoot) {
+  const commands = discoverCommands(repoRoot);
+  return commands.map(cmd => {
+    const description = cmd.frontmatter['kiro-description'] ||
+                        cmd.frontmatter['cursor-description'] ||
+                        cmd.frontmatter['codex-description'] ||
+                        cmd.frontmatter.description ||
+                        '';
+    return [cmd.name, cmd.plugin, cmd.file, description];
+  });
+}
+
 module.exports = {
   parseFrontmatter,
   isValidPluginName,
@@ -372,6 +393,7 @@ module.exports = {
   getCommandMappings,
   getCodexSkillMappings,
   getCursorRuleMappings,
+  getKiroSteeringMappings,
   getPluginPrefixRegex,
   invalidateCache
 };

package/lib/platform/state-dir.js

@@ -32,10 +32,12 @@ function isDirectory(targetPath) {
  * 1. AI_STATE_DIR env var (user override)
  * 2. OpenCode detection (OPENCODE_CONFIG env or .opencode/ exists)
  * 3. Codex detection (CODEX_HOME env or .codex/ exists)
- * 4. Default to .claude (Claude Code or unknown)
+ * 4. Kiro detection (.kiro/ exists)
+ * 5. Cursor detection (.cursor/ exists)
+ * 6. Default to .claude (Claude Code or unknown)
  *
  * @param {string} [basePath=process.cwd()] - Base path to check for project directories
- * @returns {string} State directory name (e.g., '.claude', '.opencode', '.codex')
+ * @returns {string} State directory name (e.g., '.claude', '.opencode', '.codex', '.kiro')
  */
 function getStateDir(basePath = process.cwd()) {
   // Check user override first
@@ -83,6 +85,17 @@ function getStateDir(basePath = process.cwd()) {
     // Ignore errors, continue detection
   }
 
+  // Kiro detection
+  try {
+    const kiroPath = path.join(basePath, '.kiro');
+    if (isDirectory(kiroPath)) {
+      _cachedStateDirs.set(cacheKey, '.kiro');
+      return '.kiro';
+    }
+  } catch {
+    // Ignore errors, continue detection
+  }
+
   // Default to Claude Code
   _cachedStateDirs.set(cacheKey, '.claude');
   return '.claude';
@@ -112,6 +125,7 @@ function getPlatformName(basePath = process.cwd()) {
   switch (stateDir) {
     case '.opencode': return 'opencode';
     case '.codex': return 'codex';
+    case '.kiro': return 'kiro';
     case '.claude': return 'claude';
     default: return 'unknown';
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsys",
-  "version": "5.2.1",
+  "version": "5.3.1",
   "description": "A modular runtime and orchestration system for AI agents - works with Claude Code, OpenCode, and Codex CLI",
   "main": "lib/platform/detect-platform.js",
   "type": "commonjs",