Add SYNC.md — coordination file between HF Claude and Claude Code

SYNC.md

@@ -0,0 +1,113 @@
+# PluginBridge — Sync File (HF Claude ↔ Claude Code)
+> This file keeps both AI instances in sync. Updated by HF Claude after each work session.
+> Claude Code: READ THIS FIRST before doing anything on the project.
+
+---
+
+## Who Does What
+
+| Agent | Role | Scope |
+|---|---|---|
+| **HF Claude** (Hugging Face) | Builds the entire project | All source code, architecture, research, implementation |
+| **Claude Code** (local Mac) | Assists Adi locally | Clone repo, build with Xcode/CMake, test in Ableton, report results back |
+
+**Rule:** HF Claude writes all code and pushes to `RAM2118/pluginbridge`. Claude Code pulls, builds, tests, reports. No duplicate work.
+
+---
+
+## Current Status
+
+**Phase:** Pre-build (research complete, architecture locked)
+**Last updated:** 2026-05-16
+**Next action:** HF Claude scaffolds Sprint 1 source files and pushes to repo
+
+### Completed
+- [x] Deep research on all reference repos (juce-plugin-wrapper, AudioPluginHost, cpp-httplib, LUFSMeter, Sound-Analyser, mcp-servers-jos)
+- [x] Architecture decisions finalized
+- [x] Roadmap refined with concrete code patterns
+- [x] CLAUDE.md context file created
+- [x] Project decisions confirmed (macOS, GPL, Pro-Q 4 + LA-2A, default paths)
+
+### In Progress
+- [ ] Sprint 1: Scaffold CMakeLists.txt + all source files
+- [ ] Sprint 1: Download and add libs (httplib.h, json.hpp)
+- [ ] Sprint 1: Implement empty audio passthrough plugin
+- [ ] Sprint 1: Implement httplib background server
+
+### Not Started
+- [ ] Sprint 2: Plugin hosting (load VST3 by file path)
+- [ ] Sprint 3: MCP JSON-RPC tools
+- [ ] Sprint 4: Audio analysis
+
+---
+
+## What Claude Code Should Do (And NOT Do)
+
+### DO:
+- Pull latest from `https://huggingface.co/RAM2118/pluginbridge`
+- Set up local build environment (JUCE submodule, CMake, Xcode)
+- Build the project and report errors back to Adi
+- Test the built plugin in Ableton
+- Run `curl` tests against the MCP server
+- Report test results so HF Claude can fix issues
+
+### DO NOT:
+- Write new source files (HF Claude does this)
+- Change architecture decisions
+- Add dependencies not listed in ROADMAP.md
+- Refactor code structure
+- Start a sprint that HF Claude hasn't pushed yet
+
+---
+
+## How To Report Issues Back
+
+When Claude Code finds a build error or test failure, Adi should paste this to HF Claude:
+
+```
+BUILD ERROR:
+[paste error here]
+
+FILE: [which file]
+LINE: [if applicable]
+CONTEXT: [what you were trying to do]
+```
+
+HF Claude will fix and push. Claude Code pulls and retests.
+
+---
+
+## Repo Access
+
+```bash
+# Clone (first time)
+git clone https://huggingface.co/RAM2118/pluginbridge
+cd pluginbridge
+
+# Pull latest (after HF Claude pushes updates)
+git pull
+
+# Add JUCE submodule (one time, after first clone)
+git submodule add https://github.com/juce-framework/JUCE.git JUCE
+git submodule update --init
+
+# Build
+mkdir build && cd build
+cmake .. -G Xcode
+cmake --build . --config Release
+
+# Or open in Xcode directly:
+open build/PluginBridge.xcodeproj
+```
+
+---
+
+## Environment Requirements (Claude Code should verify these)
+
+```bash
+xcode-select --version    # need 14+
+cmake --version           # need 3.22+
+brew --version            # for installing cmake if missing
+```
+
+If cmake missing: `brew install cmake`