@tdsoft-tech/aikit 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.1.15] - 2026-01-01
+
+### Breaking Changes ⚠️
+- 🏷️ **Command & Skill Prefix Separation** - All OpenCode commands now use prefixes to distinguish type:
+  - Commands: `/ak_cm_<name>` (e.g., `/ak_cm_plan`, `/ak_cm_implement`, `/ak_cm_fix`)
+  - Skills: `/ak_sk_<name>` (e.g., `/ak_sk_test-driven-development`, `/ak_sk_code-review`)
+  - Old simple names (e.g., `/plan`, `/test-driven-development`) are **no longer supported**
+  - Users must press `/` in OpenCode to see new prefixed commands
+  - All documentation updated with new command names
+
+### Added
+- Clear visual distinction between commands and skills in OpenCode command picker
+- New naming convention: `ak_cm_*` for commands, `ak_sk_*` for skills
+- Updated all 28 commands and 23 skills with new prefixes
+
+### Migration Guide
+1. Run `aikit install` to generate new prefixed commands
+2. Press `/` in OpenCode to see new command structure
+3. Use `/ak_cm_` prefix for all slash commands
+4. Use `/ak_sk_` prefix for direct skill invocation
+
 ## [0.1.12] - 2024-12-28
 
 ### Added

package/dist/cli.js

@@ -2360,6 +2360,9 @@ var DEFAULT_COMMANDS = [
     content: `Create a new task in the Beads system (.beads/ directory).
 
 ## Workflow
+
+Task description: $ARGUMENTS
+
 1. Create a new bead file with unique ID
 2. Add task description, status, and notes
 3. Set status to "in-progress"
@@ -2379,6 +2382,9 @@ var DEFAULT_COMMANDS = [
     content: `Create a comprehensive plan before implementation.
 
 ## Workflow
+
+Feature or task to plan: $ARGUMENTS
+
 1. UNDERSTAND: Clarify requirements through Socratic questioning
 2. RESEARCH: Check existing patterns and dependencies
 3. BREAK DOWN: Create 2-5 minute sub-tasks with:
@@ -2418,6 +2424,9 @@ Brief description of the goal.
     content: `Implement a task following TDD principles.
 
 ## Workflow
+
+Task reference or description: $ARGUMENTS
+
 1. LOAD: Get task details from .beads/ or plan
 2. TEST: Write failing tests first (RED)
 3. IMPLEMENT: Write minimal code to pass (GREEN)
@@ -2515,6 +2524,8 @@ Before marking complete:
 
 ## Workflow
 
+Task description: $ARGUMENTS
+
 **Phase 1: Requirements Gathering**
 - Interactive selection of task type (Feature, Bug Fix, Refactoring, etc.)
 - Scope clarification
@@ -2602,7 +2613,10 @@ Before marking complete:
     content: `Quick fix with minimal ceremony.
 
 ## Workflow
-1. Identify the issue
+
+Issue description: $ARGUMENTS
+
+1. Identify issue
 2. Make minimal change to fix
 3. Verify fix works
 4. Run affected tests`
@@ -2616,6 +2630,9 @@ Before marking complete:
     content: `Fix TypeScript type errors systematically.
 
 ## Workflow
+
+Optional file argument: $ARGUMENTS
+
 1. Run \`npm run typecheck\`
 2. Parse error output
 3. Fix each error in dependency order
@@ -2648,6 +2665,9 @@ Before marking complete:
     content: `Create a conventional commit.
 
 ## Workflow
+
+Optional commit message: $ARGUMENTS
+
 1. Stage changes: \`git add -A\`
 2. Generate commit message following conventional commits:
    - feat: New feature
@@ -2667,6 +2687,9 @@ Before marking complete:
     content: `Create a pull request with proper description.
 
 ## Workflow
+
+Optional PR title: $ARGUMENTS
+
 1. Push current branch
 2. Generate PR description:
    - Summary of changes
@@ -2685,6 +2708,9 @@ Before marking complete:
     content: `Conduct thorough research and document findings.
 
 ## Workflow
+
+Research topic: $ARGUMENTS
+
 1. Search documentation and resources
 2. Find code examples and patterns
 3. Evaluate options and trade-offs
@@ -2722,6 +2748,9 @@ Before marking complete:
     content: `Review codebase for quality issues.
 
 ## Workflow
+
+Optional path: $ARGUMENTS
+
 1. Check code quality metrics
 2. Identify:
    - Code smells
@@ -2741,6 +2770,9 @@ Before marking complete:
     content: `Design a feature with thorough planning.
 
 ## Workflow
+
+Feature to design: $ARGUMENTS
+
 1. Requirements gathering (Socratic questioning)
 2. Research existing solutions
 3. Design options with trade-offs
@@ -2762,7 +2794,10 @@ Before marking complete:
     content: `Collaborative brainstorming session.
 
 ## Workflow
-1. Define the problem clearly
+
+Problem to brainstorm: $ARGUMENTS
+
+1. Define problem clearly
 2. Generate diverse ideas (no judgement)
 3. Group related ideas
 4. Evaluate feasibility
@@ -2778,6 +2813,9 @@ Before marking complete:
     content: `Create and switch to a new branch.
 
 ## Workflow
+
+Branch name: $ARGUMENTS
+
 1. Ensure clean working directory
 2. Pull latest main/master
 3. Create branch with naming convention:
@@ -2796,6 +2834,9 @@ Before marking complete:
     content: `Merge current branch to target.
 
 ## Workflow
+
+Optional target branch: $ARGUMENTS
+
 1. Run quality gates first
 2. Commit any pending changes
 3. Switch to target branch
@@ -2986,6 +3027,9 @@ The analysis will be saved automatically for later reference.`
     content: `Refactor code following best practices.
 
 ## Workflow
+
+Optional file or pattern: $ARGUMENTS
+
 1. Ensure tests are in place
 2. Identify refactoring opportunities
 3. Apply refactoring incrementally
@@ -3001,6 +3045,9 @@ The analysis will be saved automatically for later reference.`
     content: `Run test suite and display results.
 
 ## Workflow
+
+Optional pattern: $ARGUMENTS
+
 1. Run test command: \`npm run test\`
 2. Parse and display results
 3. Show coverage if available
@@ -3016,6 +3063,9 @@ The analysis will be saved automatically for later reference.`
     content: `Run linter and optionally fix issues.
 
 ## Workflow
+
+Optional flags: $ARGUMENTS
+
 1. Run linter: \`npm run lint\`
 2. Parse errors and warnings
 3. If --fix flag, run auto-fix
@@ -3031,6 +3081,9 @@ The analysis will be saved automatically for later reference.`
     content: `Deploy application with quality checks.
 
 ## Workflow
+
+Optional environment: $ARGUMENTS
+
 1. Run quality gates (test, lint, build)
 2. Check for uncommitted changes
 3. Build production bundle
@@ -3046,6 +3099,9 @@ The analysis will be saved automatically for later reference.`
     content: `Rollback to previous version.
 
 ## Workflow
+
+Optional version: $ARGUMENTS
+
 1. Identify current version
 2. List available versions
 3. Confirm rollback target
@@ -3061,6 +3117,9 @@ The analysis will be saved automatically for later reference.`
     content: `View and filter application logs.
 
 ## Workflow
+
+Optional flags: $ARGUMENTS
+
 1. Determine log location
 2. Apply filters if specified
 3. Display logs
@@ -3165,8 +3224,13 @@ Describe what this command does.
   /**
    * Format command for agent consumption
    */
-  formatForAgent(command) {
-    return `# Command: /${command.name}
+  formatForAgent(command, args) {
+    let content = command.content;
+    if (args && args.trim()) {
+      const argParts = args.trim().split(/\s+/);
+      content = content.replace(/\$ARGUMENTS/g, args.trim()).replace(/\$1/g, argParts[0] || "").replace(/\$2/g, argParts[1] || "").replace(/\$3/g, argParts[2] || "").replace(/\$4/g, argParts[3] || "").replace(/\$5/g, argParts[4] || "");
+    }
+    let output = `# Command: /${command.name}
 
 ## Usage
 \`${command.usage}\`
@@ -3178,8 +3242,14 @@ ${command.description}
 ${command.examples.map((e) => `- \`${e}\``).join("\n")}
 
 ## Workflow
-${command.content}
+${content}
+`;
+    if (args && args.trim()) {
+      output += `
+User arguments are : ${args.trim()}
 `;
+    }
+    return output;
   }
   /**
    * Load commands from directory (recursively)
@@ -5083,8 +5153,8 @@ async function installToOpenCode(_opencodePath) {
   const skills = await skillEngine.listSkills();
   const commands = await commandRunner.listCommands();
   const opencodeCommands = {};
-  const skillsList = skills.map((s) => `| \`/${s.name.replace(/\s+/g, "-")}\` | ${s.description} |`).join("\n");
-  opencodeCommands["skills"] = `List all available AIKit skills and how to use them.
+  const skillsList = skills.map((s) => `| \`/ak_sk_${s.name.replace(/\s+/g, "-")}\` | ${s.description} |`).join("\n");
+  opencodeCommands["ak_cm_skills"] = `List all available AIKit skills and how to use them.
 
 READ .aikit/AGENTS.md
 
@@ -5094,9 +5164,9 @@ READ .aikit/AGENTS.md
 |---------|-------------|
 ${skillsList}
 
-Type any command to use that skill. For example: \`/test-driven-development\` or \`/tdd\`.`;
+Type any command to use that skill. For example: \`/ak_sk_test-driven-development\``;
   for (const skill of skills) {
-    const commandName = skill.name.replace(/\s+/g, "-").toLowerCase();
+    const commandName = `ak_sk_${skill.name.replace(/\s+/g, "-").toLowerCase()}`;
     const skillPath = skill.filePath;
     const relativePath = skillPath.startsWith(projectPath) ? skillPath.replace(projectPath, "").replace(/\\/g, "/").replace(/^\//, "") : `.aikit/skills/${skill.name.replace(/\s+/g, "-").toLowerCase()}.md`;
     const useWhen = skill.useWhen || `The user asks you to ${skill.name}`;
@@ -5118,22 +5188,46 @@ Complete the checklist at the end of the skill.`;
   }
   for (const cmd of commands) {
     if (opencodeCommands[cmd.name]) continue;
-    const commandName = cmd.name.replace(/\//g, "").replace(/\s+/g, "-");
-    const examples = cmd.examples.map((e) => `- \`${e}\``).join("\n");
+    const commandName = `ak_cm_${cmd.name.replace(/\//g, "").replace(/\s+/g, "-")}`;
+    const examples = cmd.examples.map((e) => {
+      const prefixed = e.replace(/\//g, "/ak_cm_");
+      return `- \`${prefixed}\``;
+    }).join("\n");
     if (cmd.name === "analyze-figma") {
       opencodeCommands[commandName] = generateAnalyzeFigmaCommand();
     } else {
-      opencodeCommands[commandName] = `# Command: /${cmd.name}
+      opencodeCommands[commandName] = `# Command: /ak_cm_${cmd.name}
 
 ## Description
 ${cmd.description}
 
 ## Usage
-\`${cmd.usage}\`
+\`${cmd.usage.replace(/\//g, "/ak_cm_")}\`
 
 ## Examples
 ${examples}
 
+## \u26A0\uFE0F CRITICAL: The User Has Already Provided Arguments!
+
+**The user has provided arguments with this command!**
+
+The arguments are available in this command response - look at the command workflow below, which now includes explicit instructions to use the provided arguments.
+
+**YOUR JOB**:
+1. Follow the command workflow steps
+2. The workflow will tell you to look at "Arguments Provided" section
+3. Use those arguments - do NOT ask the user for this information!
+4. They have already provided it - extract and use it!
+
+**Example Scenario**:
+- User runs: \`/ak_cm_${cmd.name} snake game with html & css\`
+- Command: \`/ak_cm_${cmd.name}\`
+- Arguments to use: \`snake game with html & css\`
+- You must use "snake game with html & css" as provided in the workflow!
+
+**DO NOT**: Ask "Please provide a task description"
+**DO**: Follow the workflow and use the arguments provided in it!
+
 ## Workflow
 ${cmd.content}
 
@@ -5152,8 +5246,8 @@ Created ${count} OpenCode commands in .opencode/command/`);
   await configureMcpServer(projectPath);
   logger.info("\nUsage in OpenCode:");
   logger.info("  Press Ctrl+K to open command picker");
-  logger.info("  Or type /skills to see all available skills");
-  logger.info(`  Available: ${skills.length} skills, ${commands.length} commands`);
+  logger.info("  Or type /ak_cm_skills to see all available skills");
+  logger.info(`  Available: ${skills.length} skills (ak_sk_*), ${commands.length} commands (ak_cm_*)`);
   logger.info("  MCP server configured - tools available via MCP protocol");
 }
 function groupBy(array, keyFn) {