claude-code-autoconfig 1.0.7 → 1.0.9

package/.claude/commands/autoconfig.md

@@ -65,7 +65,86 @@ If CLAUDE.md mentions MCP servers or tool integrations:
 2. Add to `.claude/.mcp.json` in the mcpServers object
 3. Notify: "Migrated MCP config to .claude/.mcp.json"
 
-## Step 1: Detect Environment
+## Step 1: Create Scaffold Files
+
+Create these files if they don't already exist:
+
+### .claude/settings.json
+```json
+{
+  "permissions": {
+    "allow": [
+      "Read(./**)",
+      "Edit(./**)",
+      "Write(./**)",
+      "WebSearch",
+      "WebFetch",
+      "Bash(npm run dev)",
+      "Bash(npm run build)",
+      "Bash(npm run lint)",
+      "Bash(npm run lint:fix)",
+      "Bash(npm run typecheck)",
+      "Bash(npm run test)",
+      "Bash(npm run test:*)",
+      "Bash(npm run validate)",
+      "Bash(git status)",
+      "Bash(git diff:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(git pull)",
+      "Bash(git checkout:*)",
+      "Bash(git branch:*)"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./secrets/**)",
+      "Read(./**/credentials.*)",
+      "Read(./**/*.pem)",
+      "Read(./**/*.key)",
+      "Bash(rm -rf:*)",
+      "Bash(curl:*)",
+      "Bash(wget:*)"
+    ]
+  }
+}
+```
+
+### .claude/.mcp.json
+```json
+{
+  "mcpServers": {}
+}
+```
+
+### .claude/feedback/FEEDBACK.md
+```markdown
+<!-- @description Team-maintained corrections and guidance for Claude. Add notes here when Claude does something wrong — it learns for next time. This directory persists across /autoconfig runs. -->
+
+# Team Feedback
+
+Add corrections and guidance here when Claude does something wrong.
+Claude reads this directory and learns for next time.
+
+## YYYY-MM-DD: Brief title
+
+Describe what Claude did wrong and what to do instead.
+Keep entries brief and actionable.
+```
+
+### .claude/rules/ (empty directory)
+Create the directory if it doesn't exist.
+
+### CLAUDE.md (template)
+If no CLAUDE.md exists, create it with this template:
+```markdown
+# Project Name
+
+> Run `/autoconfig` to populate this based on your project.
+```
+
+## Step 2: Detect Environment
 
 **Operating System:**
 Check the platform and note it for command syntax:
@@ -74,7 +153,7 @@ Check the platform and note it for command syntax:
 
 Include this in CLAUDE.md so all commands use the correct syntax.
 
-## Step 2: Scan the Project
+## Step 3: Scan the Project
 
 Look for these indicators to understand the project:
 
@@ -117,7 +196,7 @@ Look for these indicators to understand the project:
 - `.github/workflows/` → GitHub Actions
 - `serverless.yml` → Serverless Framework
 
-## Step 3: Populate CLAUDE.md
+## Step 4: Populate CLAUDE.md
 
 Focus on what Claude Code actually needs to work effectively. Claude can explore the codebase itself — don't document what it can discover.
 
@@ -158,60 +237,6 @@ See `.claude/feedback/` for corrections and guidance from the team.
 
 This pointer persists across autoconfig runs and directs Claude to team-maintained content.
 
-## Step 4: Create Rules Directory
-
-Create an empty `.claude/rules/` directory. Do not create any subdirectories or rule files.
-
-Rules are path-scoped context files that load automatically when Claude works on matching files. Effective rules require deep understanding of your codebase patterns, team conventions, and quality goals — they should be crafted intentionally, not auto-generated.
-
-## Step 5: Configure Settings
-
-Update `.claude/settings.json` using the official schema.
-
-### Deny Patterns (files Claude shouldn't read/write)
-
-Use `Read()` for blocking reads, `Edit()` for blocking writes:
-
-**Always deny (security):**
-```
-Read(./.env)
-Read(./.env.*)
-Read(./secrets/**)
-Edit(./.env)
-Edit(./.env.*)
-```
-
-**Often deny (generated/vendor):**
-```
-Edit(./node_modules/**)
-Edit(./dist/**)
-Edit(./.git/**)
-```
-
-### Allow Patterns (auto-approve without prompting)
-
-Use `Bash()` patterns with prefix matching:
-
-```
-Bash(npm run test:*)
-Bash(npm run lint:*)
-Bash(npm run build)
-```
-
-### Environment Variables
-
-Set session-level env vars:
-
-```json
-{
-  "env": {
-    "NODE_ENV": "development"
-  }
-}
-```
-
-**Keep it minimal** — only include patterns that actually exist in this project.
-
 ## Guidelines
 
 - Replace ALL placeholder content with real values from THIS project
@@ -219,7 +244,7 @@ Set session-level env vars:
 - Optimize for Claude's efficiency, not human documentation
 - When uncertain, leave it out — Claude can ask or explore
 
-## Step 6: Update the Guide
+## Step 5: Update the Guide
 
 After populating CLAUDE.md, update the guide's file preview to show the actual content:
 

package/bin/cli.js

@@ -2,11 +2,22 @@
 
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 const { execSync, spawn } = require('child_process');
 
 const cwd = process.cwd();
 const packageDir = path.dirname(__dirname);
 
+// Reserved Windows device names - never create files with these names
+const WINDOWS_RESERVED = ['CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM2', 'COM3', 'COM4',
+  'COM5', 'COM6', 'COM7', 'COM8', 'COM9', 'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5',
+  'LPT6', 'LPT7', 'LPT8', 'LPT9'];
+
+function isReservedName(name) {
+  const baseName = name.replace(/\.[^.]*$/, '').toUpperCase();
+  return WINDOWS_RESERVED.includes(baseName);
+}
+
 console.log('\x1b[36m%s\x1b[0m', '🚀 Claude Code Autoconfig');
 console.log();
 
@@ -43,115 +54,18 @@ if (!isClaudeInstalled()) {
 
 console.log('\x1b[32m%s\x1b[0m', '✅ Claude Code detected');
 
-// Step 2: Backup existing .claude/ if present
+// Step 2: Copy minimal bootstrap (commands/ and guide/ only)
 const claudeDest = path.join(cwd, '.claude');
-const SKIP_FILES = ['settings.local.json', 'retro', 'migration'];
-let migrationPath = null;
-
-function copyDirForBackup(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (SKIP_FILES.includes(entry.name)) continue;
-
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      copyDirForBackup(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-if (fs.existsSync(claudeDest)) {
-  // Create timestamped backup
-  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-  const migrationDir = path.join(claudeDest, 'migration');
-  migrationPath = path.join(migrationDir, timestamp);
-
-  fs.mkdirSync(migrationPath, { recursive: true });
-
-  // Copy existing files to backup (excluding migration folder itself)
-  const entries = fs.readdirSync(claudeDest, { withFileTypes: true });
-  for (const entry of entries) {
-    if (entry.name === 'migration') continue;
-
-    const srcPath = path.join(claudeDest, entry.name);
-    const destPath = path.join(migrationPath, entry.name);
-
-    if (entry.isDirectory()) {
-      copyDirForBackup(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-
-  // Write migration metadata for the guide to read
-  const latestPath = path.join(migrationDir, 'latest.json');
-  const backedUpFiles = [];
-
-  function collectFiles(dir, prefix = '') {
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
-      if (entry.isDirectory()) {
-        collectFiles(path.join(dir, entry.name), relPath);
-      } else {
-        backedUpFiles.push(relPath);
-      }
-    }
-  }
-  collectFiles(migrationPath);
-
-  fs.writeFileSync(latestPath, JSON.stringify({
-    timestamp: timestamp,
-    backedUpFiles: backedUpFiles
-  }, null, 2));
-
-  // Create/update migration README
-  const readmePath = path.join(migrationDir, 'README.md');
-  const readmeContent = `# Migration Backups
-
-This folder contains backups of previous .claude/ configurations created during autoconfig upgrades.
-
-Each timestamped folder contains the files that existed before that migration.
-
-## Backups
-
-- \`${timestamp}/\` - Backup created during autoconfig install
-
-## Restoring
-
-To restore a previous configuration, copy files from the backup folder back to \`.claude/\`.
-`;
-
-  // Append to existing README or create new
-  if (fs.existsSync(readmePath)) {
-    const existing = fs.readFileSync(readmePath, 'utf8');
-    const newEntry = `- \`${timestamp}/\` - Backup created during autoconfig install\n`;
-    if (!existing.includes(timestamp)) {
-      const updated = existing.replace('## Backups\n\n', `## Backups\n\n${newEntry}`);
-      fs.writeFileSync(readmePath, updated);
-    }
-  } else {
-    fs.writeFileSync(readmePath, readmeContent);
-  }
-
-  console.log('\x1b[33m%s\x1b[0m', `⚠️  Existing .claude/ backed up to migration/${timestamp}/`);
-}
-
-// Step 3: Copy new files
-const claudeSrc = path.join(packageDir, '.claude');
+const commandsSrc = path.join(packageDir, '.claude', 'commands');
+const guideSrc = path.join(packageDir, '.claude', 'guide');
+const agentsSrc = path.join(packageDir, '.claude', 'agents');
 
 function copyDir(src, dest) {
   fs.mkdirSync(dest, { recursive: true });
   const entries = fs.readdirSync(src, { withFileTypes: true });
 
   for (const entry of entries) {
-    if (SKIP_FILES.includes(entry.name)) continue;
+    if (isReservedName(entry.name)) continue;
 
     const srcPath = path.join(src, entry.name);
     const destPath = path.join(dest, entry.name);
@@ -164,44 +78,60 @@ function copyDir(src, dest) {
   }
 }
 
-if (fs.existsSync(claudeSrc)) {
-  copyDir(claudeSrc, claudeDest);
-  console.log('\x1b[32m%s\x1b[0m', '✅ Created .claude/ directory');
+// Copy commands (required for /autoconfig to work)
+if (fs.existsSync(commandsSrc)) {
+  copyDir(commandsSrc, path.join(claudeDest, 'commands'));
 } else {
-  console.log('\x1b[31m%s\x1b[0m', '❌ Error: .claude directory not found in package');
+  console.log('\x1b[31m%s\x1b[0m', '❌ Error: commands directory not found');
   process.exit(1);
 }
 
-// Copy CLAUDE.md (don't overwrite if exists)
-const claudeMdSrc = path.join(packageDir, 'CLAUDE.md');
-const claudeMdDest = path.join(cwd, 'CLAUDE.md');
+// Copy guide (too large to generate)
+if (fs.existsSync(guideSrc)) {
+  copyDir(guideSrc, path.join(claudeDest, 'guide'));
+}
 
-if (fs.existsSync(claudeMdDest)) {
-  // Backup existing CLAUDE.md to migration folder if we have one
-  if (migrationPath) {
-    fs.copyFileSync(claudeMdDest, path.join(migrationPath, 'CLAUDE.md'));
-  }
-  console.log('\x1b[33m%s\x1b[0m', '⚠️  CLAUDE.md exists, saved template as CLAUDE.md.template');
-  fs.copyFileSync(claudeMdSrc, path.join(cwd, 'CLAUDE.md.template'));
-} else if (fs.existsSync(claudeMdSrc)) {
-  fs.copyFileSync(claudeMdSrc, claudeMdDest);
-  console.log('\x1b[32m%s\x1b[0m', '✅ Created CLAUDE.md');
+// Copy agents if exists
+if (fs.existsSync(agentsSrc)) {
+  copyDir(agentsSrc, path.join(claudeDest, 'agents'));
 }
 
-// Step 4: Launch Claude Code
+console.log('\x1b[32m%s\x1b[0m', '✅ Prepared /autoconfig command');
+
+// Step 3: Show "ONE MORE STEP" message
 console.log();
-console.log('\x1b[36m%s\x1b[0m', '🚀 Launching Claude Code...');
-console.log('\x1b[33m%s\x1b[0m', '   Run /autoconfig to complete setup');
+console.log('\x1b[33m%s\x1b[0m', '╔═══════════════════════════════════════════════════╗');
+console.log('\x1b[33m%s\x1b[0m', '║                                                   ║');
+console.log('\x1b[33m%s\x1b[0m', '║              ⚡ ONE MORE STEP                     ║');
+console.log('\x1b[33m%s\x1b[0m', '║                                                   ║');
+console.log('\x1b[33m%s\x1b[0m', '║   Run \x1b[36m/autoconfig\x1b[33m in Claude Code              ║');
+console.log('\x1b[33m%s\x1b[0m', '║   to complete setup                               ║');
+console.log('\x1b[33m%s\x1b[0m', '║                                                   ║');
+console.log('\x1b[33m%s\x1b[0m', '╚═══════════════════════════════════════════════════╝');
 console.log();
 
-// Spawn claude in the current directory, inheriting stdio for interactive use
-const claude = spawn('claude', [], {
-  cwd: cwd,
-  stdio: 'inherit',
-  shell: true
+// Step 4: Wait for Enter, then launch Claude Code
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
 });
 
-claude.on('error', (err) => {
-  console.log('\x1b[31m%s\x1b[0m', '❌ Failed to launch Claude Code');
-  console.log('   Run "claude" manually, then run /autoconfig');
+rl.question('\x1b[90mPress ENTER to open Claude Code...\x1b[0m', () => {
+  rl.close();
+
+  console.log();
+  console.log('\x1b[36m%s\x1b[0m', '🚀 Launching Claude Code...');
+  console.log();
+
+  // Spawn claude in the current directory
+  const claude = spawn('claude', [], {
+    cwd: cwd,
+    stdio: 'inherit',
+    shell: true
+  });
+
+  claude.on('error', (err) => {
+    console.log('\x1b[31m%s\x1b[0m', '❌ Failed to launch Claude Code');
+    console.log('   Run "claude" manually, then run /autoconfig');
+  });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.",
   "author": "ADAC 1001 <info@adac1001.com>",
   "license": "MIT",