ai-flow-dev 1.0.2 → 1.0.3

package/README.md

@@ -129,7 +129,7 @@ Or using uv (Python tool manager):
 uv tool install ai-flow-dev
 ```
 
-**Current version:** 1.0.2
+**Current version:** 1.0.3
 
 ---
 

package/dist/cli.js

@@ -679,7 +679,7 @@ async function initializeProject(targetPath, aiTool, projectType, projectName, p
 program
     .name('ai-flow')
     .description('AI-powered development workflow from idea to production. Generate specs, plan features, and build with AI assistance.')
-    .version('1.0.2');
+    .version('1.0.3');
 program
     .command('init')
     .description('Initialize AI Flow in current directory')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-flow-dev",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "AI-powered development workflow from idea to production. Generate specs, plan features, and build with AI assistance throughout your project lifecycle.",
   "main": "dist/cli.js",
   "bin": {

package/prompts/backend/flow-project-init.md

@@ -26,9 +26,9 @@ Before executing this command, ensure:
 
 ---
 
-## Workflow: 2 Steps
+## Workflow: 3 Steps
 
-### Step 1: Read Documentation (1 minute - automatic)
+### Step 1: Read Documentation & Prepare Directory (1-2 minutes)
 
 **Read `ai-instructions.md` to identify:**
 
@@ -36,6 +36,25 @@ Before executing this command, ensure:
 - Framework and version (if any)
 - Package manager preference
 
+**Check for conflicting files:**
+
+Most framework CLIs fail if they detect existing files like `README.md`, `package.json`, `.gitignore`, etc.
+
+**Strategy: Temporary move → Initialize → Merge back**
+
+```bash
+# 1. Create temporary backup
+mkdir -p .ai-flow/temp-backup
+
+# 2. Move AI Flow documentation temporarily (NOT deletion)
+mv README.md .ai-flow/temp-backup/ 2>/dev/null || true
+mv package.json .ai-flow/temp-backup/ 2>/dev/null || true
+mv tsconfig.json .ai-flow/temp-backup/ 2>/dev/null || true
+mv .gitignore .ai-flow/temp-backup/ 2>/dev/null || true
+
+# 3. Keep .ai-flow/ directory intact with all documentation
+```
+
 **Display summary:**
 
 ```
@@ -49,8 +68,10 @@ Before executing this command, ensure:
 
 Target Directory: {{PWD}}
 
-⚠️  IMPORTANT: This will initialize the project in the CURRENT directory.
-   No subdirectories will be created.
+⚠️  IMPORTANT: 
+   • Files temporarily moved to .ai-flow/temp-backup/
+   • Will merge AI Flow docs with framework files after init
+   • .ai-flow/ directory preserved with all documentation
 
 Continue? (Y/n)
 ```
@@ -74,7 +95,7 @@ Please specify the framework to use:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🏗️  Step 2/2: Initialize Project
+🏗️  Step 2/3: Initialize Project
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -82,8 +103,9 @@ Please specify the framework to use:
 
 1. ✅ **Initialize in current directory** (use `.` when the CLI supports it)
 2. ✅ **Use official CLI tools** (don't create manual folder structures)
-3. ❌ **DO NOT create subdirectories** (no `mkdir project-name`)
-4. ❌ **DO NOT create manual file structures**
+3. ✅ **Directory must be clean** (backup existing files first if needed)
+4. ❌ **DO NOT create subdirectories** (no `mkdir project-name`)
+5. ❌ **DO NOT create manual file structures**
 
 ---
 
@@ -196,6 +218,61 @@ unzip -o project.zip && rm project.zip
 
 ---
 
++### Step 3: Merge AI Flow Documentation with Framework Files (2-3 minutes)
+
+After framework initialization completes, intelligently merge the documentation:
+
+**3.1 README Strategy:**
+
+```bash
+# 1. Rename framework README to preserve it
+mv README.md docs/README.framework.md
+
+# 2. Use AI Flow README as main (already linked to all docs)
+# The README from ai-flow init already references:
+# - ai-instructions.md
+# - project-brief.md  
+# - All specs/ and docs/ files
+# Keep it as the main README.md (it's in .ai-flow/temp-backup/)
+
+# 3. Copy back AI Flow README
+cp .ai-flow/temp-backup/README.md .
+```
+
+**3.2 Merge package.json (if applicable):**
+
+```bash
+# For Node.js projects only:
+# Framework created package.json with scripts, dependencies
+
+# Strategy: Keep framework package.json, add AI Flow metadata
+# Read both files and merge:
+# - Keep framework: scripts, dependencies, devDependencies
+# - Add from AI Flow backup: name, description, keywords, author
+```
+
+**3.3 Merge tsconfig.json/config files:**
+
+```bash
+# Keep framework configuration (optimized for the framework)
+# AI Flow backup likely didn't have project-specific config anyway
+```
+
+**3.4 Merge .gitignore:**
+
+```bash
+# Combine both .gitignore files
+cat .gitignore .ai-flow/temp-backup/.gitignore | sort -u > .gitignore.merged
+mv .gitignore.merged .gitignore
+```
+
+**3.5 Clean up temp backup:**
+
+```bash
+# Remove temporary backup (already merged)
+rm -rf .ai-flow/temp-backup
+```
+
 **Success Output:**
 
 ```
@@ -208,12 +285,19 @@ unzip -o project.zip && rm project.zip
 Generated structure:
 {{LIST_KEY_FILES}}
 
+📋 Documentation merged:
+   ✅ README.md (AI Flow - links to all docs)
+   ✅ docs/README.framework.md (Framework reference)
+   ✅ package.json (Framework + AI Flow metadata)
+   ✅ .gitignore (Combined rules)
+
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Next steps:
-1. Review generated files
-2. Run /flow-project-roadmap to plan implementation
-3. Start development with /feature commands
+1. Review merged files (README.md is your main entry point)
+2. Check docs/README.framework.md for framework-specific setup
+3. Run /flow-project-roadmap to plan implementation
+4. Start development with /feature commands
 ```
 
 ---