From 61267e201e3135e73e9aecaeedefb48196445236 Mon Sep 17 00:00:00 2001 From: diyaa Date: Mon, 14 Sep 2026 22:20:22 +0200 Subject: [PATCH] Document Suno browser handoff decision --- docs/ARCHITECTURE.md | 9 ++++++--- docs/OPEN_QUESTIONS.md | 5 ++++- docs/PRODUCT.md | 14 ++++++++++---- 3 files changed, 20 insertions(+), 8 deletions(-) diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 6fef1e7..61c5bbb 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -84,9 +84,12 @@ and explicitly apply the processed text before any Suno handoff. ## Suno Boundary -The initial requirement is browser/site handoff that fills fields but -does not press Generate. Treat this integration as replaceable because -website UI/behavior can change. +The initial requirement is browser/site handoff to the Suno Create page +in Custom mode. The integration attempts to fill the supported title, +lyrics and style fields but does not press Generate. If a field cannot +be filled, it returns a field-specific result so Presentation can report +it and offer the approved text for copying. Treat this integration as +replaceable because website UI/behavior can change. ## Instrument Selector Boundary diff --git a/docs/OPEN_QUESTIONS.md b/docs/OPEN_QUESTIONS.md index 71873d2..c01fbd5 100644 --- a/docs/OPEN_QUESTIONS.md +++ b/docs/OPEN_QUESTIONS.md @@ -15,7 +15,10 @@ finalized. - Exact list of supported languages/dialects for MVP. - Arabic diacritization policy: full tashkeel vs pronunciation-targeted tashkeel. -- Exact Suno fields to populate and supported handoff mechanism. +- Resolved: Suno handoff opens the browser-based Create page in Custom + mode and attempts to fill title, lyrics and style fields. It never + starts generation. Field-fill failures are reported with the + approved text available for copying. - Whether Suno integration is permitted/reliable under the intended account/workflow and current terms. - Project storage technology and whether cloud sync is required later. diff --git a/docs/PRODUCT.md b/docs/PRODUCT.md index 86f010b..e8485e7 100644 --- a/docs/PRODUCT.md +++ b/docs/PRODUCT.md @@ -19,8 +19,10 @@ instructions for Suno. 4. User reviews and manually edits every generated component. 5. Project versions are saved. 6. User presses **Send to Suno**. -7. The app opens Suno and fills the appropriate fields. It does not - trigger Generate. +7. The app opens the Suno Create page in Custom mode and fills the + supported title, lyrics and style fields. It does not trigger + Generate. If a field cannot be filled, the app reports that result + and keeps its approved text ready for the user to copy. ## Song Controls @@ -92,5 +94,9 @@ Normal users cannot view or modify these rules in the initial version. ## Initial Boundary Suno remains responsible for music generation and playback. The macOS -app prepares the project and fills Suno fields only. Generated songs do -not need to return to the app in the initial version. +app opens the browser-based Suno Create page in Custom mode and fills +the supported title, lyrics and style fields only. It never triggers +Generate. If Suno changes its interface and a field cannot be filled, +the app reports that field and keeps the approved text available to +copy. Generated songs do not need to return to the app in the initial +version.