agentic-code 0.6.3 → 0.6.5

package/.agents/tasks/technical-design.md

@@ -101,6 +101,7 @@ Create ADR and Design Documents.
 □ Testing strategy outlined
 □ Acceptance criteria defined and verifiable
 □ References cited
+□ Complexity assessment completed (if medium/high, rationale justifies necessity)
 
 ## Mandatory Process Before Document Creation [STRICT COMPLIANCE]
 
@@ -263,6 +264,8 @@ Option [X] selected. Rationale: [2-3 sentences with trade-offs]
 ```yaml
 design_type: "new_feature|extension|refactoring"
 risk_level: "low|medium|high"
+complexity_level: "low|medium|high"
+complexity_rationale: "[Required if medium/high: which requirements necessitate this complexity]"
 main_constraints:
   - "[constraint 1]"
   - "[constraint 2]"

package/.agents/tasks/technical-document-review.md

@@ -168,6 +168,7 @@ When sources exist:
 - Content quality issues exist
 - Failure scenarios partially covered
 - Medium severity issues present
+- Complexity level is medium/high but rationale does not justify necessity (Design Docs)
 
 **blocked**:
 - Critical sections missing

package/README.md

@@ -4,7 +4,7 @@ Your AI (LLM), guided by built-in workflows. Describe what you want, and it foll
 
 [![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![AGENTS.md](https://img.shields.io/badge/AGENTS.md-compliant-blue.svg)](https://agents.md)
-[![Version](https://img.shields.io/badge/version-0.6.2-blue.svg)](package.json)
+[![Version](https://img.shields.io/badge/version-0.6.4-blue.svg)](package.json)
 
 ![Demo: Building a Slack bot with Agentic Code](.github/assets/demo.gif)
 
@@ -114,15 +114,15 @@ cp -r path/to/agentic-code/.agents .
 
 ```bash
 # User scope (all projects)
-npx agentic-code-install-skills --codex
+npx agentic-code skills --codex
 # Installs to ~/.codex/skills/agentic-code/
 
 # Project scope (current project only)
-npx agentic-code-install-skills --codex --project
+npx agentic-code skills --codex --project
 # Installs to ./.codex/skills/agentic-code/
 
 # Custom path
-npx agentic-code-install-skills --path ./custom/skills
+npx agentic-code skills --path ./custom/skills
 # Installs to ./custom/skills/agentic-code/
 ```
 

package/bin/cli.js

@@ -6,6 +6,15 @@ const { execSync } = require('child_process');
 
 // Parse command line arguments
 const args = process.argv.slice(2);
+
+// Subcommand routing
+if (args[0] === 'skills') {
+  // Delegate to install-codex-skills
+  const installSkills = require('./install-codex-skills');
+  installSkills.run(args.slice(1));
+  process.exit(0);
+}
+
 const projectName = args[0];
 
 // Show help if no project name provided
@@ -14,12 +23,15 @@ if (!projectName) {
 🤖 Agentic Code - Task-oriented context engineering framework
 
 Usage:
-  npx github:shinpr/agentic-code <project-name>
+  npx agentic-code <project-name>       Create a new project
+  npx agentic-code skills [options]     Install skills to Codex CLI
 
 Examples:
-  npx github:shinpr/agentic-code my-project
+  npx agentic-code my-project
+  npx agentic-code skills --codex
+  npx agentic-code skills --codex --project
 
-Skills include language-specific references (e.g., .agents/skills/coding-rules/references/typescript.md)
+For skills options, run: npx agentic-code skills --help
 `);
   process.exit(1);
 }

package/bin/install-codex-skills.js

@@ -4,28 +4,12 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-// Parse command line arguments
-const args = process.argv.slice(2);
-
 // Scope types
 const SCOPES = {
   user: 'user',
   project: 'project'
 };
 
-// Get target directory based on target and scope
-function getTargetDir(targetKey, scope) {
-  if (targetKey === 'codex') {
-    if (scope === SCOPES.project) {
-      return path.join(process.cwd(), '.codex', 'skills');
-    }
-    // User scope: respect CODEX_HOME environment variable
-    const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
-    return path.join(codexHome, 'skills');
-  }
-  return null;
-}
-
 // Target configurations
 const TARGETS = {
   codex: {
@@ -36,76 +20,17 @@ const TARGETS = {
   // Future targets can be added here
 };
 
-// Show help
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(`
-Usage: agentic-code-install-skills [options]
-
-Options:
-  --codex         Install skills to Codex CLI (default)
-  --project       Install to project scope instead of user scope
-  --path <path>   Install to custom path
-  --help          Show this help message
-
-Scopes:
-  user (default)  Install to user directory (~/.codex/skills/ or $CODEX_HOME/skills/)
-  project         Install to current project (./.codex/skills/)
-
-Examples:
-  agentic-code-install-skills                    # Install to ~/.codex/skills/ (user scope)
-  agentic-code-install-skills --codex            # Same as above (explicit)
-  agentic-code-install-skills --codex --project  # Install to ./.codex/skills/ (project scope)
-  agentic-code-install-skills --path ./my-skills # Install to ./my-skills/agentic-code
-`);
-  process.exit(0);
-}
-
-// Parse --path option
-function getCustomPath() {
-  const pathIndex = args.indexOf('--path');
-  if (pathIndex === -1) return null;
-
-  const customPath = args[pathIndex + 1];
-  if (!customPath || customPath.startsWith('-')) {
-    console.error('Error: --path requires a path argument');
-    process.exit(1);
-  }
-  return path.resolve(customPath);
-}
-
-const customPath = getCustomPath();
-
-// Determine target (default: codex)
-let targetKey = customPath ? 'custom' : 'codex';
-if (args.includes('--codex')) {
-  targetKey = customPath ? 'custom' : 'codex';
-}
-
-// Determine scope (default: user)
-const scope = args.includes('--project') ? SCOPES.project : SCOPES.user;
-
-// Get skills directory
-let skillsDir;
-let target;
-
-if (customPath) {
-  skillsDir = customPath;
-  target = {
-    name: 'agentic-code',
-    description: 'custom path',
-    postInstall: null
-  };
-} else {
-  target = TARGETS[targetKey];
-  if (!target) {
-    console.error(`Error: Unknown target '${targetKey}'`);
-    process.exit(1);
-  }
-  skillsDir = getTargetDir(targetKey, scope);
-  if (!skillsDir) {
-    console.error(`Error: Cannot determine target directory for '${targetKey}'`);
-    process.exit(1);
+// Get target directory based on target and scope
+function getTargetDir(targetKey, scope) {
+  if (targetKey === 'codex') {
+    if (scope === SCOPES.project) {
+      return path.join(process.cwd(), '.codex', 'skills');
+    }
+    // User scope: respect CODEX_HOME environment variable
+    const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+    return path.join(codexHome, 'skills');
   }
+  return null;
 }
 
 // Get source directory (from installed package or local)
@@ -142,8 +67,82 @@ function copyDirectory(src, dest) {
   }
 }
 
-// Main
-function main() {
+// Parse --path option
+function getCustomPath(args) {
+  const pathIndex = args.indexOf('--path');
+  if (pathIndex === -1) return null;
+
+  const customPath = args[pathIndex + 1];
+  if (!customPath || customPath.startsWith('-')) {
+    console.error('Error: --path requires a path argument');
+    process.exit(1);
+  }
+  return path.resolve(customPath);
+}
+
+// Main run function
+function run(cliArgs) {
+  const args = cliArgs || process.argv.slice(2);
+
+  // Show help
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log(`
+Usage: npx agentic-code skills [options]
+
+Options:
+  --codex         Install skills to Codex CLI (default)
+  --project       Install to project scope instead of user scope
+  --path <path>   Install to custom path
+  --help          Show this help message
+
+Scopes:
+  user (default)  Install to user directory (~/.codex/skills/ or $CODEX_HOME/skills/)
+  project         Install to current project (./.codex/skills/)
+
+Examples:
+  npx agentic-code skills                    # Install to ~/.codex/skills/ (user scope)
+  npx agentic-code skills --codex            # Same as above (explicit)
+  npx agentic-code skills --codex --project  # Install to ./.codex/skills/ (project scope)
+  npx agentic-code skills --path ./my-skills # Install to ./my-skills/agentic-code
+`);
+    process.exit(0);
+  }
+
+  const customPath = getCustomPath(args);
+
+  // Determine target (default: codex)
+  let targetKey = customPath ? 'custom' : 'codex';
+  if (args.includes('--codex')) {
+    targetKey = customPath ? 'custom' : 'codex';
+  }
+
+  // Determine scope (default: user)
+  const scope = args.includes('--project') ? SCOPES.project : SCOPES.user;
+
+  // Get skills directory
+  let skillsDir;
+  let target;
+
+  if (customPath) {
+    skillsDir = customPath;
+    target = {
+      name: 'agentic-code',
+      description: 'custom path',
+      postInstall: null
+    };
+  } else {
+    target = TARGETS[targetKey];
+    if (!target) {
+      console.error(`Error: Unknown target '${targetKey}'`);
+      process.exit(1);
+    }
+    skillsDir = getTargetDir(targetKey, scope);
+    if (!skillsDir) {
+      console.error(`Error: Cannot determine target directory for '${targetKey}'`);
+      process.exit(1);
+    }
+  }
+
   const sourceDir = getSourceSkillsDir();
 
   if (!sourceDir) {
@@ -187,4 +186,10 @@ function main() {
   }
 }
 
-main();
+// Export for module usage
+module.exports = { run };
+
+// Run if called directly
+if (require.main === module) {
+  run();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-code",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Task-oriented context engineering framework for LLM coding agents - AGENTS.md standard compliant",
   "files": [
     "bin/",
@@ -8,8 +8,7 @@
     "AGENTS.md"
   ],
   "bin": {
-    "agentic-code": "./bin/cli.js",
-    "agentic-code-install-skills": "./bin/install-codex-skills.js"
+    "agentic-code": "./bin/cli.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"