AnswersPublished14 sources
v4.3 non si fa cambiando un’etichetta: cosa manca al repository per essere pronto
La proposta è usare versioni pubbliche a due componenti, come v4.3, mantenendo V4 come identità interna e una sola fonte per il numero di versione. La revisione non ha modificato il repository, cancellato file, eseguito test né effettuato distribuzioni: non certifica quindi una release v4.3 pronta.
Pubblicato daImmagini generate con GPT Image 2
Research answer
Key takeaways
- La proposta è usare versioni pubbliche a due componenti, come v4.3, mantenendo V4 come identità interna e una sola fonte per il numero di versione.
- La revisione non ha modificato il repository, cancellato file, eseguito test né effettuato distribuzioni: non certifica quindi una release v4.3 pronta.
- Installazione e distribuzione hanno già alcune protezioni, ma restano da verificare la fonte degli aggiornamenti, i riferimenti dopo l’installazione e i controlli CI.
- Cline, Roo e Gemini CLI richiedono adattamenti e verifiche specifiche: la presenza di file nel repository non dimostra che siano caricati correttamente dall’host.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/JRtyWXL5XMODkxxCStM9mCCPWvd2/images/A169BDCC1EF49A4CC481/92E7045358C209E36272.png)
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"建议将本仓库对外版本统一为 v4.3，采用轻量发布管理；但目前不能认定工作树已经是“干净且完整可部署的 v4.3”。本轮完成的是只读审查，没有更新仓库、修改版本、删除历史、运行测试或执行部署。\n\n 版本与历史清理\n\n 对外使用 v4.3、v4.4 这样的两段版本；内部套件身份继续保留 V4，不必为了展示版. Topic tags: general web, llm, agents, ai, automation. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts wit
Una versione più semplice può alleggerire la manutenzione, ma non rende da sola un progetto pronto al rilascio. È questa la conclusione della revisione in sola lettura del repository: adottare v4.3 come versione pubblica, senza trasformare la pulizia delle etichette in una certificazione di distribuzione.
La verifica non ha aggiornato il codice, cambiato versioni, rimosso file, eseguito test né distribuito il progetto. Perciò, allo stato attuale, non ci sono elementi per definirlo un «v4.3 pulito e pronto».
Una versione pubblica semplice, una sola fonte ufficiale
La raccomandazione è passare a numeri pubblici a due componenti — per esempio v4.3 e v4.4 — conservando V4 come identità interna del pacchetto. Non servono una ristrutturazione delle cartelle o una riscrittura della cronologia: serve invece un’unica fonte della versione, da cui possano dipendere documentazione, istruzioni d’installazione e verifiche CI.
Oggi il README indica ancora v4.2.0 (README.md:3), mentre il punto d’ingresso del progetto parla di V4.2 (bmad-suite-v4/skills/bmad/SKILL.md:11). La mappatura delle versioni riconosce V4, ma non offre una fonte condivisa per la versione minore (scripts/suite_versions.py:28). Inoltre, la revisione non ha potuto verificare il rapporto tra il tag remoto v4.3 e il commit locale: aggiornare un badge non basterebbe a dimostrare che siano allineati.
Anche la pulizia delle vecchie versioni richiede cautela. La cache .versions/v4.0.0/ è stata individuata come possibile candidata alla rimozione, ma prima andrebbero escluse dipendenze da installazioni o collegamenti esistenti. Al contrario, la directory verification/legacy-bmad-output/ è citata in un ADR (docs/adrs/ADR-20261012-bmad-solo-anti-bureaucracy-and-programmatic-guards.md:232); _bmad-solo-source/legacy-skills/ contiene materiali utili per ricostruire la provenienza delle skill. Non sono quindi da trattare automaticamente come scarti.
Installazione: alcune protezioni ci sono, ma manca una verifica completa
Gli strumenti già adottano salvaguardie importanti: install.sh:50 rifiuta di sovrascrivere un albero di lavoro con modifiche non salvate; bs.sh:298 richiede un aggiornamento fast-forward e trasferisce il controllo al nuovo script; il coordinatore scripts/deploy-managed-cli.py:104 verifica i conflitti prima di scrivere. Semplificare i numeri di versione non dovrebbe indebolire queste protezioni.
Restano però dei vuoti. L’installatore (install.sh:14) accetta parametri di compatibilità V4, ma non inoltra opzioni per scegliere l’host, fare un controllo preliminare in sola lettura o indicare la modalità di destinazione. I requisiti sono descritti nel README, senza un controllo uniforme delle dipendenze nell’installazione (README.md:30). Inoltre, il percorso di aggiornamento usa il repository remoto configurato (bs.sh:305), ma la revisione non ha trovato una verifica che confermi che si tratti ancora della fonte attesa.
La divisione consigliata è semplice: l’installatore verifica la fonte e i prerequisiti, poi passa il controllo; lo strumento di distribuzione gestisce adattamento all’host, controlli, aggiornamenti, disinstallazione e protezione dei file dell’utente.
CI: le regole per v4.3 non sono ancora applicate
Il workflow attuale (.github/workflows/ci.yml:3) si attiva sui push al ramo principale e sulle richieste di integrazione, ma non sulle etichette di release. I controlli dei plugin verificano struttura e nomi, non il formato della versione (.github/workflows/ci.yml:41). Anche il validatore delle etichette si limita agli indizi sulla versione principale; i test consentono versioni a tre componenti e tag non di versione (scripts/suite_versions.py:99, tests/roo_distribution/test_suite_versions.py:80). Non è quindi corretto dire che il progetto applichi già la convenzione a due componenti.
Tra i controlli suggeriti: accettare per le nuove release tag nel formato v4.numero, confrontarli con la fonte ufficiale della versione e verificare che la documentazione mostri lo stesso numero. Non è necessario riscrivere la cronologia né applicare la regola alle versioni delle dipendenze esterne.
La CI dovrebbe inoltre eseguire il validatore del pacchetto skill, già presente (bmad-suite-v4/skills/bmad/scripts/validate-solo-package.py:5) ma non richiamato dal workflow attuale. La verifica dovrebbe considerare anche i riferimenti dopo l’installazione, non soltanto quelli nel repository.
Skill upstream: adattate in locale, non aggiornate in tempo reale
Dai percorsi esaminati emerge che le procedure locali puntano alle skill del pacchetto; la mappatura di distribuzione raccoglie la suite, non la directory storica delle skill upstream (bmad-suite-v4/skills/bmad/references/capability-map.md:3, scripts/deployment_source.py:64). Nelle parti di codice esaminate non è stata trovata una catena attiva che rilevi o aggiorni automaticamente le skill upstream.
Questo significa che le procedure upstream non sono una dipendenza diretta in esecuzione degli ingressi locali esaminati. Significa anche, però, che un aggiornamento a monte non aggiorna automaticamente le procedure estratte e adattate: il rischio è la divergenza nel tempo. Non basta copiare singoli file per riattivare le skill storiche: quella di aiuto dipende anche da configurazione, inventario delle cartelle e parser (_bmad-solo-source/legacy-skills/bmad-help/SKILL.md:25); quella di build richiede un programma di rendering (_bmad-solo-source/legacy-skills/bmad-build-auto/SKILL.md:6).
L’approccio proposto è mantenere stabili gli ingressi locali e integrare le skill upstream autorizzate in base alle capacità effettivamente richieste. Per ogni aggiornamento andrebbero registrati commit di provenienza e risorse necessarie, verificando differenze, rimozioni e dipendenze prima della sostituzione. Il rilevamento degli aggiornamenti può essere separato dall’aggiornamento automatico: controlli durante installazione o aggiornamento e, se utile, notifiche periodiche, senza un monitoraggio in background obbligatorio.
Cline, Roo e Gemini: servono adattamenti specifici per ciascun host
Cline mette a disposizione sia una CLI sia un’estensione per l’editor 4. La documentazione distingue inoltre configurazioni globali e di progetto
1. Nel repository, però, è presente solo un modello di instradamento non attivo (
bmad-suite-v4/cline/templates/bmad-router.md:3): i test di distribuzione richiedono esplicitamente che non venga scritto negli ingressi attivi di Cline (tests/roo_distribution/test_host_adaptation.py:85). La proposta è usare contenuti metodologici condivisi, con adattamenti sottili e distinti per CLI e plugin, mappando le attività sulle modalità Plan e Act di Cline. I percorsi del modello, inoltre, sono riferiti alla radice del repository: andrebbero risolti di nuovo durante la distribuzione in un altro progetto (bmad-suite-v4/cline/templates/bmad-router.md:8).
Per Roo, la presenza di regole globali e modalità selezionate nella mappatura non dimostra che l’host le abbia caricate. La revisione segnala anche una discrepanza da affrontare: le due modalità personalizzate non dichiarano autorizzazioni MCP, mentre il validatore fissa i gruppi di permessi (bmad-suite-v4/roo/settings/custom_modes.yaml:5, scripts/validate-roo-contracts.py:158). Integrare uno strumento di distillazione richiederebbe quindi di controllare sia la configurazione sia i validatori che la consumano.
Per Gemini CLI, la distribuzione esaminata copia fisicamente directory di plugin e regole; non equivale a un’installazione verificata di un’estensione nativa. Le estensioni ufficiali possono includere skill e server MCP 11, e l’installazione crea una copia che va aggiornata con un comando dedicato
9. È importante non confondere questa modalità nativa con il flusso di copia già presente nel repository.
La revisione individua anche riferimenti che potrebbero non funzionare dopo la distribuzione: una regola globale core usa un percorso relativo verso le skill (bmad-suite-v4/rules/bmad-core.md:38), ma la mappatura colloca regole e skill in posizioni diverse (scripts/deployment_source.py:83). La verifica deve quindi avvenire nei percorsi effettivamente installati, non solo sui file sorgenti.
Il servizio MCP: meglio separarlo dal pacchetto metodologico
Per solo-distill-mcp, la raccomandazione è un servizio locale indipendente, richiamato dall’host MCP e integrato con un ingresso documentale autorizzato. La suite dovrebbe fornire adattamento e requisiti di capacità, non inglobare il codice del servizio nelle regole.
La procedura esistente per i progetti brownfield richiede già di verificare versione, strumenti dichiarati, copertura linguistica, sistemi che li utilizzano e capacità di suddividere i risultati (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:22). Tuttavia, la revisione non ha esaminato il codice attuale del servizio: non può quindi confermare che le interfacce o la registrazione automatica funzionino già.
L’MCP dovrebbe essere un’aggiunta per le attività ordinarie, ma un prerequisito esplicito per i flussi che richiedono proprio il motore di distillazione. Se manca, vanno bloccati solo i passaggi che dipendono da esso, senza far fallire l’intera suite o presentare la semplice lettura di file come una verifica del motore. Anche l’uso di modelli va tenuto distinto dalla scansione offline: se il modello non è disponibile, i risultati dovrebbero conservare le prove strutturali e indicare ciò che resta incerto, senza promettere le stesse capacità di analisi semantica (brownfield-distill-governance.md:24).
La conclusione è pratica: prima di presentare v4.3 come pronto, bisogna verificare provenienza e versione, sistemare i riferimenti dopo l’installazione e uniformare i controlli CI; poi convalidare separatamente distribuzione e comportamento su ogni host. Il servizio MCP viene dopo. Il criterio di rilascio non dovrebbe essere «abbiamo cambiato il numero», ma «i controlli necessari per usare e aggiornare il pacchetto sono stati chiusi».
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "v4.3 non si fa cambiando un’etichetta: cosa manca al repository per essere pronto"?
La proposta è usare versioni pubbliche a due componenti, come v4.3, mantenendo V4 come identità interna e una sola fonte per il numero di versione.
What are the key points to validate first?
La proposta è usare versioni pubbliche a due componenti, come v4.3, mantenendo V4 come identità interna e una sola fonte per il numero di versione. La revisione non ha modificato il repository, cancellato file, eseguito test né effettuato distribuzioni: non certifica quindi una release v4.3 pronta.
What should I do next in practice?
Installazione e distribuzione hanno già alcune protezioni, ma restano da verificare la fonte degli aggiornamenti, i riferimenti dopo l’installazione e i controlli CI.