Sitar118 Claude Sonnet 4.6 commited on
Commit
cc0ab22
·
1 Parent(s): ac96bfc

docs: add two-way message queue to SYNC.md — ML Intern ↔ Claude Code bridge

Browse files

Adds:
- Partnership diagram explaining what each side relies on the other for
- ML INTERN → CLAUDE CODE section: question queue before writing code
- CLAUDE CODE → ML INTERN section: answers + diagnostics after builds
- First message: Sprint 4 regression explanation so ML intern understands what broke

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Files changed (1) hide show
  1. SYNC.md +59 -4
SYNC.md CHANGED
@@ -1,10 +1,32 @@
1
  # PluginBridge — Live Sync File
2
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3
  > **How this file works:**
4
- > ML Intern fills `## NEXT PUSH` BEFORE pushing any code.
5
- > Claude Code reads it, pulls, builds, tests, then fills `## LAST BUILD RESULT`.
6
- > After a successful build, Claude Code moves the push details to `## SPRINT LOG`.
7
- > Neither side should push without reading what the other wrote last.
 
8
 
9
  ---
10
 
@@ -20,6 +42,39 @@
20
 
21
  ---
22
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
23
  ## NEXT PUSH — ML Intern fills this before every push
24
 
25
  > **ML Intern: Before you push anything, fill this section completely.**
 
1
  # PluginBridge — Live Sync File
2
 
3
+ ## THE PARTNERSHIP
4
+
5
+ ```
6
+ ML Intern (HuggingFace) Claude Code (Mac)
7
+ ──────────────────────── ─────────────────
8
+ Researcher + Coder Implementer + Eyes + Hands
9
+ No Mac access No HuggingFace access
10
+ Cannot run or test anything Cannot write research/design
11
+
12
+ ML Intern relies on Claude Code for: Claude Code relies on ML Intern for:
13
+ - Does this API exist in JUCE 8? - What are you building next?
14
+ - Does this compile? - What files will you touch?
15
+ - What does the log say? - What approach are you taking?
16
+ - What's on screen right now? - Why did you choose this design?
17
+ - Is this behavior a Mac quirk?
18
+ ```
19
+
20
+ **Neither side should push or build without reading what the other wrote last.**
21
+
22
+ ---
23
+
24
  > **How this file works:**
25
+ > 1. ML Intern posts questions in `## ML INTERN → CLAUDE CODE` before writing code
26
+ > 2. Claude Code answers in `## CLAUDE CODE → ML INTERN` (tests on Mac, verifies APIs)
27
+ > 3. ML Intern fills `## NEXT PUSH` with exactly what it's about to push
28
+ > 4. Claude Code pulls, builds, tests, fills `## LAST BUILD RESULT`
29
+ > 5. Repeat
30
 
31
  ---
32
 
 
42
 
43
  ---
44
 
45
+ ## ML INTERN → CLAUDE CODE (questions before writing code)
46
+
47
+ > ML Intern: Post questions here BEFORE writing code that touches Mac-specific behavior.
48
+ > Claude Code will test on the Mac and answer below before you proceed.
49
+ > Do not guess — if you're unsure about an API, a path, or a behavior, ask here first.
50
+
51
+ ```
52
+ STATUS: [no pending questions]
53
+ ```
54
+
55
+ ---
56
+
57
+ ## CLAUDE CODE → ML INTERN (answers + diagnostics)
58
+
59
+ > Claude Code posts answers to ML Intern questions here, plus full diagnostics when builds fail.
60
+ > ML Intern: read this section at the start of every coding session.
61
+
62
+ ```
63
+ STATUS: [no pending answers]
64
+
65
+ Last message (2026-05-17):
66
+ The Sprint 4 AudioAnalyser regression was caused by PluginBridgeEditor.mm being
67
+ reverted to the CALayerHost architecture. That approach is documented as a dead end
68
+ in FAILED-APPROACHES #10 — it compiles and runs but never renders in Ableton.
69
+
70
+ The correct architecture is in-process createEditor() — see loadInProcessPlugin()
71
+ in PluginBridgeProcessor.cpp. Do not replace or bypass this function.
72
+
73
+ Fixed files restored from git stash. Build is clean. All tests passing.
74
+ ```
75
+
76
+ ---
77
+
78
  ## NEXT PUSH — ML Intern fills this before every push
79
 
80
  > **ML Intern: Before you push anything, fill this section completely.**