@sylphx/flow 2.26.0 → 2.28.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @sylphx/flow
 
+## 2.28.0 (2025-12-18)
+
+### ✨ Features
+
+- **commands:** add /init command to create project docs ([a07d7a3](https://github.com/SylphxAI/flow/commit/a07d7a3afd8a6448547843e081c3dde446b95c69))
+
+## 2.27.0 (2025-12-18)
+
+### ✨ Features
+
+- **flow:** auto-create PRODUCT.md and ARCHITECTURE.md if missing ([3ae7db8](https://github.com/SylphxAI/flow/commit/3ae7db8770920422597ab073ba69b48248fd1f8b))
+
 ## 2.26.0 (2025-12-18)
 
 ### ✨ Features

package/assets/rules/core.md

@@ -124,6 +124,7 @@ Before accepting any approach:
 - **Before significant work**, read:
   - `PRODUCT.md` — Vision, goals, features, target users, success metrics
   - `ARCHITECTURE.md` — Tech stack, patterns, decisions, system design
+- **If files don't exist**, create them with appropriate structure for the project
 - **Update immediately** when relevant changes happen
 - Product doc = WHAT and WHY. Architecture doc = HOW.
 - These docs are SSOT. Code is implementation detail.

package/assets/slash-commands/init.md

@@ -0,0 +1,34 @@
+---
+name: init
+description: Initialize project docs - create PRODUCT.md and ARCHITECTURE.md
+---
+
+# Init Project Docs
+
+Create project documentation if missing:
+
+1. **Check** if `PRODUCT.md` exists in project root
+   - If missing → Create with structure:
+     - Vision / Mission
+     - Success Metrics (revenue, users, growth)
+     - Target Users
+     - Value Propositions
+     - Key Features
+     - Competitive Landscape
+     - Roadmap (Now / Next / Later)
+
+2. **Check** if `ARCHITECTURE.md` exists in project root
+   - If missing → Create with structure:
+     - Tech Stack (with rationale)
+     - System Design
+     - Key Patterns
+     - Data Models
+     - Integrations
+     - Technical Decisions
+     - Known Limitations
+
+3. **If files exist**, read them and suggest improvements based on current codebase.
+
+**Fill in details** based on what you can learn from the codebase. Ask user for what you can't infer.
+
+Product = WHAT and WHY. Architecture = HOW.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/flow",
-	"version": "2.26.0",
+	"version": "2.28.0",
 	"description": "One CLI to rule them all. Unified orchestration layer for AI coding assistants. Auto-detection, auto-installation, auto-upgrade.",
 	"type": "module",
 	"bin": {

package/src/core/flow-executor.ts

@@ -5,6 +5,9 @@
  */
 
 import chalk from 'chalk';
+import { existsSync } from 'node:fs';
+import fs from 'node:fs/promises';
+import path from 'node:path';
 import type { Target } from '../types/target.types.js';
 import { AttachManager } from './attach-manager.js';
 import { BackupManager } from './backup-manager.js';
@@ -93,7 +96,8 @@ export class FlowExecutor {
       return { joined: true };
     }
 
-    // First session - stash, backup, attach (all silent)
+    // First session - ensure project docs, stash, backup, attach (all silent)
+    await this.ensureProjectDocs(projectPath);
     await this.gitStashManager.stashSettingsChanges(projectPath);
     const backup = await this.backupManager.createBackup(projectPath, projectHash, target);
 
@@ -259,6 +263,28 @@ export class FlowExecutor {
     }
   }
 
+  /**
+   * Ensure PRODUCT.md and ARCHITECTURE.md exist in project root
+   * Creates from templates if missing
+   */
+  private async ensureProjectDocs(projectPath: string): Promise<void> {
+    const templatesDir = this.templateLoader.getAssetsDir();
+    const templates = [
+      { name: 'PRODUCT.md', template: path.join(templatesDir, 'templates', 'PRODUCT.md') },
+      { name: 'ARCHITECTURE.md', template: path.join(templatesDir, 'templates', 'ARCHITECTURE.md') },
+    ];
+
+    for (const { name, template } of templates) {
+      const targetPath = path.join(projectPath, name);
+
+      // Only create if file doesn't exist and template exists
+      if (!existsSync(targetPath) && existsSync(template)) {
+        const content = await fs.readFile(template, 'utf-8');
+        await fs.writeFile(targetPath, content, 'utf-8');
+      }
+    }
+  }
+
   /**
    * Cleanup after execution (silent)
    */