claude-code-autoconfig 1.0.10 → 1.0.12

package/.claude/guide/autoconfig.guide.html

@@ -899,6 +899,11 @@
                                 <span class="tree-file-icon">📄</span>
                                 <span class="file">FEEDBACK.md</span>
                             </div>
+                            <div class="tree-item indent-2 hidden" data-info="agents" data-parent="claude-dir">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-folder-icon">📁</span>
+                                <span class="folder">agents</span>
+                            </div>
                             <div class="tree-item indent-2 folder-row hidden collapsed" data-info="guide" data-folder="guide-folder" data-parent="claude-dir">
                                 <span class="tree-chevron">›</span>
                                 <span class="tree-folder-icon">📁</span>
@@ -1229,6 +1234,10 @@
                 title: 'feedback/',
                 desc: 'Team-maintained corrections and guidance for Claude. Add notes here when Claude does something wrong — it learns for next time. This directory persists across <code>/autoconfig</code> runs.'
             },
+            'agents': {
+                title: 'agents/',
+                desc: 'Custom AI agents for specialized tasks. Each <code>.md</code> file defines an agent that Claude can spawn for complex, multi-step operations. Use <code>/enable-retro</code> to add a retro item agent.'
+            },
             'feedback-template': {
                 title: 'FEEDBACK.md',
                 desc: 'Starter template for team feedback. Add dated entries when Claude makes mistakes — include what went wrong and the correct approach. Claude reads this on every session.'

package/bin/cli.js

@@ -54,8 +54,106 @@ if (!isClaudeInstalled()) {
 
 console.log('\x1b[32m%s\x1b[0m', '✅ Claude Code detected');
 
-// Step 2: Copy minimal bootstrap (commands/ and guide/ only)
+// Step 2: Backup existing .claude/ if present
 const claudeDest = path.join(cwd, '.claude');
+const SKIP_BACKUP = ['migration']; // Don't backup the migration folder itself
+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_BACKUP.includes(entry.name)) continue;
+    if (isReservedName(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);
+    }
+  }
+}
+
+function collectFiles(dir, prefix = '') {
+  const files = [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      files.push(...collectFiles(path.join(dir, entry.name), relPath));
+    } else {
+      files.push(relPath);
+    }
+  }
+  return files;
+}
+
+if (fs.existsSync(claudeDest)) {
+  // Check if there are files worth backing up (not just empty dirs)
+  const existingEntries = fs.readdirSync(claudeDest).filter(e => e !== 'migration');
+
+  if (existingEntries.length > 0) {
+    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
+    for (const entry of existingEntries) {
+      const srcPath = path.join(claudeDest, entry);
+      const destPath = path.join(migrationPath, entry);
+
+      if (fs.statSync(srcPath).isDirectory()) {
+        copyDirForBackup(srcPath, destPath);
+      } else {
+        fs.copyFileSync(srcPath, destPath);
+      }
+    }
+
+    // Collect backed up files for metadata
+    const backedUpFiles = collectFiles(migrationPath);
+
+    // Write latest.json for the guide
+    fs.writeFileSync(path.join(migrationDir, 'latest.json'), JSON.stringify({
+      timestamp: timestamp,
+      backedUpFiles: backedUpFiles
+    }, null, 2));
+
+    // Create README inside the dated backup folder
+    const backupReadme = `# Migration Backup: ${timestamp}
+
+This folder contains a backup of your previous .claude/ configuration.
+
+## Why This Backup Exists
+
+You ran \`npx claude-code-autoconfig\` on a project that already had Claude Code configured.
+Your previous files were backed up here before the new configuration was applied.
+
+## Backed Up Files
+
+${backedUpFiles.map(f => `- ${f}`).join('\n')}
+
+## Restoring Files
+
+To restore any file, copy it from this folder back to \`.claude/\`.
+
+For example:
+\`\`\`bash
+cp .claude/migration/${timestamp}/settings.json .claude/settings.json
+\`\`\`
+`;
+    fs.writeFileSync(path.join(migrationPath, 'README.md'), backupReadme);
+
+    console.log('\x1b[33m%s\x1b[0m', `⚠️  Backed up existing config to .claude/migration/${timestamp}/`);
+  }
+}
+
+// Step 3: Copy minimal bootstrap (commands/, guide/, agents/)
 const commandsSrc = path.join(packageDir, '.claude', 'commands');
 const guideSrc = path.join(packageDir, '.claude', 'guide');
 const agentsSrc = path.join(packageDir, '.claude', 'agents');
@@ -98,7 +196,7 @@ if (fs.existsSync(agentsSrc)) {
 
 console.log('\x1b[32m%s\x1b[0m', '✅ Prepared /autoconfig command');
 
-// Step 3: Show "ONE MORE STEP" message
+// Step 4: Show "ONE MORE STEP" message
 console.log();
 console.log('\x1b[33m╔══════════════════════════════════════════╗\x1b[0m');
 console.log('\x1b[33m║                                          ║\x1b[0m');
@@ -110,7 +208,7 @@ console.log('\x1b[33m║                                          ║\x1b[0m');
 console.log('\x1b[33m╚══════════════════════════════════════════╝\x1b[0m');
 console.log();
 
-// Step 4: Wait for Enter, then launch Claude Code
+// Step 5: Wait for Enter, then launch Claude Code
 const rl = readline.createInterface({
   input: process.stdin,
   output: process.stdout

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "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",