ai-flow-dev 2.4.5 → 2.5.2

package/README.md

@@ -10,7 +10,7 @@ AI Flow is an interactive CLI that creates comprehensive professional documentat
 
 **Key Features:**
 
-- 🚀 Complete professional documentation (Backend: 14 docs, Frontend: 15 docs, Mobile: 13 docs, Fullstack: 30+ docs)
+- 🚀 Complete professional documentation (Backend: 17 files, Frontend: 15 files, Mobile: 13 files, Fullstack: 30+ files)
 - 🧠 **Smart Description Refinement:** Detects ambiguity and iteratively guides you to a professional project definition.
 - ⚡ **Two modes:** Interactive (90-120 min, full control) or Smart Auto-Suggest (15-25 min, 6 questions)
 - 🌍 Universal support - 12 languages, 60+ frameworks, 35+ ORMs (98% coverage)
@@ -40,7 +40,7 @@ Transforma tu idea en un proyecto listo para producción y documentado para IA e
 
 **Características:**
 
-- 🚀 Documentación profesional completa (Backend: 14 docs, Frontend: 15 docs, Mobile: 13 docs, Fullstack: 30+ docs)
+- 🚀 Documentación profesional completa (Backend: 17 archivos, Frontend: 15 archivos, Mobile: 13 archivos, Fullstack: 30+ archivos)
 - 🧠 **Refinamiento Inteligente:** Detecta ambigüedad y te guía iterativamente hacia una descripción profesional.
 - ⚡ **Dos modos:** Interactivo (90-120 min, control total) o Auto-Sugerido (15-25 min, 6 preguntas)
 - 🌍 Soporte universal - 12 lenguajes, 60+ frameworks, 35+ ORMs
@@ -68,7 +68,7 @@ ai-flow init .
 Transforme sua ideia em um projeto pronto para produção e documentado para IA em minutos.
 **Características:**
 
-- 🚀 Documentação profissional completa (Backend: 14, Frontend: 15, Mobile: 13, Fullstack: 30+ docs)
+- 🚀 Documentação profissional completa (Backend: 17 arquivos, Frontend: 15 arquivos, Mobile: 13 arquivos, Fullstack: 30+ arquivos)
 - 🚀 **Modo Agente:** Os assistentes de IA agora priorizam a execução proativa para todos os comandos `/flow-`.
 - 🧠 **Refinamento Inteligente:** Detecta ambiguidade e guia você para uma descrição profissional.
 - ⚡ **Dois modos:** Interactivo (90-120 min, controle total) ou Auto-Sugestão (15-25 min, 6 perguntas)
@@ -108,7 +108,7 @@ The result is interconnected documentation that guides AI assistants and human d
 
 - 🌍 **Universal Support** - 12 languages, 60+ frameworks, 35+ ORMs (98% coverage)
 - 🤖 **AI-Agnostic** - Claude, Copilot, Cursor, Gemini, Antigravity, any AI tool
-- 📚 **Professional Documentation** - Backend: 14, Frontend: 15, Mobile: 13, Fullstack: 30+ docs
+- 📚 **Professional Documentation** - Backend: 17 files, Frontend: 15 files, Mobile: 13 files, Fullstack: 30+ files
 - 🧠 **Smart Description Refinement** - AI detects vague inputs and helps you rich the context (WHO, WHAT, WHY).
 - ⚡ **Two Questionnaire Modes:**
   - **Interactive Mode:** Full control, all phases (90-120 min)
@@ -140,7 +140,7 @@ Or using uv (Python tool manager):
 uv tool install ai-flow-dev
 ```
 
-## **Current version:** 2.4.1
+## **Current version:** 2.5.1
 
 ## 🚀 Quick Start
 
@@ -266,9 +266,9 @@ After initialization, use these slash commands in your AI tool:
 
 > **Note:** Command prefix may vary by AI tool. Examples use `/flow-` (GitHub Copilot), but Claude may use `/` alone, Cursor may use `@`, etc. Check your tool's documentation.
 
-**Backend Projects:** 16 commands  
-**Frontend Projects:** 13 commands  
-**Mobile Projects:** 13 commands  
+**Backend Projects:** 22 prompts (/flow-build with phases 0-10, /flow-work, /flow-check, /flow-commit, /flow-docs-sync)  
+**Frontend Projects:** 22 prompts (same structure tailored for frontend)  
+**Mobile Projects:** 22 prompts (same structure tailored for mobile apps)  
 **Fullstack Projects:** Combined backend + frontend commands
 
 **Documentation & Build:**
@@ -389,13 +389,23 @@ AI Flow organizes your project with clear separation of concerns:
 
 ## 🎯 Generated Documentation
 
-**Backend** (14 docs): AGENT.md, ai-instructions.md, copilot-instructions.md, project-brief.md, plus 8 docs and 2 specs.
+**Backend** (17 files): AGENT.md, ai-instructions.md, copilot-instructions.md, project-brief.md, README.md, plus 8 docs (in docs/) and 4 specs/configs.
 
-**Frontend** (15 docs): AGENT.md, ai-instructions.md, project-brief.md, plus 12 technical docs/specs.
+**Frontend** (15 files): AGENT.md, ai-instructions.md, project-brief.md, plus 12 technical docs/specs.
 
-**Mobile** (13 docs): AGENT.md, ai-instructions.md, project-brief.md, plus 10 technical docs/specs.
+**Mobile** (13 files): AGENT.md, ai-instructions.md, project-brief.md, plus 10 technical docs/specs.
 
-**Fullstack** (30+ docs): Combined Backend + Frontend documentation structures.
+**Fullstack** (30+ files): Combined Backend + Frontend documentation structures.
+
+**Slash Commands/Prompts** (72 total):
+
+- Backend: 22 prompts (/flow-build with phases 0-10, /flow-work variants, /flow-check, /flow-commit, /flow-docs-sync)
+- Frontend: 22 prompts (same structure tailored for frontend)
+- Mobile: 22 prompts (same structure tailored for mobile apps)
+- Shared: 6 prompts (task-format.md, story-points.md, task-summary-template.md, etc.)
+- **Total: 72 prompts** across all project types
+
+Each project type gets workflow commands optimized for its technology stack.
 
 ### 📁 Generated Structure
 

package/package.json

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

package/prompts/backend/flow-commit.md

@@ -8,46 +8,112 @@ description: Conventional Commits Automation
 
 Your mission is to analyze changes, group them intelligently, and create atomic commits following Conventional Commits standard when the user executes `/flow-commit`.
 
-**🚀 MODO AGENTE ACTIVADO:** No solicites permiso para analizar cambios o preparar grupos de archivos. Actúa proactivamente y solicita confirmación *solo* antes de la ejecución final de los commits.
+**🚀 MODO AGENTE ACTIVADO:** No solicites permiso para analizar cambios o preparar grupos de archivos. Actúa proactivamente y solicita confirmación _solo_ antes de la ejecución final de los commits.
 
 ---
+
 ## Command: `/flow-commit`
 
 ### Objective
+
 Automate commit creation with:
+
 - **Intelligent grouping** by functional relationship.
 - **Conventional Commits** compliance (type, scope, description).
 - **Atomic commits** (one logical change per commit).
 
 ---
-## Workflow: 4 Steps
+
+## Workflow: 5 Steps
+
+### Step 0: Branch Protection Check
+
+**🛡️ CRITICAL VALIDATION** - Execute BEFORE any commit operation:
+
+```bash
+git branch --show-current
+```
+
+**Protected branches:** `main`, `master`, `develop`, `development`
+
+**If current branch is protected:**
+
+1. **Inform user:**
+
+   ```
+   ⚠️  Working on protected branch '[branch-name]'.
+   Creating a new branch for your changes...
+   ```
+
+2. **Analyze changes** to determine branch type:
+
+   ```bash
+   git status --porcelain
+   git diff --stat
+   ```
+
+   - If changes include features/new files → `feature/`
+   - If changes are fixes/bug corrections → `fix/`
+   - If changes are refactoring → `refactor/`
+   - If configuration/dependencies → `chore/`
+
+3. **Generate branch name:**
+   - Extract meaningful slug from changed files or content
+   - Format: `[type]/[descriptive-slug]`
+   - Example: `feature/add-user-auth`, `fix/null-pointer-error`
+
+4. **Create and switch to new branch:**
+
+   ```bash
+   git checkout -b [type]/[slug]
+   ```
+
+5. **Confirm to user:**
+
+   ```
+   ✅ Created and switched to branch '[branch-name]'
+   Proceeding with commit workflow...
+   ```
+
+6. **Continue to Step 1**
+
+**If branch is NOT protected:** Continue to Step 1.
 
 ### Step 1: Detect Changes
+
 - Modified files (unstaged/staged).
 - **Untracked files** (`git status --porcelain`).
 - Deleted files.
 
 ### Step 2: Intelligent Grouping
+
 Group files by:
+
 - **Feature Complete**: Entity + Service + Controller + Tests + Docs.
 - **Refactoring**: Helper + Tests + Usages.
 - **Configuration**: Docker, Env, CI/CD.
 - **Independent Tests/Docs**.
 
 ### Step 3: Create Commits
+
 1. Generate Conventional Commit message.
 2. `git add [files] && git commit -m "[message]"`.
 3. **Wait for user confirmation.**
 
-### Step 4: Summary & Push
+### Step 5: Summary & Push
+
 - Show `git log` of new commits.
 - Suggest `git push origin [branch]`.
+- **NEVER suggest push to protected branches** (main, master, develop, development).
 
 ---
+
 ## Integration with `status.json`
+
 - Update `git.commits` array.
 - Set `git.uncommittedChanges: false` when done.
 - Update `finalChecklist.committed: true`.
 
 ---
+
 **BEGIN EXECUTION when user runs `/flow-commit`**

package/prompts/backend/flow-work-feature.md

@@ -7,42 +7,55 @@ description: Internal logic for Feature implementation within flow-work
 This file contains the detailed execution logic for implementing new features, imported by `@flow-work.md`.
 
 ---
+
 ## 🚀 Feature Implementation Flow
 
 ### 1. Context Analysis (auto-skip if User Story with detailed tasks)
+
 - Extract requirements from User Story or Roadmap
 - If User Story has detailed tasks: Skip to work.md generation
 - If Roadmap or Manual: Analyze and refine
 - Read relevant documentation (ai-instructions.md, architecture.md, etc.)
 
 ### 2. work.md Generation
+
 - Generate consolidated work.md (see Phase 2 in flow-work.md)
 - Include: Context, Objective, Constraints, Approach, Tasks, Validation
 - **User Confirmation Required**
 
 ### 3. Progressive Implementation
+
 Choose mode:
+
 - **Auto**: Complete all tasks without pausing
 - **Phase-by-phase**: Pause and validate after each phase
 - **Task-by-task**: Pause after each task
 
 Follow tasks in `work.md`:
+
 - Update checkboxes as completed
 - Update `status.json` progress
 - Follow patterns and constraints specified
 
 ### 4. Definition of Done (DoD)
+
 - If HU mode: Validate against Gherkin scenarios
 - Run tests and linting
 - Perform security check
 - **Update completion status** in source documents (see Phase 4 in flow-work.md)
 
 ---
+
 ## 🌿 Git Branching Strategy
+
 - Generate slug from name
 - Execute `git checkout -b feature/[slug]`
+- **Note:** Creating feature branches FROM `main`/`master`/`develop`/`development` is correct workflow
+- **Never commit directly TO protected branches** - always work on feature branch
 - Maintain `status.json` with commit history
 
 ---
+
 ## 📦 status.json Persistence
+
 Ensure `progress`, `git`, and `metadata` sections are always updated.

package/prompts/backend/flow-work-fix.md

@@ -7,13 +7,16 @@ description: Internal logic for Bug Fixes within flow-work
 This file contains the detailed execution logic for bug fixes, imported by `@flow-work.md`.
 
 ---
+
 ## 🔧 Bug Fix Workflow
 
 ### 1. Classification
+
 - **QUICK**: 1 file, obvious cause (typo, null check)
 - **COMPLEX**: Multiple files, investigation needed
 
 ### 2. Analysis & work.md Generation
+
 - **QUICK**: Minimal work.md (objective + 1-2 tasks)
 - **COMPLEX**: Full work.md with root cause analysis
   - Document root cause in Objective section
@@ -21,16 +24,23 @@ This file contains the detailed execution logic for bug fixes, imported by `@flo
   - Generate detailed tasks
 
 ### 3. Implementation
+
 - **Test-First Approach**: Add failing test that reproduces bug
 - Apply the fix following work.md tasks
 - Verify tests pass
 - **Update completion status** if fix was tracked in roadmap/user stories (see Phase 4 in flow-work.md)
 
 ---
+
 ## 🌿 Git Branching Strategy
+
 - **QUICK**: Usually work on current branch
+  - ⚠️ **Exception:** If on protected branch (`main`, `master`, `develop`, `development`), create fix branch even for quick fixes
 - **COMPLEX**: Execute `git checkout -b fix/[slug]`
+- **Never commit directly TO protected branches**
 
 ---
+
 ## 📦 status.json Persistence
+
 Track root cause details and verification test status.

package/prompts/backend/flow-work-refactor.md

@@ -7,9 +7,11 @@ description: Internal logic for Refactor implementation within flow-work
 This file contains the detailed execution logic for code refactoring, imported by `@flow-work.md`.
 
 ---
+
 ## 🔄 Refactoring Workflow
 
 ### 1. Scope Identification & work.md Generation
+
 - Map affected files and dependencies
 - Confirm no behavior change expected
 - Validate against architecture patterns
@@ -20,19 +22,27 @@ This file contains the detailed execution logic for code refactoring, imported b
   - "No behavior change" constraint
 
 ### 2. Implementation
+
 - Follow work.md tasks sequentially
 - Update imports and references across codebase
 - **Critical**: Existing tests must pass without modification (unless test itself is refactored)
 
 ### 3. Validation
+
 - Run `/flow-check` to verify no regressions
 - Confirm all tests pass
 - **Update completion status** if refactor was tracked in roadmap/user stories (see Phase 4 in flow-work.md)
 
 ---
+
 ## 🌿 Git Branching Strategy
+
 - Execute `git checkout -b refactor/[slug]`
+- **Note:** Creating refactor branches FROM `main`/`master`/`develop`/`development` is correct
+- **Never commit directly TO protected branches**
 
 ---
+
 ## 📦 status.json Persistence
+
 Track `percentage` of updated occurrences and updated file paths.