MAX-MSP_CC_Framework: Command for Claude Code

/max-iterate

Apply modifications to existing .maxpat patches using the analyze-first protocol. Reads the patch, shows a structural analysis, then makes surgical or section-level edits while preserving all existing objects and user positioning.

Behavior

1. Parse arguments for inline project switch -- before loading the active project, check if the first word of the argument string matches an existing project:

   from src.maxpat.project import get_active_project, set_active_project, list_projects, update_status, bump_version
   
   projects = list_projects(base_dir)
   args = user_input.strip()
   first_word = args.split()[0] if args else ""
   
   # Case-insensitive match against known project directories
   matched_project = None
   for p in projects:
       if p.lower() == first_word.lower():
           matched_project = p
           break
   
   if matched_project:
       set_active_project(matched_project, base_dir)
       change_description = " ".join(args.split()[1:])  # remaining text
   else:
       change_description = args  # entire string is the description
   

2. Parse flags -- extract workflow flags from the argument string before interpreting the change description:

   • Scan change_description (the text remaining after inline project switch parsing) for --full, --discuss, --research, --plan and --fix
   • --full expands to all three: discuss + research + plan
   • --discuss, --research, --plan can be used individually or combined
   • --fix switches to Quick-fix mode (see "Quick-fix mode (--fix)" below) instead of steps 6-18
   • Strip all recognized flags from change_description so downstream steps see only the modification text
   • Store flags as booleans: do_discuss, do_research, do_plan, do_fix

3. Load active project -- read patches/.active-project.json for the current project (which may have just been set by the step above). If no active project, prompt the user.

4. Auto-detect target .maxpat -- determine which patch file to edit:

   • Single .maxpat in generated/: use it automatically
   • Multiple .maxpat files: infer from the user's change description (match keywords to filenames)
   • Ambiguous: ask the user which file to edit