Rewrite SYNC.md for token-efficient Claude Code workflow

SYNC.md

@@ -1,113 +1,52 @@
-# 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.
+# PluginBridge — Sync File
+> HF Claude builds. Claude Code: pull → build → paste error (if any). That's it.
 
 ---
 
-## Who Does What
+## Claude Code Rules (TOKEN EFFICIENT MODE)
 
-| 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
+**Your ENTIRE job is 3 commands:**
+```bash
+cd ~/pluginbridge && git pull
+cd build && cmake --build . --config Release 2>&1 | tail -20
+# If plugin built: load in Ableton, curl localhost:16620/mcp
+```
 
-### 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
+**If build succeeds:** Reply "✅ build ok" — nothing else.
 
----
-
-## How To Report Issues Back
+**If build fails:** Reply with ONLY:
+```
+❌ [filename]:[line] — [one-line error message]
+```
 
-When Claude Code finds a build error or test failure, Adi should paste this to HF Claude:
+Example: `❌ McpServer.cpp:42 — use of undeclared identifier 'httplib'`
 
+**If Ableton test fails:** Reply with ONLY:
 ```
-BUILD ERROR:
-[paste error here]
-
-FILE: [which file]
-LINE: [if applicable]
-CONTEXT: [what you were trying to do]
+⚠️ [what failed] — [one-line description]
 ```
 
-HF Claude will fix and push. Claude Code pulls and retests.
+Example: `⚠️ plugin not visible in Ableton — VST3 not in ~/Library/Audio/Plug-Ins/VST3/`
 
 ---
 
-## Repo Access
+## DO NOT:
+- Explain errors (just paste the line)
+- Suggest fixes (HF Claude fixes)
+- Write code
+- Read source files to understand them
+- Add verbose commentary
+- Ask clarifying questions about the code
 
+## Setup (one time only, then never again):
 ```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 clone https://huggingface.co/RAM2118/pluginbridge ~/pluginbridge
+cd ~/pluginbridge
 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
+mkdir build && cd build && cmake .. -G Xcode
 ```
 
-If cmake missing: `brew install cmake`
+## Status
+**Last push:** 2026-05-16 — repo scaffolded, no source code yet
+**Next push:** Sprint 1 source files (HF Claude will update this line)