claude-fsd 1.1.5 → 1.2.0

package/bin/claudefsd

@@ -21,8 +21,8 @@ show_menu() {
     echo "What would you like to do?"
     echo
     echo "  1) Development mode (default) - AI agents work on coding tasks"
-    echo "  2) Planning mode - AI agents help plan your project"
-    echo "  3) Generate initial plan - Create a new project plan from scratch"
+    echo "  2) Analyze brief - Generate questions from project brief"
+    echo "  3) Create plan - Generate requirements and plan from answered questions"
     echo "  4) Exit"
     echo
 }
@@ -43,14 +43,64 @@ if [ $# -eq 0 ]; then
             exec "$(dirname "$0")/claudefsd-dev"
             ;;
         2)
-            echo -e "${GREEN}Starting planning mode...${NC}"
+            echo -e "${GREEN}Analyzing brief and generating questions...${NC}"
             echo
-            exec "$(dirname "$0")/claudefsd-plan"
+            "$(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 before proceeding."
+                echo
+                echo "What editor would you like to use?"
+                echo "  1) nano (default)"
+                echo "  2) vim"
+                echo "  3) code (VS Code)"
+                echo "  4) cursor"
+                echo "  5) other"
+                echo
+                read -p "Enter your choice [1]: " editor_choice
+                editor_choice=${editor_choice:-1}
+                
+                case $editor_choice in
+                    1|"")
+                        nano docs/QUESTIONS.md
+                        ;;
+                    2)
+                        vim docs/QUESTIONS.md
+                        ;;
+                    3)
+                        code docs/QUESTIONS.md
+                        echo "Please answer the questions in VS Code, then press Enter to continue..."
+                        read -n 1 -s
+                        ;;
+                    4)
+                        cursor docs/QUESTIONS.md
+                        echo "Please answer the questions in Cursor, then press Enter to continue..."
+                        read -n 1 -s
+                        ;;
+                    5)
+                        read -p "Enter editor command: " custom_editor
+                        $custom_editor docs/QUESTIONS.md
+                        echo "Please answer the questions, then press Enter to continue..."
+                        read -n 1 -s
+                        ;;
+                    *)
+                        echo -e "${RED}Invalid choice. Please edit docs/QUESTIONS.md manually and run option 3 when ready.${NC}"
+                        exit 1
+                        ;;
+                esac
+                
+                echo
+                echo -e "${GREEN}Now creating plan from answered questions...${NC}"
+                echo
+                exec "$(dirname "$0")/claudefsd-create-plan"
+            fi
             ;;
         3)
-            echo -e "${GREEN}Starting plan generation...${NC}"
+            echo -e "${GREEN}Creating plan from answered questions...${NC}"
             echo
-            exec "$(dirname "$0")/claudefsd-plan-gen"
+            exec "$(dirname "$0")/claudefsd-create-plan"
             ;;
         4)
             echo "Goodbye!"
@@ -68,13 +118,13 @@ else
             shift
             exec "$(dirname "$0")/claudefsd-dev" "$@"
             ;;
-        plan)
+        analyze-brief)
             shift
-            exec "$(dirname "$0")/claudefsd-plan" "$@"
+            exec "$(dirname "$0")/claudefsd-analyze-brief" "$@"
             ;;
-        plan-gen)
+        create-plan)
             shift
-            exec "$(dirname "$0")/claudefsd-plan-gen" "$@"
+            exec "$(dirname "$0")/claudefsd-create-plan" "$@"
             ;;
         *)
             echo -e "${RED}Unknown command: $1${NC}"
@@ -82,9 +132,9 @@ else
             echo "Usage: claudefsd [command]"
             echo
             echo "Commands:"
-            echo "  dev       - Run development mode"
-            echo "  plan      - Run planning mode"
-            echo "  plan-gen  - Generate initial plan"
+            echo "  dev           - Run development mode"
+            echo "  analyze-brief - Analyze brief and generate questions"
+            echo "  create-plan   - Create plan from answered questions"
             echo
             echo "Run without arguments for interactive mode."
             exit 1

package/bin/{claudefsd-plan → claudefsd-analyze-brief}

@@ -30,29 +30,29 @@ echo -e "\033[32m===============================================================
 prompt1="
 Read all of these documents if they exist:
 - BRIEF.md -- the project brief
-- docs/REQUIREMENTS.md -- the project requirements
+- docs/CLAUDE-NOTES.md -- AI's working notes and understanding
 - docs/PLAN.md -- the project plan
 - docs/QUESTIONS.md -- the project questions
 - docs/IDEAS.md -- the backlog of future ideas
 - docs/WEBTESTS.md -- the project web tests
 - README.md -- the project README
 
-Your job, as a megathinking business analyst, project manager, architect and product manager, is to help solidify
-the requirements and plan. 
+Your job, as a megathinking business analyst, is to analyze the project brief and generate clarifying questions.
 
-1. Read through all of these documents and follow any references on the web to read more background.
-2. Add 10 relevant questions to docs/QUESTIONS.md to expand on the brief and requirements.
-3. Create the document docs/QUESTIONS.md if it doesn't exist.
+1. Read through the BRIEF.md and any existing documents to understand the project.
+2. Generate 10-15 relevant questions to clarify ambiguous aspects of the brief.
+3. Create or update docs/QUESTIONS.md with these questions.
+4. Focus on questions that would help an AI developer avoid making incorrect assumptions.
 
-Try to think of typical assumptions an AI or developer would make, and add questions to address them directly.
+Types of questions to include:
+- Technical architecture and platform choices
+- User experience and interface requirements
+- Data requirements and integrations
+- Performance and scalability expectations
+- Security and compliance needs
+- Deployment and operational requirements
 
-As part of this work, please consider our SDLC and what infrastructure will need to be established to ensure
-the system is compliant. Make sure the basics like a git repo and a pre-commit hook that call a custom
-linter are in the plan to be established if they don't exist now. 
-Also make sure our work is being done on a feature branch.
-Other than that, DO NOT get distracted by infrastructure, stick with the YAGNI principle.
-Just ensure the basic branching and linter is working and move on.
-Focus on the user's brief and answers from docs/QUESTIONS.md, and the plan.
+DO NOT answer the questions yourself - just generate them for the user to answer.
 "
 
 # run BA's
@@ -68,13 +68,7 @@ else
 fi
 
 echo -e "\033[32m==================================================================\033[0m"
-echo -e "\033[32m== ANSWER THE QUESTIONS IN QUESTIONS.md\033[0m"
+echo -e "\033[32m== ANALYSIS COMPLETE\033[0m"
 echo -e "\033[32m==================================================================\033[0m"
-
-echo "Press enter to continue..."
-read -n 1 -s
-
-echo "Opening QUESTIONS.md in $EDITOR..."
-$EDITOR QUESTIONS.md
-
-$(dirname "$0")/claudefsd-plan-gen
+echo "Questions have been generated in docs/QUESTIONS.md"
+echo "Please answer these questions before proceeding to create the plan."

package/bin/claudefsd-create-plan

@@ -0,0 +1,83 @@
+#!/bin/bash
+
+set -e
+
+# Check dependencies
+$(dirname "$0")/claudefsd-check-dependencies
+
+mkdir -p logs
+
+# Use a temporary directory for tmp files, as codex is sandboxed to this directory
+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 "
+    exit 1
+fi
+
+if [ ! -f docs/QUESTIONS.md ]; then
+    echo "No docs/QUESTIONS.md file found. Please run 'claudefsd analyze-brief' first to generate questions."
+    exit 1
+fi
+
+LOGFILE="logs/claude-$(date +%Y%m%d_%H%M%S).txt"
+
+echo -e "\033[32m==================================================================\033[0m"
+echo -e "\033[32m== CREATING PLAN FROM ANSWERED QUESTIONS\033[0m"
+echo -e "\033[32m==================================================================\033[0m"
+
+    prompt2="
+Read all of these documents if they exist:
+- BRIEF.md -- 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 (with answers)
+- docs/IDEAS.md -- the backlog of future ideas
+- docs/WEBTESTS.md -- the project web tests
+- README.md -- the project README
+
+Your job, as a megathinking architect and project manager, is to create the project plan and working notes.
+
+1. Read through the BRIEF.md and the answered questions in docs/QUESTIONS.md.
+2. Update or create docs/CLAUDE-NOTES.md with your interpretation and understanding of the project.
+3. Update or create docs/PLAN.md with a detailed implementation plan based on the brief and answered questions.
+
+The CLAUDE-NOTES.md should contain:
+- Your understanding of the project goals and requirements
+- Key technical decisions and rationale
+- Important assumptions and constraints
+- Areas that may need future clarification
+
+The PLAN.md should contain:
+- Ordered list of development tasks with [ ] checkboxes
+- Each task should be specific and actionable
+- Include infrastructure setup (git, linting, testing) as early tasks
+- Group related tasks into logical phases
+
+Ensure the plan includes basic SDLC infrastructure like git repo setup, pre-commit hooks, and linting.
+Use feature branches for development work. Follow YAGNI principle - don't over-engineer.
+"
+
+# run BA's
+echo "Running claude..."
+claude --dangerously-skip-permissions -p "$prompt2" | tee >(cat > $LOGFILE-ba3-$round)
+
+# Only run codex if available
+if command -v codex >/dev/null 2>&1; then
+    echo "Running codex o3 (results won't display)..."
+    codex -m o3 --full-auto -q "$prompt2" > $LOGFILE-ba4-$round
+else
+    echo "Codex not available, skipping o3 analysis" > $LOGFILE-ba4-$round
+fi
+
+echo -e "\033[32m==================================================================\033[0m"
+echo -e "\033[32m== PLAN CREATION COMPLETE\033[0m"
+echo -e "\033[32m==================================================================\033[0m"
+echo "Plan created in docs/PLAN.md"
+echo "Working notes saved in docs/CLAUDE-NOTES.md"
+echo "You can now run 'claudefsd dev' to start the development process."
+
+
+

package/bin/claudefsd-dev

@@ -38,7 +38,7 @@ $MEGATHINKING_MODE
 Read docs/PLAN.md in order and tell me what's the first open task that needs to be 
 done by the developer. Include any context that relates to it , such as sub-bullet 
 points or the section the todo item lives in. 
-Also bring in any related context from BRIEF.md, docs/QUESTIONS.md and docs/REQUIREMENTS.md.
+Also bring in any related context from BRIEF.md, docs/QUESTIONS.md and docs/CLAUDE-NOTES.md.
 Really think this through, as
 the developer will need not just to have blinders on when doing a dev task, but
 also sometimes will need to think about the bigger picture. Particularly if it's
@@ -63,6 +63,12 @@ If the plan is complete, say <ALL DONE>.
     echo -e "\033[32m== RUNNING DEVELOPER TASK\033[0m"
     echo -e "\033[32m==================================================================\033[0m"
 
+    # Show megathinking banner for developer if active
+    if [ $((LOOP_COUNTER % 4)) -eq 0 ]; then
+        echo -e "\033[33m**** MEGATHINKING MODE ACTIVATED ****\033[0m"
+        echo -e "\033[33mThis is your 4th development cycle. Taking a step back for architectural planning.\033[0m"
+    fi
+
     # run the task
     time claude --dangerously-skip-permissions -p "
 $MEGATHINKING_MODE
@@ -156,7 +162,7 @@ Related docs:
 - BRIEF.md
 - docs/PLAN.md
 - docs/QUESTIONS.md
-- docs/REQUIREMENTS.md
+- docs/CLAUDE-NOTES.md
 - README.md
 
 Please review the task and make sure it's complete, and done to satisfaction.
@@ -191,7 +197,7 @@ Related docs:
 - BRIEF.md
 - docs/PLAN.md
 - docs/QUESTIONS.md
-- docs/REQUIREMENTS.md
+- docs/CLAUDE-NOTES.md
 - README.md
 
 Please review the task and uncommitted changes, and make sure the task is complete, and done to satisfaction.

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "claude-fsd",
-  "version": "1.1.5",
+  "version": "1.2.0",
   "description": "Claude Full Stack Development tools for managing development projects",
   "bin": {
     "claude-fsd": "./bin/claude-fsd",
     "claudefsd": "./bin/claudefsd",
     "claudefsd-check-dependencies": "./bin/claudefsd-check-dependencies",
     "claudefsd-dev": "./bin/claudefsd-dev",
-    "claudefsd-plan": "./bin/claudefsd-plan",
-    "claudefsd-plan-gen": "./bin/claudefsd-plan-gen"
+    "claudefsd-analyze-brief": "./bin/claudefsd-analyze-brief",
+    "claudefsd-create-plan": "./bin/claudefsd-create-plan"
   },
   "files": [
     "bin/"

package/bin/claudefsd-plan-gen

@@ -1,73 +0,0 @@
-#!/bin/bash
-
-set -e
-
-# Check dependencies
-$(dirname "$0")/claudefsd-check-dependencies
-
-mkdir -p logs
-
-# Use a temporary directory for tmp files, as codex is sandboxed to this directory
-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 "
-    exit 1
-fi
-
-LOGFILE="logs/claude-$(date +%Y%m%d_%H%M%S).txt"
-
-echo -e "\033[32m==================================================================\033[0m"
-echo -e "\033[32m== PROCESSING THE QUESTIONS IN QUESTIONS.md\033[0m"
-echo -e "\033[32m==================================================================\033[0m"
-
-    prompt2="
-Read all of these documents if they exist:
-- BRIEF.md -- the project brief
-- docs/REQUIREMENTS.md -- the project requirements
-- docs/PLAN.md -- the project plan
-- docs/QUESTIONS.md -- the project questions
-- docs/IDEAS.md -- the backlog of future ideas
-- docs/WEBTESTS.md -- the project web tests
-- README.md -- the project README
-
-Your job, as a megathinking business analyst, project manager, architect and product manager, is to help solidify
-the requirements and plan.
-
-1. Read through these documents and pay particular attention to the questions and answers in QUESTIONS.md.
-2. Update the docs/REQUIREMENTS.md and docs/PLAN.md documents to incorporate the full brief and all answers.
-3. If the requirements and plan don't already exist, create them.
-
-If the brief, questions or answers have been updated, the requirements and plan will need to be updated.
-
-As part of this work, please consider our SDLC and what infrastructure will need to be established to ensure
-the system is compliant. Make sure the basics like a git repo and a pre-commit hook that call a custom
-linter are in the plan to be established if they don't exist now.
-Also make sure our work is being done on a feature branch.
-Other than that, DO NOT get distracted by infrastructure, stick with the YAGNI principle.
-Just ensure the basic branching and linter is working and move on.
-Focus on the user's brief and answers from docs/QUESTIONS.md, and the plan.
-"
-
-# run BA's
-echo "Running claude..."
-claude --dangerously-skip-permissions -p "$prompt2" | tee >(cat > $LOGFILE-ba3-$round)
-
-# Only run codex if available
-if command -v codex >/dev/null 2>&1; then
-    echo "Running codex o3 (results won't display)..."
-    codex -m o3 --full-auto -q "$prompt2" > $LOGFILE-ba4-$round
-else
-    echo "Codex not available, skipping o3 analysis" > $LOGFILE-ba4-$round
-fi
-
-echo -e "\033[32m==================================================================\033[0m"
-echo -e "\033[32m== DONE\033[0m"
-echo -e "\033[32m==================================================================\033[0m"
-echo "You can now run claudefsd-dev to start the development process."
-echo "Or do one more round of claudefsd-plan to cover more questions."
-
-
-