refactor(init): streamline AI tool selection and update user prompts in AGENTS.md and README.md

Author: Marvin Zhang

packages/cli/src/commands/init.ts

@@ -308,16 +308,31 @@ export async function initProject(skipPrompts = false, templateOption?: string,
       console.log('');
     }
 
-    const toolChoices = Object.entries(AI_TOOL_CONFIGS).map(([key, config]) => ({
-      name: config.description,
-      value: key as AIToolKey,
-      checked: detectedDefaults.includes(key as AIToolKey),
-    }));
-
-    selectedAgentTools = await checkbox({
-      message: 'Which AI tools do you use? (creates symlinks for tool-specific instruction files)',
-      choices: toolChoices,
-    });
+    // Only show tools that require symlinks (Claude, Gemini)
+    // Filter to only show tools that require symlinks
+    const symlinkTools = Object.entries(AI_TOOL_CONFIGS)
+      .filter(([, config]) => config.usesSymlink)
+      .map(([key, config]) => ({
+        name: config.description,
+        value: key as AIToolKey,
+        checked: detectedDefaults.includes(key as AIToolKey),
+      }));
+
+    // Ask about symlinks only if there are tools that need them
+    if (symlinkTools.length > 0) {
+      console.log('');
+      console.log(chalk.gray('AGENTS.md will be created as the primary instruction file.'));
+      console.log(chalk.gray('Some AI tools (Claude Code, Gemini CLI) use their own filenames.'));
+      console.log('');
+      
+      const symlinkSelection = await checkbox({
+        message: 'Create symlinks for additional AI tools?',
+        choices: symlinkTools,
+      });
+      selectedAgentTools = symlinkSelection;
+    } else {
+      selectedAgentTools = [];
+    }
   }
 
   // Create .lean-spec/templates/ directory
@@ -497,9 +512,10 @@ export async function initProject(skipPrompts = false, templateOption?: string,
   console.log('');
   console.log(chalk.green('✓ LeanSpec initialized!'));
   console.log('');
-  console.log('Next steps:');
-  console.log(chalk.cyan('  1. Edit AGENTS.md') + chalk.gray(' → Fill in the "📋 Project Context" section'));
-  console.log(chalk.cyan('  2. Create your first spec:') + chalk.gray(' lean-spec create my-feature'));
+  console.log(chalk.cyan('You\'re ready to go!') + chalk.gray(' Ask your AI to create a spec for your next feature.'));
+  console.log('');
+  console.log(chalk.gray('Example: "Create a spec for user authentication"'));
+  console.log(chalk.gray('Learn more: https://lean-spec.dev/docs/guide/getting-started'));
   console.log('');
 }
 

packages/cli/templates/detailed/AGENTS.md

@@ -2,25 +2,6 @@
 
 ## Project: {project_name}
 
-<!-- ═══════════════════════════════════════════════════════════════════════════
-     👇 TODO: Fill in your project context below (then delete these comments)
-     ═══════════════════════════════════════════════════════════════════════════ -->
-
-### 📋 Project Context
-
-**What this project does:**
-_TODO: Describe your project in 1-2 sentences_
-
-**Tech stack:**
-_TODO: List main technologies (e.g., Node.js, React, PostgreSQL)_
-
-**Key objectives:**
-_TODO: What are you building toward? (e.g., Launch MVP by Q1)_
-
-<!-- ═══════════════════════════════════════════════════════════════════════════
-     👆 End of TODO section - Delete these comment markers when done
-     ═══════════════════════════════════════════════════════════════════════════ -->
-
 ## 🚨 CRITICAL: Before ANY Task
 
 **STOP and check these first:**

packages/cli/templates/detailed/README.md

@@ -22,7 +22,7 @@ Keep it lean, but organized. Use sub-specs to manage complexity without overwhel
 
 ## Next Steps
 
-1. Customize AGENTS.md for your project
-2. Create your first spec: `lean-spec create my-feature`
-3. When a spec grows large, split sections into sub-spec files
+You're ready to go! Ask your AI to create a spec for your next feature.
+
+When a spec grows large, consider splitting sections into sub-spec files.
 

packages/cli/templates/standard/AGENTS.md

@@ -2,25 +2,6 @@
 
 ## Project: {project_name}
 
-<!-- ═══════════════════════════════════════════════════════════════════════════
-     👇 TODO: Fill in your project context below (then delete these comments)
-     ═══════════════════════════════════════════════════════════════════════════ -->
-
-### 📋 Project Context
-
-**What this project does:**
-_TODO: Describe your project in 1-2 sentences_
-
-**Tech stack:**
-_TODO: List main technologies (e.g., Node.js, React, PostgreSQL)_
-
-**Key objectives:**
-_TODO: What are you building toward? (e.g., Launch MVP by Q1)_
-
-<!-- ═══════════════════════════════════════════════════════════════════════════
-     👆 End of TODO section - Delete these comment markers when done
-     ═══════════════════════════════════════════════════════════════════════════ -->
-
 ## 🚨 CRITICAL: Before ANY Task
 
 **STOP and check these first:**

packages/cli/templates/standard/README.md

@@ -21,6 +21,5 @@ Keep it lean. Write specs for features that need clarity. Skip them for obvious
 
 ## Next Steps
 
-1. Customize AGENTS.md for your project
-2. Create your first spec: `lean-spec create my-feature`
+You're ready to go! Ask your AI to create a spec for your next feature.