claude-fsd 1.4.9 → 1.5.1

package/bin/claudefsd

@@ -25,16 +25,18 @@ save_editor_preference() {
 
 # Function to determine default choice based on existing docs
 get_default_choice() {
-    if [ ! -f BRIEF.md ]; then
+    # Use find_brief_file function to check for BRIEF.md
+    source "$(dirname "$0")/claudefsd-find-brief"
+    if ! find_brief_file >/dev/null 2>&1; then
         echo "0"
     elif [ ! -f docs/REQUIREMENTS.md ] && [ ! -f docs/QUESTIONS.md ]; then
-        echo "1"  # Interactive interview (recommended)
+        echo "1"  # Interactive interview
     elif [ -f docs/REQUIREMENTS.md ] && [ ! -f docs/PLAN.md ]; then
-        echo "3"  # Create plan from requirements
+        echo "2"  # Create plan from requirements
     elif [ -f docs/QUESTIONS.md ] && [ ! -f docs/PLAN.md ]; then
-        echo "3"  # Create plan from questions
+        echo "2"  # Create plan from questions
     else
-        echo "4"  # Development mode
+        echo "3"  # Development mode
     fi
 }
 
@@ -50,7 +52,9 @@ show_menu() {
     
     local default_choice=$(get_default_choice)
     
-    if [ ! -f BRIEF.md ]; then
+    # Check for BRIEF.md using find_brief_file
+    source "$(dirname "$0")/claudefsd-find-brief"
+    if ! find_brief_file >/dev/null 2>&1; then
         echo "  0) Create project brief - Start your project with a BRIEF.md file"
     fi
     
@@ -58,32 +62,38 @@ show_menu() {
     if [ -f docs/INTERVIEW-SESSION.json ]; then
         local session_status=$(jq -r '.status' docs/INTERVIEW-SESSION.json 2>/dev/null || echo "unknown")
         if [ "$session_status" = "in_progress" ]; then
-            echo "  1) Interactive interview - Resume existing interview session"
+            echo "  1) Interview - Resume existing interview session"
         else
-            echo "  1) Interactive interview - Gather requirements through expert Q&A"
+            echo "  1) Interview - Gather requirements through expert Q&A"
         fi
     else
-        echo "  1) Interactive interview - Gather requirements through expert Q&A [RECOMMENDED]"
+        echo "  1) Interview - Gather requirements through expert Q&A"
     fi
     
-    echo "  2) Batch questions - Generate all questions at once (alternative to interview)"
-    
     # Show create plan option based on what exists
     if [ -f docs/REQUIREMENTS.md ]; then
-        echo "  3) Create plan - Generate development plan from requirements"
+        echo "  2) Create plan - Generate development plan from requirements"
     elif [ -f docs/QUESTIONS.md ]; then
-        echo "  3) Create plan - Generate plan from answered questions"
+        echo "  2) Create plan - Generate plan from answered questions"
     else
-        echo "  3) [Requires interview or questions first]"
+        echo "  2) [Requires interview first]"
     fi
     
-    echo "  4) Development mode - AI agents work on coding tasks"
-    echo "  5) Exit"
+    echo "  3) Development - Choose development approach:"
+    echo "    3a) Direct execution - Single-context parallel agents (small-medium projects)"
+    echo "    3b) Iterative development - Multi-cycle planning loop (large projects)"
+    echo "  4) Exit"
     echo
     
     # Show status of required files
     echo "Current status:"
-    [ -f BRIEF.md ] && echo "  ✓ BRIEF.md exists" || echo "  ✗ BRIEF.md missing"
+    source "$(dirname "$0")/claudefsd-find-brief"
+    local brief_file=$(find_brief_file 2>/dev/null || echo "")
+    if [ -n "$brief_file" ]; then
+        echo "  ✓ $brief_file exists"
+    else
+        echo "  ✗ BRIEF.md missing"
+    fi
     
     # Show interview session status if exists
     if [ -f docs/INTERVIEW-SESSION.json ]; then
@@ -190,27 +200,29 @@ if [ $# -eq 0 ]; then
     
     case $choice in
         0)
-            if [ ! -f BRIEF.md ]; then
+            # Create BRIEF.md in docs/ directory (preferred location)
+            if ! find_brief_file >/dev/null 2>&1; then
                 echo -e "${GREEN}Creating project brief...${NC}"
                 echo
-                echo "# Project Brief" > BRIEF.md
-                echo "" >> BRIEF.md
-                echo "## Vision" >> BRIEF.md
-                echo "Describe the big picture vision and what you want to achieve..." >> BRIEF.md
-                echo "" >> BRIEF.md
-                echo "## Core Requirements" >> BRIEF.md
-                echo "- Core requirement 1" >> BRIEF.md
-                echo "- Core requirement 2" >> BRIEF.md
-                echo "" >> BRIEF.md
-                echo "## Key Features" >> BRIEF.md
-                echo "- Feature 1" >> BRIEF.md
-                echo "- Feature 2" >> BRIEF.md
-                echo "" >> BRIEF.md
-                echo "## Success Criteria" >> BRIEF.md
-                echo "- Success criterion 1" >> BRIEF.md
-                echo "- Success criterion 2" >> BRIEF.md
+                mkdir -p docs
+                echo "# Project Brief" > docs/BRIEF.md
+                echo "" >> docs/BRIEF.md
+                echo "## Vision" >> docs/BRIEF.md
+                echo "Describe the big picture vision and what you want to achieve..." >> docs/BRIEF.md
+                echo "" >> docs/BRIEF.md
+                echo "## Core Requirements" >> docs/BRIEF.md
+                echo "- Core requirement 1" >> docs/BRIEF.md
+                echo "- Core requirement 2" >> docs/BRIEF.md
+                echo "" >> docs/BRIEF.md
+                echo "## Key Features" >> docs/BRIEF.md
+                echo "- Feature 1" >> docs/BRIEF.md
+                echo "- Feature 2" >> docs/BRIEF.md
+                echo "" >> docs/BRIEF.md
+                echo "## Success Criteria" >> docs/BRIEF.md
+                echo "- Success criterion 1" >> docs/BRIEF.md
+                echo "- Success criterion 2" >> docs/BRIEF.md
                 
-                open_with_editor "BRIEF.md"
+                open_with_editor "docs/BRIEF.md"
                 echo
                 echo -e "${GREEN}Brief created! Run claudefsd again to start the interview.${NC}"
             else
@@ -220,49 +232,46 @@ if [ $# -eq 0 ]; then
             ;;
         1)
             # Interactive interview
-            if [ ! -f BRIEF.md ]; then
+            source "$(dirname "$0")/claudefsd-find-brief"
+            local brief_file=$(find_brief_file 2>/dev/null || echo "")
+            if [ -z "$brief_file" ]; then
                 echo -e "${RED}No BRIEF.md found. Please create a project brief first.${NC}"
                 exit 1
             fi
-            echo -e "${GREEN}Starting interactive interview...${NC}"
+            echo -e "${GREEN}Starting interview...${NC}"
             echo
             exec "$(dirname "$0")/claudefsd-interview"
             ;;
         2)
-            # Batch questions
-            echo -e "${GREEN}Analyzing brief and generating questions (batch mode)...${NC}"
-            echo
-            "$(dirname "$0")/claudefsd-analyze-brief"
-            
-            if [ $? -eq 0 ]; then
-                echo
-                echo -e "${GREEN}Questions generated in docs/QUESTIONS.md${NC}"
-                echo "Please answer the questions, then run claudefsd again to create the plan."
-                echo
-                
-                open_with_editor "docs/QUESTIONS.md"
-                
-                echo
-                echo -e "${GREEN}Questions saved. After answering them, run 'claudefsd' again and select option 3 to create the plan.${NC}"
-            fi
-            ;;
-        3)
             # Create plan - check what source to use
             if [ -f docs/REQUIREMENTS.md ] || [ -f docs/QUESTIONS.md ]; then
                 echo -e "${GREEN}Creating plan from project inputs...${NC}"
                 echo
                 exec "$(dirname "$0")/claudefsd-create-plan"
             else
-                echo -e "${RED}No requirements or questions found. Please run the interview or generate questions first.${NC}"
+                echo -e "${RED}No requirements or questions found. Please run the interview first.${NC}"
                 exit 1
             fi
             ;;
-        4)
-            echo -e "${GREEN}Starting development mode...${NC}"
+        3)
+            # Auto-detect development mode
+            echo -e "${GREEN}Auto-detecting development approach...${NC}"
             echo
             exec "$(dirname "$0")/claudefsd-dev"
             ;;
-        5)
+        3a)
+            # Direct execution mode
+            echo -e "${GREEN}Starting direct execution mode...${NC}"
+            echo
+            exec "$(dirname "$0")/claudefsd-dev" direct
+            ;;
+        3b)
+            # Iterative development mode
+            echo -e "${GREEN}Starting iterative development mode...${NC}"
+            echo
+            exec "$(dirname "$0")/claudefsd-dev" iterative
+            ;;
+        4)
             echo "Goodbye!"
             exit 0
             ;;
@@ -282,24 +291,36 @@ else
             shift
             exec "$(dirname "$0")/claudefsd-dev" "$@"
             ;;
-        analyze-brief)
-            shift
-            exec "$(dirname "$0")/claudefsd-analyze-brief" "$@"
-            ;;
         create-plan)
             shift
             exec "$(dirname "$0")/claudefsd-create-plan" "$@"
             ;;
+        dev-direct)
+            # Direct CLI access to direct mode
+            shift
+            exec "$(dirname "$0")/claudefsd-dev" direct "$@"
+            ;;
+        dev-iterative)
+            # Direct CLI access to iterative mode
+            shift
+            exec "$(dirname "$0")/claudefsd-dev" iterative "$@"
+            ;;
+        dev-mini)
+            # Legacy support - redirect to direct mode
+            shift
+            exec "$(dirname "$0")/claudefsd-dev" direct "$@"
+            ;;
         *)
             echo -e "${RED}Unknown command: $1${NC}"
             echo
             echo "Usage: claudefsd [command]"
             echo
             echo "Commands:"
-            echo "  interview     - Interactive requirements gathering"
-            echo "  analyze-brief - Analyze brief and generate questions (legacy)"
-            echo "  create-plan   - Create plan from requirements or questions"
-            echo "  dev|run       - Run development mode"
+            echo "  interview      - Interactive requirements gathering"
+            echo "  create-plan    - Create plan from requirements or questions"
+            echo "  dev|run        - Run development mode (auto-detects approach)"
+            echo "  dev-direct     - Force direct execution mode"
+            echo "  dev-iterative  - Force iterative development mode"
             echo
             echo "Run without arguments for interactive mode."
             exit 1

package/bin/claudefsd-analyze-brief

@@ -9,9 +9,11 @@ mkdir -p logs
 mkdir -p tmp
 export TMPDIR=tmp/
 
-# look for a brief file
-if [ ! -f BRIEF.md ]; then
-    echo "No BRIEF.md file found, please create one first "
+# look for a brief file (prefer docs/BRIEF.md, fallback to BRIEF.md)
+source "$(dirname "$0")/claudefsd-find-brief"
+BRIEF_FILE=$(find_brief_file)
+if [ $? -ne 0 ]; then
+    echo "No BRIEF.md file found in docs/ or root directory, please create one first"
     exit 1
 fi
 
@@ -27,7 +29,7 @@ echo -e "\033[32m===============================================================
 
 prompt1="
 Read all of these documents if they exist:
-- BRIEF.md -- the project brief
+- $BRIEF_FILE -- the project brief
 - docs/CLAUDE-NOTES.md -- AI's working notes and understanding
 - docs/PLAN.md -- the project plan
 - docs/QUESTIONS.md -- the project questions

package/bin/claudefsd-analyze-brief-personas

@@ -34,8 +34,11 @@ fi
 mkdir -p docs
 mkdir -p logs
 
-if [ ! -f BRIEF.md ]; then
-    echo "No BRIEF.md file found, please create one first"
+# look for a brief file (prefer docs/BRIEF.md, fallback to BRIEF.md)
+source "$(dirname "$0")/claudefsd-find-brief"
+BRIEF_FILE=$(find_brief_file)
+if [ $? -ne 0 ]; then
+    echo "No BRIEF.md file found in docs/ or root directory, please create one first"
     exit 1
 fi
 
@@ -50,7 +53,7 @@ coordinator_prompt="
 You are a Project Manager analyzing a software project brief to determine which experts should contribute questions.
 
 === PROJECT BRIEF ===
-$(cat BRIEF.md)
+$(cat "$BRIEF_FILE")
 
 === INSTRUCTIONS ===
 Analyze the project and list which expert personas should ask questions.
@@ -144,7 +147,7 @@ for persona in "${PERSONA_ARRAY[@]}"; do
 You are a $display_name analyzing a software project brief.
 
 === PROJECT BRIEF ===
-$(cat BRIEF.md)
+$(cat "$BRIEF_FILE")
 
 === INSTRUCTIONS ===
 Generate 3-5 essential questions that a $display_name would need answered to successfully contribute to this project.

package/bin/claudefsd-create-plan

@@ -11,9 +11,11 @@ mkdir -p logs
 mkdir -p tmp
 export TMPDIR=tmp/
 
-# look for required files
-if [ ! -f BRIEF.md ]; then
-    echo "No BRIEF.md file found, please create one first "
+# look for required files (prefer docs/BRIEF.md, fallback to BRIEF.md)
+source "$(dirname "$0")/claudefsd-find-brief"
+BRIEF_FILE=$(find_brief_file)
+if [ $? -ne 0 ]; then
+    echo "No BRIEF.md file found in docs/ or root directory, please create one first"
     exit 1
 fi
 
@@ -33,7 +35,7 @@ echo -e "\033[32m===============================================================
 
     prompt2="
 Read all of these documents if they exist:
-- BRIEF.md -- the project brief
+- $BRIEF_FILE -- the project brief
 - docs/QUESTIONS.md -- the project questions (with answers) from analyze-brief or interview
 - docs/REQUIREMENTS.md -- consolidated requirements from interview process
 - docs/CLAUDE-NOTES.md -- AI's working notes and understanding
@@ -89,7 +91,7 @@ if command -v codex >/dev/null 2>&1; then
     o3_prompt="You are an elite software architect and strategic planner using o3-pro's advanced reasoning capabilities.
 
 CONTEXT DOCUMENTS:
-$([ -f BRIEF.md ] && echo "=== PROJECT BRIEF ===" && cat BRIEF.md && echo "")
+$([ -f "$BRIEF_FILE" ] && echo "=== PROJECT BRIEF ===" && cat "$BRIEF_FILE" && echo "")
 $([ -f docs/QUESTIONS.md ] && echo "=== QUESTIONS & ANSWERS ===" && cat docs/QUESTIONS.md && echo "")
 $([ -f docs/REQUIREMENTS.md ] && echo "=== CONSOLIDATED REQUIREMENTS ===" && cat docs/REQUIREMENTS.md && echo "")
 $([ -f docs/INTERVIEW-SESSION.json ] && echo "=== INTERVIEW METADATA ===" && cat docs/INTERVIEW-SESSION.json && echo "")