feat(init): Update initialization messages for clearer onboarding steps

docs(agents): Enhance AGENTS.md template with detailed project context prompts

fix(specs): Mark onboarding project context clarity as complete and update status

Author: tikazyq

packages/cli/src/commands/init.ts

@@ -402,9 +402,8 @@ export async function initProject(skipPrompts = false, templateOption?: string,
   console.log(chalk.green('✓ LeanSpec initialized!'));
   console.log('');
   console.log('Next steps:');
-  console.log(chalk.gray('  - Review and customize AGENTS.md'));
-  console.log(chalk.gray('  - Check out example spec in specs/'));
-  console.log(chalk.gray('  - Create your first spec: lean-spec create my-feature'));
+  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('');
 }
 

packages/cli/templates/detailed/AGENTS.md

@@ -2,7 +2,24 @@
 
 ## Project: {project_name}
 
-Lightweight spec methodology for AI-powered development.
+<!-- ═══════════════════════════════════════════════════════════════════════════
+     👇 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
 

packages/cli/templates/standard/AGENTS.md

@@ -2,7 +2,24 @@
 
 ## Project: {project_name}
 
-Lightweight spec methodology for AI-powered development.
+<!-- ═══════════════════════════════════════════════════════════════════════════
+     👇 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
 

specs/125-onboarding-project-context-clarity/README.md

@@ -1,21 +1,25 @@
 ---
-status: in-progress
+status: complete
 created: '2025-11-26'
 tags:
   - onboarding
   - user-experience
   - agents-md
 priority: high
 created_at: '2025-11-26T08:24:50.022Z'
-updated_at: '2025-11-26T08:24:54.329Z'
+updated_at: '2025-11-26T08:27:32.463Z'
 transitions:
   - status: in-progress
     at: '2025-11-26T08:24:54.329Z'
+  - status: complete
+    at: '2025-11-26T08:27:32.463Z'
+completed_at: '2025-11-26T08:27:32.463Z'
+completed: '2025-11-26'
 ---
 
 # Streamline Onboarding: Clear Project Context Section
 
-> **Status**: ⏳ In progress · **Priority**: High · **Created**: 2025-11-26 · **Tags**: onboarding, user-experience, agents-md
+> **Status**: ✅ Complete · **Priority**: High · **Created**: 2025-11-26 · **Tags**: onboarding, user-experience, agents-md
 
 **Project**: lean-spec  
 **Team**: Core Development