cortex-kit 1.0.0 → 1.1.0

package/README.md

@@ -34,6 +34,17 @@ cd my-awesome-project
 npx cortex-kit init .
 ```
 
+### Enable AI features in an existing project
+```bash
+cd your-existing-project
+npx cortex-kit enable
+```
+
+The `enable` command is perfect for adding AI context to existing projects:
+- Skips `AGENTS.md` if it already exists
+- Appends AI setup section to existing `README.md` (or creates new one)
+- Always creates `CLAUDE.md` and `docs/` directory
+
 ## What Gets Generated
 
 - `AGENTS.md` - Project context for AI coding agents (workflows, testing, conventions)
@@ -66,3 +77,27 @@ Learn more: [agents.md](https://agents.md/)
 ## License
 
 MIT
+
+
+---
+
+## AI-Native Development
+
+This project is configured for AI-native development with AI coding assistants.
+
+### AI Configuration Files
+
+- **AGENTS.md**: Project context and conventions for AI coding agents (Claude Code, GitHub Copilot, Cursor, etc.)
+- **CLAUDE.md**: Reference file that points Claude Code to AGENTS.md
+
+### Working with AI Assistants
+
+AI coding assistants will automatically read `AGENTS.md` to understand:
+- How to build and test your project
+- Code quality standards to follow
+- Testing requirements
+- Documentation expectations
+
+Customize `AGENTS.md` with your project-specific build commands, test commands, and conventions.
+
+Generated with [cortex-kit](https://www.npmjs.com/package/cortex-kit)

package/bin/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { init } from '../src/index.js';
+import { init, enable } from '../src/index.js';
 
 // Parse command line arguments
 const args = process.argv.slice(2);
@@ -12,18 +12,23 @@ if (!command) {
   console.error('Error: No command provided');
   console.log('Usage: cortex-kit init [project-name]');
   console.log('       cortex-kit init .  (for current directory)');
+  console.log('       cortex-kit enable  (enable AI features in existing project)');
   process.exit(1);
 }
 
-if (command !== 'init') {
+if (command !== 'init' && command !== 'enable') {
   console.error(`Error: Unknown command "${command}"`);
-  console.log('Available commands: init');
+  console.log('Available commands: init, enable');
   process.exit(1);
 }
 
-// Execute init command
+// Execute command
 try {
-  await init(projectName);
+  if (command === 'init') {
+    await init(projectName);
+  } else if (command === 'enable') {
+    await enable();
+  }
 } catch (error) {
   console.error('Error:', error.message);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortex-kit",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CLI tool that scaffolds AI-native projects with AGENTS.md specifications",
   "type": "module",
   "main": "src/index.js",

package/src/generator.js

@@ -1,4 +1,4 @@
-import { writeFile, readFile } from 'fs/promises';
+import { writeFile, readFile, access, appendFile } from 'fs/promises';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -29,3 +29,84 @@ export async function generateFiles(targetDir) {
     }
   }
 }
+
+/**
+ * Check if a file exists
+ * @param {string} filePath - Path to check
+ * @returns {Promise<boolean>} - True if file exists
+ */
+async function fileExists(filePath) {
+  try {
+    await access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Enable AI features in existing project
+ * @param {string} targetDir - Target directory path
+ */
+export async function enableFiles(targetDir) {
+  // Check if AGENTS.md exists
+  const agentsPath = join(targetDir, 'AGENTS.md');
+  const agentsExists = await fileExists(agentsPath);
+
+  if (agentsExists) {
+    console.log('⊘ Skipped AGENTS.md (already exists)');
+  } else {
+    const templatePath = join(__dirname, 'templates', 'AGENTS.md');
+    const content = await readFile(templatePath, 'utf-8');
+    await writeFile(agentsPath, content, 'utf-8');
+    console.log('✓ Generated AGENTS.md');
+  }
+
+  // Always create CLAUDE.md
+  const claudePath = join(targetDir, 'CLAUDE.md');
+  const claudeTemplatePath = join(__dirname, 'templates', 'CLAUDE.md');
+  const claudeContent = await readFile(claudeTemplatePath, 'utf-8');
+  await writeFile(claudePath, claudeContent, 'utf-8');
+  console.log('✓ Generated CLAUDE.md');
+
+  // Check if README.md exists
+  const readmePath = join(targetDir, 'README.md');
+  const readmeExists = await fileExists(readmePath);
+
+  if (readmeExists) {
+    // Append AI setup section to existing README
+    const aiSection = `
+
+---
+
+## AI-Native Development
+
+This project is configured for AI-native development with AI coding assistants.
+
+### AI Configuration Files
+
+- **AGENTS.md**: Project context and conventions for AI coding agents (Claude Code, GitHub Copilot, Cursor, etc.)
+- **CLAUDE.md**: Reference file that points Claude Code to AGENTS.md
+
+### Working with AI Assistants
+
+AI coding assistants will automatically read \`AGENTS.md\` to understand:
+- How to build and test your project
+- Code quality standards to follow
+- Testing requirements
+- Documentation expectations
+
+Customize \`AGENTS.md\` with your project-specific build commands, test commands, and conventions.
+
+Generated with [cortex-kit](https://www.npmjs.com/package/cortex-kit)
+`;
+    await appendFile(readmePath, aiSection, 'utf-8');
+    console.log('✓ Appended AI setup section to README.md');
+  } else {
+    // Create new README.md
+    const readmeTemplatePath = join(__dirname, 'templates', 'README.md');
+    const readmeContent = await readFile(readmeTemplatePath, 'utf-8');
+    await writeFile(readmePath, readmeContent, 'utf-8');
+    console.log('✓ Generated README.md');
+  }
+}

package/src/index.js

@@ -1,6 +1,6 @@
 import { resolve, join } from 'path';
 import { mkdir } from 'fs/promises';
-import { generateFiles } from './generator.js';
+import { generateFiles, enableFiles } from './generator.js';
 
 /**
  * Initialize a new AI-native project
@@ -57,3 +57,30 @@ export async function init(projectName) {
   console.log('  - README.md: Setup instructions');
   console.log('  - docs/: Architecture documentation folder');
 }
+
+/**
+ * Enable AI features in an existing project
+ */
+export async function enable() {
+  const targetDir = process.cwd();
+
+  console.log('🚀 Enabling AI features in current directory...');
+
+  // Create docs directory
+  const docsDir = join(targetDir, 'docs');
+  try {
+    await mkdir(docsDir, { recursive: true });
+    console.log('✓ Created docs/ directory');
+  } catch (error) {
+    throw new Error(`Failed to create docs directory: ${error.message}`);
+  }
+
+  // Generate files for existing project (skip AGENTS.md if exists, append README.md)
+  await enableFiles(targetDir);
+
+  console.log('\n✨ AI features enabled!');
+  console.log('\nNext steps:');
+  console.log('  1. Customize AGENTS.md with your project details');
+  console.log('  2. Add build and test commands to AGENTS.md');
+  console.log('  3. Open your project with Claude Code or other AI tools');
+}