universal-dev-standards 4.1.0 → 5.0.0-beta.10

package/src/config/ai-agent-paths.js

@@ -17,9 +17,13 @@ import { homedir } from 'os';
  * - name: Display name for the AI agent
  * - skills: Paths for skills installation (project and user level)
  * - commands: Paths for slash commands (if supported)
+ * - agents: Paths for agent definitions (if supported)
+ * - workflows: Paths for workflow definitions (if supported)
  * - supportsMarketplace: Whether the agent supports a marketplace (Claude Code only)
  * - fallbackSkillsPath: Alternative path the agent can read skills from
  * - supportsSkills: Whether the agent supports SKILL.md format
+ * - supportsTask: Whether the agent supports Task tool for subagent execution
+ * - supportsAgents: Whether the agent supports AGENT.md format
  */
 export const AI_AGENT_PATHS = {
   'claude-code': {
@@ -28,13 +32,22 @@ export const AI_AGENT_PATHS = {
       project: '.claude/skills/',
       user: join(homedir(), '.claude', 'skills')
     },
-    commands: {
-      project: '.claude/commands/',
-      user: join(homedir(), '.claude', 'commands')
+    // v2.1.3+: Commands and Skills merged, unified to Skills
+    // See: "Merged slash commands and skills, simplifying the mental model with no change in behavior."
+    commands: null,
+    agents: {
+      project: '.claude/agents/',
+      user: join(homedir(), '.claude', 'agents')
+    },
+    workflows: {
+      project: '.claude/workflows/',
+      user: join(homedir(), '.claude', 'workflows')
     },
     supportsMarketplace: true,
     fallbackSkillsPath: null, // Native implementation
-    supportsSkills: true
+    supportsSkills: true,
+    supportsTask: true,
+    supportsAgents: true
   },
   'opencode': {
     name: 'OpenCode',
@@ -46,9 +59,19 @@ export const AI_AGENT_PATHS = {
       project: '.opencode/command/',
       user: join(homedir(), '.config', 'opencode', 'command')
     },
+    agents: {
+      project: '.opencode/agents/',
+      user: join(homedir(), '.config', 'opencode', 'agents')
+    },
+    workflows: {
+      project: '.opencode/workflows/',
+      user: join(homedir(), '.config', 'opencode', 'workflows')
+    },
     supportsMarketplace: false,
     fallbackSkillsPath: '.claude/skills/', // Can read Claude skills
-    supportsSkills: true
+    supportsSkills: true,
+    supportsTask: true,
+    supportsAgents: true
   },
   'cursor': {
     name: 'Cursor',
@@ -56,10 +79,20 @@ export const AI_AGENT_PATHS = {
       project: '.cursor/skills/',
       user: join(homedir(), '.cursor', 'skills')
     },
-    commands: null, // Rules only, no SKILL.md support yet
+    commands: {
+      project: '.cursor/commands/',
+      user: join(homedir(), '.cursor', 'commands')
+    },
+    agents: {
+      project: '.cursor/agents/',
+      user: join(homedir(), '.cursor', 'agents')
+    },
+    workflows: null, // Not supported
     supportsMarketplace: false,
     fallbackSkillsPath: '.claude/skills/',
-    supportsSkills: false // Uses .mdc rules format
+    supportsSkills: true, // SKILL.md support since v2.4 (Jan 22, 2026)
+    supportsTask: false, // No Task tool support
+    supportsAgents: true // Can load agents as inline context
   },
   'cline': {
     name: 'Cline',
@@ -68,9 +101,20 @@ export const AI_AGENT_PATHS = {
       user: join(homedir(), '.cline', 'skills')
     },
     commands: null, // Uses workflow files
+    agents: {
+      project: '.cline/agents/',
+      user: join(homedir(), '.cline', 'agents')
+    },
+    workflows: {
+      // Official path per docs.cline.bot/features/slash-commands/workflows
+      project: '.cline/workflows/',
+      user: join(homedir(), '.cline', 'workflows')
+    },
     supportsMarketplace: false,
     fallbackSkillsPath: '.claude/skills/',
-    supportsSkills: true
+    supportsSkills: true,
+    supportsTask: false,
+    supportsAgents: true
   },
   'roo-code': {
     name: 'Roo Code',
@@ -82,9 +126,19 @@ export const AI_AGENT_PATHS = {
       project: '.roo/commands/',
       user: join(homedir(), '.roo', 'commands')
     },
+    agents: {
+      project: '.roo/agents/',
+      user: join(homedir(), '.roo', 'agents')
+    },
+    workflows: {
+      project: '.roo/workflows/',
+      user: join(homedir(), '.roo', 'workflows')
+    },
     supportsMarketplace: false,
     fallbackSkillsPath: '.claude/skills/',
-    supportsSkills: true
+    supportsSkills: true,
+    supportsTask: true,
+    supportsAgents: true
   },
   'codex': {
     name: 'OpenAI Codex',
@@ -93,9 +147,16 @@ export const AI_AGENT_PATHS = {
       user: join(homedir(), '.codex', 'skills')
     },
     commands: null, // Uses system commands
+    agents: {
+      project: '.codex/agents/',
+      user: join(homedir(), '.codex', 'agents')
+    },
+    workflows: null,
     supportsMarketplace: false,
     fallbackSkillsPath: '.claude/skills/',
-    supportsSkills: true
+    supportsSkills: true,
+    supportsTask: false,
+    supportsAgents: true
   },
   'copilot': {
     name: 'GitHub Copilot',
@@ -105,11 +166,20 @@ export const AI_AGENT_PATHS = {
     },
     commands: {
       project: '.github/prompts/',
-      user: join(homedir(), '.copilot', 'prompts')
+      // Note: Custom prompts only work in VS Code IDE, not CLI or Cloud
+      // See: docs.github.com/copilot/get-started/getting-started-with-prompts-for-copilot-chat
+      user: null
     },
+    agents: {
+      project: '.github/agents/',
+      user: join(homedir(), '.copilot', 'agents')
+    },
+    workflows: null,
     supportsMarketplace: false,
     fallbackSkillsPath: '.claude/skills/', // Legacy support
-    supportsSkills: true
+    supportsSkills: true,
+    supportsTask: false,
+    supportsAgents: true
   },
   'windsurf': {
     name: 'Windsurf',
@@ -118,9 +188,20 @@ export const AI_AGENT_PATHS = {
       user: join(homedir(), '.codeium', 'windsurf', 'skills')
     },
     commands: null, // Uses rulebook
+    agents: {
+      project: '.windsurf/agents/',
+      user: join(homedir(), '.codeium', 'windsurf', 'agents')
+    },
+    workflows: {
+      // Official path per docs.windsurf.com/windsurf/cascade/workflows
+      project: '.windsurf/rules/',
+      user: join(homedir(), '.codeium', 'windsurf', 'rules')
+    },
     supportsMarketplace: false,
     fallbackSkillsPath: null,
-    supportsSkills: true
+    supportsSkills: true,
+    supportsTask: false,
+    supportsAgents: true
   },
   'gemini-cli': {
     name: 'Gemini CLI',
@@ -132,20 +213,37 @@ export const AI_AGENT_PATHS = {
       project: '.gemini/commands/',
       user: join(homedir(), '.gemini', 'commands')
     },
+    agents: {
+      project: '.gemini/agents/',
+      user: join(homedir(), '.gemini', 'agents')
+    },
+    workflows: {
+      project: '.gemini/workflows/',
+      user: join(homedir(), '.gemini', 'workflows')
+    },
+    // Gemini CLI uses TOML format for commands, not Markdown
+    // See: cloud.google.com/blog/topics/developers-practitioners/gemini-cli-custom-slash-commands
+    commandFormat: 'toml',
     supportsMarketplace: false,
     fallbackSkillsPath: '.claude/skills/',
-    supportsSkills: true // Preview support
+    supportsSkills: true, // Stable since v0.27.0 (Feb 2026)
+    supportsTask: false,
+    supportsAgents: true
   },
   'antigravity': {
     name: 'Google Antigravity',
     skills: {
-      project: '.antigravity/skills/',
-      user: join(homedir(), '.antigravity', 'skills')
+      project: '.agent/skills/',
+      user: join(homedir(), '.gemini', 'antigravity', 'skills')
     },
     commands: null,
+    agents: null,
+    workflows: null,
     supportsMarketplace: false,
     fallbackSkillsPath: null,
-    supportsSkills: false
+    supportsSkills: true, // Skills since Nov 2025
+    supportsTask: false,
+    supportsAgents: false
   }
 };
 
@@ -247,24 +345,190 @@ export function getAgentDisplayName(agent) {
 }
 
 /**
- * List of all available slash commands (from skills/claude-code/commands/)
+ * Get agents directory path for an AI tool
+ * @param {string} agent - Agent identifier
+ * @param {string} level - 'user' or 'project'
+ * @param {string} projectPath - Project root path (required for project level)
+ * @returns {string|null} Agents directory path or null if not supported
+ */
+export function getAgentsDirForAgent(agent, level = 'project', projectPath = null) {
+  const config = AI_AGENT_PATHS[agent];
+  if (!config || !config.agents) return null;
+
+  if (level === 'user') {
+    return config.agents.user || null;
+  } else if (level === 'project' && projectPath) {
+    return config.agents.project ? join(projectPath, config.agents.project) : null;
+  }
+  return null;
+}
+
+/**
+ * Get workflows directory path for an AI tool
+ * @param {string} agent - Agent identifier
+ * @param {string} level - 'user' or 'project'
+ * @param {string} projectPath - Project root path (required for project level)
+ * @returns {string|null} Workflows directory path or null if not supported
+ */
+export function getWorkflowsDirForAgent(agent, level = 'project', projectPath = null) {
+  const config = AI_AGENT_PATHS[agent];
+  if (!config || !config.workflows) return null;
+
+  if (level === 'user') {
+    return config.workflows.user || null;
+  } else if (level === 'project' && projectPath) {
+    return config.workflows.project ? join(projectPath, config.workflows.project) : null;
+  }
+  return null;
+}
+
+/**
+ * Get all agents that support AGENT.md format
+ * @returns {string[]} Array of agent identifiers
+ */
+export function getAgentsSupportedAgents() {
+  return Object.entries(AI_AGENT_PATHS)
+    .filter(([, config]) => config.supportsAgents && config.agents)
+    .map(([agent]) => agent);
+}
+
+/**
+ * Get all agents that support Task tool (subagent execution)
+ * @returns {string[]} Array of agent identifiers
+ */
+export function getTaskSupportedAgents() {
+  return Object.entries(AI_AGENT_PATHS)
+    .filter(([, config]) => config.supportsTask)
+    .map(([agent]) => agent);
+}
+
+/**
+ * Get all agents that support workflow definitions
+ * @returns {string[]} Array of agent identifiers
+ */
+export function getWorkflowsSupportedAgents() {
+  return Object.entries(AI_AGENT_PATHS)
+    .filter(([, config]) => config.workflows !== null)
+    .map(([agent]) => agent);
+}
+
+/**
+ * Check if an agent supports Task tool (subagent execution)
+ * @param {string} agent - Agent identifier
+ * @returns {boolean} True if Task tool is supported
+ */
+export function supportsTask(agent) {
+  const config = AI_AGENT_PATHS[agent];
+  return config?.supportsTask || false;
+}
+
+/**
+ * Check if an agent supports AGENT.md format
+ * @param {string} agent - Agent identifier
+ * @returns {boolean} True if agents are supported
+ */
+export function supportsAgents(agent) {
+  const config = AI_AGENT_PATHS[agent];
+  return config?.supportsAgents || false;
+}
+
+/**
+ * List of all available slash commands (from skills/)
+ * Note: Since Claude Code v2.1.3+, Skills and Commands are merged.
+ * The `name` field in SKILL.md directly becomes the slash command.
+ *
+ * This list includes:
+ * - 16 commands from Action Skills (SKILL.md files with `name` field)
+ * - 12 commands from Commands-only files (no corresponding Skill)
+ * Total: 28 available commands
+ *
+ * Reference-only Skills (no `name` field, not slash commands):
+ * testing-guide, project-structure-guide, git-workflow-guide,
+ * error-code-guide, logging-guide, ai-collaboration-standards,
+ * ai-friendly-architecture, ai-instruction-standards, documentation-guide
  */
 export const AVAILABLE_COMMANDS = [
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Core Development Workflow (Action Skills)
+  // ═══════════════════════════════════════════════════════════════════════════
   { name: 'commit', description: 'Generate commit messages following Conventional Commits' },
   { name: 'review', description: 'Perform code review with checklist' },
-  { name: 'tdd', description: 'Guide TDD workflow (Red-Green-Refactor)' },
-  { name: 'bdd', description: 'Guide BDD workflow' },
-  { name: 'coverage', description: 'Analyze test coverage' },
-  { name: 'requirement', description: 'Write requirements following INVEST' },
-  { name: 'check', description: 'Check-in verification' },
+  { name: 'checkin', description: 'Pre-commit quality gates verification' },
   { name: 'release', description: 'Guide release process' },
   { name: 'changelog', description: 'Generate changelog entries' },
-  { name: 'docs', description: 'Generate documentation' },
-  { name: 'spec', description: 'Spec-driven development guide' },
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Testing Methodologies (Action Skills)
+  // ═══════════════════════════════════════════════════════════════════════════
+  { name: 'tdd', description: 'Guide TDD workflow (Red-Green-Refactor)' },
+  { name: 'bdd', description: 'Guide BDD workflow (Gherkin, Given-When-Then)' },
+  { name: 'atdd', description: 'Guide ATDD workflow (acceptance criteria)' },
+  { name: 'coverage', description: 'Analyze test coverage (8 dimensions)' },
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Specification and Requirements (Action Skills)
+  // ═══════════════════════════════════════════════════════════════════════════
+  { name: 'sdd', description: 'Spec-driven development guide' },
+  { name: 'requirement', description: 'Write requirements following INVEST' },
+  { name: 'derive', description: 'Forward derivation (spec to BDD/TDD)' },
+  { name: 'reverse', description: 'Reverse engineer code to SDD specs' },
+  { name: 'discover', description: 'Assess project health and risks before adding features' },
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Derivation Commands (Commands-only, specific transformations)
+  // ═══════════════════════════════════════════════════════════════════════════
+  { name: 'derive-bdd', description: 'Derive BDD Gherkin scenarios from SDD specification' },
+  { name: 'derive-tdd', description: 'Derive TDD test skeletons from SDD specification' },
+  { name: 'derive-atdd', description: 'Derive ATDD acceptance tests from SDD specification' },
+  { name: 'derive-all', description: 'Derive all test structures (BDD, TDD, ATDD) from spec' },
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Reverse Engineering Commands (Commands-only, specific transformations)
+  // ═══════════════════════════════════════════════════════════════════════════
+  { name: 'reverse-sdd', description: 'Reverse engineer code into SDD specification document' },
+  { name: 'reverse-bdd', description: 'Transform SDD acceptance criteria to BDD scenarios' },
+  { name: 'reverse-tdd', description: 'Analyze BDD-TDD coverage gaps' },
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Documentation and Code Quality (Action Skills + Commands-only)
+  // ═══════════════════════════════════════════════════════════════════════════
+  { name: 'docs', description: 'Manage, guide, and generate documentation' },
+  { name: 'docgen', description: 'Generate usage documentation' },
+  { name: 'guide', description: 'Access UDS guides and references' },
+  { name: 'refactor', description: 'Refactoring and legacy modernization guide' },
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Development Methodology (Action Skills)
+  // ═══════════════════════════════════════════════════════════════════════════
   { name: 'methodology', description: 'Development methodology selection' },
-  { name: 'config', description: 'Project structure configuration' },
-  { name: 'init', description: 'Initialize standards' },
-  { name: 'update', description: 'Update standards' }
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // CLI Management (Commands-only, UDS CLI specific)
+  // ═══════════════════════════════════════════════════════════════════════════
+  { name: 'init', description: 'Initialize UDS standards in project' },
+  { name: 'update', description: 'Update standards to latest version' },
+  { name: 'check', description: 'Verify standards adoption status' },
+  { name: 'config', description: 'Configure project standards settings' }
+];
+
+/**
+ * List of all available agents (from skills/agents/)
+ */
+export const AVAILABLE_AGENTS = [
+  { name: 'code-architect', description: 'Software architecture and system design specialist' },
+  { name: 'test-specialist', description: 'Testing strategy and test implementation expert' },
+  { name: 'reviewer', description: 'Code review and quality assessment specialist' },
+  { name: 'doc-writer', description: 'Documentation and technical writing specialist' },
+  { name: 'spec-analyst', description: 'Specification analysis and requirement extraction expert' }
+];
+
+/**
+ * List of all available workflows (from skills/workflows/)
+ */
+export const AVAILABLE_WORKFLOWS = [
+  { name: 'integrated-flow', description: 'Complete ATDD → SDD → BDD → TDD workflow' },
+  { name: 'feature-dev', description: 'Feature development workflow' },
+  { name: 'code-review', description: 'Code review workflow' }
 ];
 
 export default AI_AGENT_PATHS;