v1.2.16 - flow init default to mcp only

Release Date: 2025-10-21

Changes

• • made sure flow init defaults to mcp only

Installation

# Download and run flow.sh
wget https://github.com/khgs2411/flow/releases/download/v1.2.16/flow.sh
chmod +x flow.sh
./flow.sh

v1.2.12 - MCP server improvement

Release Date: 2025-10-20

Changes

• • added some optimizations to the mcp server

Installation

# Download and run flow.sh
wget https://github.com/khgs2411/flow/releases/download/v1.2.12/flow.sh
chmod +x flow.sh
./flow.sh

v1.2.4 - MCP hotfix

Release Date: 2025-10-20

Changes

• • hotfix

Installation

# Download and run flow.sh
wget https://github.com/khgs2411/flow/releases/download/v1.2.4/flow.sh
chmod +x flow.sh
./flow.sh

v1.2.3 - MCP Server

Release Date: 2025-10-20

Changes

• • Added MCP server support

Installation

# Download and run flow.sh
wget https://github.com/khgs2411/flow/releases/download/v1.2.3/flow.sh
chmod +x flow.sh
./flow.sh

v1.2.2 - Adjusted the flow-update-plan command

Release Date: 2025-10-10

Changes

• • The command is now inline with 1.2.1

Installation

# Download and run flow.sh
wget https://github.com/khgs2411/flow/releases/download/v1.2.2/flow.sh
chmod +x flow.sh
./flow.sh

v1.2.1 - Iteration Optimization

Release Date: 2025-10-10

Changes

• • Improved token usage by removing duplicated sections

Installation

# Download and run flow.sh
wget https://github.com/khgs2411/flow/releases/download/v1.2.1/flow.sh
chmod +x flow.sh
./flow.sh

v1.2.0 - Test Infrastructure & Bug Fix

Release Date: 2025-10-06

Changes

• Created pure bash test suite (98 assertions, 3 test suites) with no external dependencies
• Added validate_build.sh (build integrity), validate_commands.sh (command definitions), validate_plan.sh (PLAN.md structure)
• Created test fixtures for edge case testing
• Fixed /flow-next-subject missing Scope Boundary Rule reference
• All quality gates passing - ready for production

Installation

# Download and run flow.sh
wget https://github.com/khgs2411/flow/releases/download/v1.2.0/flow.sh
chmod +x flow.sh
./flow.sh

v1.1.10 - Blueprint/Migrate Command Reference Fix

Release Date: 2025-10-05

Changes

• Fixed /flow-blueprint command to properly reference EXAMPLE_PLAN.md structure
• Fixed /flow-migrate command to properly reference EXAMPLE_PLAN.md structure
• Added verification checklist to ensure all required sections are included
• Added explicit instructions to read both DEVELOPMENT_FRAMEWORK.md and EXAMPLE_PLAN.md
• Ensured commands include all required sections:
  • Progress Dashboard (now REQUIRED, not optional)
  • Testing Strategy (complete with all fields)
  • Changelog section
  • Resolution Type labels (Type A/B/C/D) in brainstorming

What This Fixes

Previously, the AI would sometimes create incomplete plans when using /flow-blueprint or /flow-migrate, missing critical sections like:

• Progress Dashboard
• Testing Strategy details
• Changelog
• Resolution Type labels in brainstorming subjects

Now, both commands have explicit instructions to:

1. Read BOTH DEVELOPMENT_FRAMEWORK.md AND EXAMPLE_PLAN.md
2. Follow EXAMPLE_PLAN.md structure exactly
3. Verify completeness before saving with a self-check checklist

Installation

# Download and run flow.sh
curl -O https://raw.githubusercontent.com/khgs2411/flow/master/flow.sh
chmod +x flow.sh
./flow.sh

Or update existing installation:

./flow.sh --force

Hotfix: Brainstorming Command Behavior

Critical Fix

This hotfix addresses a major issue with /flow-next-subject that was causing AI to auto-complete subjects without user input, creating massive over-engineered solutions instead of facilitating discussion.

Problem: /flow-next-subject Auto-Completing Subjects

When users ran /flow-next-subject, the AI would:

• ❌ Read codebase files extensively
• ❌ Analyze existing implementations in detail
• ❌ Create 336-line architecture documents with interfaces, diagrams, and detailed plans
• ❌ Mark subjects as ✅ resolved without any user discussion
• ❌ Auto-advance through all subjects without user input

Expected Behavior: Facilitate User Discussion

The command should:

• ✅ Present the subject briefly
• ✅ Suggest 2-4 high-level options (NO code research)
• ✅ Ask user for preference
• ✅ STOP and WAIT for user response
• ✅ Document user's decision concisely (10-20 lines, not 336!)

What's Fixed

Step A - Present Subject:

• Added explicit DO NOT read codebase files instruction
• Added explicit DO NOT analyze existing implementation instruction
• Added explicit DO NOT create detailed solutions instruction
• Instruction to keep it brief - just present the topic

Step B - Present Options:

• Added explicit DO NOT research code before presenting options
• Added explicit DO NOT read files to understand current implementation
• Added explicit DO NOT create detailed architecture diagrams instruction
• Changed to suggest high-level options based on GENERAL knowledge only
• Reinforced: STOP and WAIT for user response (do NOT auto-complete)

Step C - Capture Decision:

• Added explicit KEEP DOCUMENTATION CONCISE (1-3 paragraphs, not 336 lines!)
• Added explicit NO massive architecture diagrams unless user provides one
• Added explicit NO detailed implementation plans - save for implementation phase
• Reinforced: Capture only Decision + Rationale + Action Items (brief)

Step D - Document Resolution:

• Added examples showing TOO MUCH vs GOOD documentation
• Example of TOO MUCH: 336 line resolution with interfaces, diagrams, detailed architecture ❌
• Example of GOOD: 10-20 line resolution with decision, rationale, 3-5 action items ✅

Impact

Brainstorming sessions now properly facilitate user-driven discussion instead of AI auto-generating over-engineered solutions. Users maintain control over decisions and the pace of the conversation.

Changes

• Fixed /flow-next-subject auto-completing subjects without user discussion
• Fixed /flow-next-subject creating massive 336-line resolutions instead of concise decisions
• Added explicit DO NOT research/read code instructions to prevent over-engineering
• Brainstorming now properly facilitates user conversation instead of auto-generating solutions

Installation

# Download and run flow.sh
curl -O https://raw.githubusercontent.com/khgs2411/flow/master/flow.sh
chmod +x flow.sh
./flow.sh

Full Changelog: v1.1.7...v1.1.9

Hotfix: Command Behavior Fixes

Critical Fixes

This hotfix addresses three important command behavior issues that were causing incorrect AI behavior:

1. /flow-iteration-add - Progress Dashboard Format Issue

• Problem: Command wasn't properly formatting iteration lists in Progress Dashboard
• Fix: Now references DEVELOPMENT_FRAMEWORK.md lines 2555-2567 for correct format
• Impact: Tasks now properly show all iterations as indented sub-bullets with status

2. /flow-plan-update - Missing Validation

• Problem: Command didn't catch malformed Progress Dashboard iteration lists
• Example: Tasks showing "(3 iterations total)" without actually listing them
• Fix: Added CRITICAL validation section with examples of invalid vs valid formats
• Impact: Running /flow-plan-update now detects and fixes malformed iteration lists

3. /flow-brainstorm-start - Auto-Generation Without User Input

• Problem: When run without arguments, command auto-generated subjects from task description
• Expected: Should ask user for topics, suggest options, and WAIT for response
• Fix: Added explicit MODE 2 instructions with DO NOT auto-generate warnings
• Impact: AI now asks user for topics instead of inventing them

4. Release Script - File Staging Issue

• Problem: Script warned about uncommitted changes it just created
• Fix: Excluded release files from uncommitted check, added framework files to staging
• Impact: Smooth release workflow without manual commits

Changes

• Fixed /flow-iteration-add not listing iterations in Progress Dashboard
• Fixed /flow-plan-update not catching malformed iteration lists
• Fixed /flow-brainstorm-start auto-generating subjects without user input
• Improved release script to handle file staging properly
• Enhanced DEVELOPMENT_FRAMEWORK.md with CRITICAL iteration list format rules

Installation

# Download and run flow.sh
curl -O https://raw.githubusercontent.com/khgs2411/flow/master/flow.sh
chmod +x flow.sh
./flow.sh

Full Changelog: v1.1.4...v1.1.7