Conclusie: v4.3 is een doel, geen afgeronde release

Het advies is om voor externe communicatie een eenvoudig schema te gebruiken, zoals v4.3 en v4.4, en de interne suite-identiteit V4 te behouden. Een volledige hernoeming van mappen, herschrijving van de geschiedenis of ingewikkelde versiearchitectuur is daarvoor niet nodig.

Maar op basis van deze read-only beoordeling kan de repository nog niet worden aangemerkt als een schone, volledig inzetbare v4.3. Er zijn geen wijzigingen aangebracht, oude bestanden verwijderd, tests gedraaid of deployments uitgevoerd. Ook is de relatie tussen een externe v4.3-tag en de lokale commit niet met controleerbaar bewijs vastgesteld.

Versies en oude bestanden

De README vermeldt nog v4.2.0 (README.md:3) en de engineering-ingang V4.2 (bmad-suite-v4/skills/bmad/SKILL.md:11). De versie-mapping in scripts/suite_versions.py:28 herkent alleen V4; er is dus nog geen eenduidige bron voor het kleine versienummer.

De aanbevolen aanpak is één centrale versiebron te gebruiken voor documentatie, installatie-instructies en CI-controles. Commit-ID’s en bestandshashes blijven nuttig om herkomst vast te stellen en gebruikersbestanden te beschermen, maar hoeven geen extra versiebeheerlaag te worden.

In .versions/v4.0.0/ staat een oude versiecache die mogelijk kan worden opgeruimd. Controleer eerst of bestaande deployments of verwijzingen er nog van afhankelijk zijn. De cache-ingang weigert inmiddels automatisch oude cachebenamingen te hergebruiken (scripts/tag-cache.py:109).

Niet alle historische bestanden zijn overbodig. Een oude verificatiemap wordt nog aangehaald in een bestaande ADR (docs/adrs/ADR-20261012-bmad-solo-anti-bureaucracy-and-programmatic-guards.md:232). De historische skillmap (_bmad-solo-source/legacy-skills/) bevat bovendien materiaal dat relevant is voor de herkomst van upstream skills. Geen van deze bestanden is tijdens de audit verwijderd.

1. Installatie: goede bescherming, maar nog niet compleet

Er zijn belangrijke waarborgen die behouden moeten blijven: de installatie-ingang weigert een vervuilde werkboom te overschrijven (install.sh:50), de deployment-ingang vereist een fast-forward-update en draagt over aan de vernieuwde scriptversie (bs.sh:298), en de beheerde coördinator controleert op conflicten vóór het schrijven (scripts/deploy-managed-cli.py:104). Eenvoudiger versiebeheer is geen reden om die bescherming te versoepelen.

De installatie-ingang accepteert momenteel alleen compatibiliteitsargumenten voor V4 (install.sh:14). Keuze van host, een alleen-lezen voorcontrole en parameters voor het doel of de modus worden niet doorgegeven. De vereisten staan vooral in de README (README.md:30); er is geen uniforme afhankelijkhedencontrole in de installatie-ingang.

Ook de herkomstcontrole is nog niet sluitend. Een bestaande installatie werkt via de lokale repository, terwijl updates de remote uit de configuratie gebruiken (bs.sh:305). In de bekeken ingangen wordt niet gecontroleerd of die remote nog de verwachte repository is.

Houd de taakverdeling eenvoudig: laat de installatie-ingang een betrouwbare bron ophalen, voorwaarden controleren en parameters doorgeven. Laat de deployment-ingang de hostaanpassing, voorcontrole, update, verwijdering en bescherming van gebruikersbestanden afhandelen. Een aparte versie-orchestrator is hiervoor niet nodig.

2. CI: de voorgestelde versieafspraak is nog niet afgedwongen

De huidige workflow draait bij wijzigingen op de hoofdbranch en bij pull requests, maar is niet ingesteld om releasetags te controleren (.github/workflows/ci.yml:3). De plugincontrole kijkt naar structuur en namen, niet naar de releaseversie (.github/workflows/ci.yml:41).

De tagvalidator controleert alleen aanwijzingen voor de hoofdversie. De bestaande tests laten zowel versies met drie getallen als niet-versietags toe (scripts/suite_versions.py:99; tests/roo_distribution/test_suite_versions.py:80). Daarom is het nu niet juist te zeggen dat de repository al een tweedelige versieafspraak volgt.

Een minimale aanvulling op CI zou nieuwe releasetags in de vorm v4.<nummer> controleren, nagaan of de tag overeenkomt met de centrale versiebron en relevante weergaveteksten op consistentie controleren. Oude geschiedenis hoeft daarvoor niet massaal te worden herschreven; versies van externe afhankelijkheden vallen buiten deze afspraak.

Voeg ook een controle op de volledigheid van skillpakketten toe. Er is al een validator (bmad-suite-v4/skills/bmad/scripts/validate-solo-package.py:5), maar de huidige CI-workflow voert die niet uit (.github/workflows/ci.yml:55). Controleer daarbij niet alleen verwijzingen binnen de repository, maar ook de verwijzingen die na installatie overblijven.

3. Upstream skills: lokaal aangepast, niet live gekoppeld

De actieve route verwijst naar processen binnen deze suite (bmad-suite-v4/skills/bmad/references/capability-map.md:3). De distributiemapping verzamelt de suitebestanden, niet de externe map met historische skills (scripts/deployment_source.py:64). In de bekeken actieve code is geen keten aangetroffen die upstream skills live controleert of bijwerkt.

Dat betekent dat de upstream skills geen directe runtime-afhankelijkheid zijn van de bekeken lokale ingangen. Het betekent óók dat wijzigingen upstream niet automatisch doorwerken in processen die lokaal zijn overgenomen en aangepast. Dat is een risico op onderhoudsachterstand, geen bewezen compatibiliteitsisolatie.

Historische skills opnieuw opnemen maakt ze niet vanzelf bruikbaar. Zo steunt de oude helpskill op configuratie, een directory-overzicht en een parser (_bmad-solo-source/legacy-skills/bmad-help/SKILL.md:25). De oude buildskill is afhankelijk van een renderprogramma (_bmad-solo-source/legacy-skills/bmad-build-auto/SKILL.md:6). Alleen een instructiebestand kopiëren is dus niet voldoende.

Een veiligere route is om stabiele lokale ingangen voor analyse en engineering te behouden, en goedgekeurde upstream skills per capaciteit te integreren. Leg daarbij de broncommit en vereiste ondersteunende bestanden vast. Controleer bij updates wat is toegevoegd of verwijderd en welke afhankelijkheden zijn veranderd; vervang de bestaande versie pas nadat de relevante controles slagen. Laat lopende taken niet rechtstreeks een voortdurend veranderende upstream-hoofdbranch uitlezen.

Maak ook onderscheid tussen updates ontdekken en ze automatisch vervangen. Een controle tijdens installatie of update, eventueel aangevuld met periodieke meldingen, is een lichtere optie dan standaard een achtergrondmonitor laten draaien.

4. Cline: de host bestaat, de repo-integratie is nog niet af

Cline biedt zowel een CLI als IDE-plug-ins en maakt onderscheid tussen globale configuratie en configuratie per project. 41

In deze repository is er vooralsnog een niet-geactiveerde, dunne routertemplate (bmad-suite-v4/cline/templates/bmad-router.md:3). Een distributietest schrijft expliciet voor dat deze in een niet-actieve spiegel blijft en niet in de actieve Cline-regels terechtkomt (tests/roo_distribution/test_host_adaptation.py:85). Dat is dus geen bewijs dat de Cline-integratie al geïnstalleerd of operationeel is.

Het advies is om één gedeelde set methodologische inhoud te onderhouden en daaruit afzonderlijke, lichte aanpassingen voor de CLI en plug-in te genereren. Koppel analyse en engineering aan Cline’s eigen Plan/Act-werkwijze. Zo hoeven gebruikers geen speciale skillcommando’s te onthouden en wordt configuratie voor Roo niet rechtstreeks overgenomen.

De paden in de template zijn relatief aan de root van deze repository (bmad-suite-v4/cline/templates/bmad-router.md:8). Bij installatie in een ander project moet de locatie van de benodigde bestanden opnieuw worden bepaald; kopiëren zonder die controle kan verwijzingen breken.

5. Roo en Gemini: geen bewezen complete globale installatie

Roo

De distributiemapping bevat globale regels en geselecteerde modi (scripts/deployment_source.py:86), maar het feit dat bestanden op schijf staan bewijst niet dat Roo ze heeft geladen.

Belangrijker: geen van de twee aangepaste modi declareert MCP-rechten (bmad-suite-v4/roo/settings/custom_modes.yaml:5), terwijl de validator uitgaat van vaste permissiegroepen (scripts/validate-roo-contracts.py:158). Als de dienst voor het uitwerken van projectmateriaal wordt aangesloten, moeten dus zowel de modusconfiguratie als de controles die deze consumeren worden beoordeeld. Alleen de instructietekst aanpassen is niet genoeg.

Gemini CLI

De huidige aanpak is een fysieke spiegel van plugin- en regelmappen (scripts/deployment_source.py:81), niet een aantoonbaar gecontroleerde installatie als native Gemini-extensie. De officiële extensies kunnen onder meer skills en MCP-servers bundelen; bij installatie maakt Gemini CLI een kopie die apart moet worden bijgewerkt. 119 Houd de bestaande spiegelroute daarom gescheiden van een eventuele native extensieroute, in plaats van beide als één reeds ondersteunde integratie te presenteren.

Er is ook een mogelijk probleem met verwijzingen na installatie: de globale core-regel gebruikt een relatief pad naar skills (bmad-suite-v4/rules/bmad-core.md:38), terwijl de mapping de regelkopie en de skills op verschillende locaties plaatst (scripts/deployment_source.py:83). Als die verwijzing relatief aan het bestand wordt opgelost, komt ze niet vanzelf bij de gedistribueerde skill uit.

Projectbestanden en globale regels

De projectingang gebruikt een aanwijzer naar één actuele focus (specs/tasks/_active.md:10), terwijl de gedeelde core-regel nog naar een ouder actief-planmechanisme zoekt (bmad-suite-v4/roo/rules/02-bmad-core.md:8). Ook de bewerkingsscope voor de analysestand dekt niet alle nieuwe projectdocumentlocaties (bmad-suite-v4/roo/settings/custom_modes.yaml:8). Die verschillende aannames moeten worden gelijkgetrokken.

Houd de scheiding helder: globaal installeer je herbruikbare methodologie, skills en hostaanpassingen; op projectniveau bewaar je alleen de ingang, domeinregels, beslissingen en taken van dat project. De bronverzameling neemt de projectbestanden niet als geheel mee (scripts/deployment_source.py:64); die grens is verstandig om te behouden.

6. solo-distill-mcp: zelfstandig en lokaal, met gecontroleerde integratie

De aanbevolen standaard is een zelfstandige lokale MCP-dienst. De host roept die aan, de dienst leest alleen goedgekeurde projectbronnen en stelt kandidaten samen, waarna een goedgekeurde documentroute materiaal aan het project kan toevoegen. Verbind de gedistribueerde methodologie met de vereiste capaciteit, maar voeg niet de volledige servicecode samen met het regelpakket.

Of de dienst bruikbaar is, moet per capaciteit worden vastgesteld. De bestaande brownfield-richtlijn verlangt al controles op versie, tooldeclaraties, taalondersteuning, consumers en mogelijkheden voor het opdelen van materiaal (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:22). De actuele servicebron is in deze audit niet bekeken; er kan dus niet worden toegezegd dat de vereiste interfaces of automatische registratie al werken.

Voor gewone analyse- en programmeertaken hoort MCP een aanvullende mogelijkheid te zijn. Een opstartproces dat expliciet de distillatie-engine vereist, mag die dienst wel als voorwaarde stellen. Ontbreekt de dienst, blokkeer dan alleen de stappen die ervan afhangen. Gewone bestandslezing mag niet worden voorgesteld als een geslaagde acceptatietest van de engine.

Offline scannen, bronverificatie en optioneel modelgebruik moeten aparte lagen zijn. Is een model niet beschikbaar, behoud dan structurele aanwijzingen en markeer onbekende zaken als onbekend. Volledige semantische distillatie kan dan niet worden gegarandeerd; dat past bij de offlinegrens in de bestaande richtlijn (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:24).

GitHub in combinatie met een SSH-tunnel is niet aan te raden als standaardarchitectuur. Houd de locatie van de broncode gescheiden van de locatie waar de dienst draait. Een externe dienst kan een optie zijn als daar een concrete reden voor is, maar vereist afzonderlijke afspraken over gegevensuitvoer, authenticatie, projectisolatie, verbindingsuitval en afhankelijkheid van een modeldienst. Een tunnel lost die aandachtspunten niet op.

Een beheerste koppeling kan bestaan uit registratie na goedkeuring bij installatie, controle van beschikbare capaciteiten bij gebruik en vastlegging van de serviceversie bij het begin van een taak. Download of start niet automatisch experimentele componenten en verruim niet ongemerkt de rechten.

Voorgestelde volgorde en acceptatie

1. Stel eerst de echte herkomst van v4.3 vast, kies één versiebron en maak een expliciete lijst van bestanden die mogelijk kunnen worden opgeschoond. Behoud materialen die nog nodig zijn voor herkomst of controles.
2. Herstel verwijzingen na installatie en maak de projectingangen en documentbereiken consistent. Voeg daarna CI-controles voor versieafspraken en pakketvolledigheid toe.
3. Pas Cline, Roo en Gemini afzonderlijk aan. Controleer per host het laden op globaal en projectniveau, toegestaan en geweigerd gedrag, updates en bescherming van bestanden van derden.
4. Koppel pas daarna de zelfstandige lokale distillatieservice aan. Test onder meer een werkende, ontbrekende of incompatibele service, een niet-beschikbaar model en fouten die een proces onderbreken.

Dit is voorgesteld vervolgwerk, geen werk dat al is uitgevoerd. De grootste open punten zitten niet in een te ingewikkeld versienummer, maar in de herkomst, distributiepaden, het laden door hosts en de manier waarop projectregels worden gebruikt. Maak de noodzakelijke controles daarom onderdeel van de v4.3-acceptatie; een aangepast versielabel alleen is geen releasebewijs.

Conclusie: v4.3 is een doel, geen afgeronde release

Het advies is om voor externe communicatie een eenvoudig schema te gebruiken, zoals v4.3 en v4.4, en de interne suite-identiteit V4 te behouden. Een volledige hernoeming van mappen, herschrijving van de geschiedenis of ingewikkelde versiearchitectuur is daarvoor niet nodig.

Maar op basis van deze read-only beoordeling kan de repository nog niet worden aangemerkt als een schone, volledig inzetbare v4.3. Er zijn geen wijzigingen aangebracht, oude bestanden verwijderd, tests gedraaid of deployments uitgevoerd. Ook is de relatie tussen een externe v4.3-tag en de lokale commit niet met controleerbaar bewijs vastgesteld.

Versies en oude bestanden

De README vermeldt nog v4.2.0 (README.md:3) en de engineering-ingang V4.2 (bmad-suite-v4/skills/bmad/SKILL.md:11). De versie-mapping in scripts/suite_versions.py:28 herkent alleen V4; er is dus nog geen eenduidige bron voor het kleine versienummer.

De aanbevolen aanpak is één centrale versiebron te gebruiken voor documentatie, installatie-instructies en CI-controles. Commit-ID’s en bestandshashes blijven nuttig om herkomst vast te stellen en gebruikersbestanden te beschermen, maar hoeven geen extra versiebeheerlaag te worden.

In .versions/v4.0.0/ staat een oude versiecache die mogelijk kan worden opgeruimd. Controleer eerst of bestaande deployments of verwijzingen er nog van afhankelijk zijn. De cache-ingang weigert inmiddels automatisch oude cachebenamingen te hergebruiken (scripts/tag-cache.py:109).

Niet alle historische bestanden zijn overbodig. Een oude verificatiemap wordt nog aangehaald in een bestaande ADR (docs/adrs/ADR-20261012-bmad-solo-anti-bureaucracy-and-programmatic-guards.md:232). De historische skillmap (_bmad-solo-source/legacy-skills/) bevat bovendien materiaal dat relevant is voor de herkomst van upstream skills. Geen van deze bestanden is tijdens de audit verwijderd.

1. Installatie: goede bescherming, maar nog niet compleet

Er zijn belangrijke waarborgen die behouden moeten blijven: de installatie-ingang weigert een vervuilde werkboom te overschrijven (install.sh:50), de deployment-ingang vereist een fast-forward-update en draagt over aan de vernieuwde scriptversie (bs.sh:298), en de beheerde coördinator controleert op conflicten vóór het schrijven (scripts/deploy-managed-cli.py:104). Eenvoudiger versiebeheer is geen reden om die bescherming te versoepelen.

De installatie-ingang accepteert momenteel alleen compatibiliteitsargumenten voor V4 (install.sh:14). Keuze van host, een alleen-lezen voorcontrole en parameters voor het doel of de modus worden niet doorgegeven. De vereisten staan vooral in de README (README.md:30); er is geen uniforme afhankelijkhedencontrole in de installatie-ingang.

Ook de herkomstcontrole is nog niet sluitend. Een bestaande installatie werkt via de lokale repository, terwijl updates de remote uit de configuratie gebruiken (bs.sh:305). In de bekeken ingangen wordt niet gecontroleerd of die remote nog de verwachte repository is.

Houd de taakverdeling eenvoudig: laat de installatie-ingang een betrouwbare bron ophalen, voorwaarden controleren en parameters doorgeven. Laat de deployment-ingang de hostaanpassing, voorcontrole, update, verwijdering en bescherming van gebruikersbestanden afhandelen. Een aparte versie-orchestrator is hiervoor niet nodig.

2. CI: de voorgestelde versieafspraak is nog niet afgedwongen

De huidige workflow draait bij wijzigingen op de hoofdbranch en bij pull requests, maar is niet ingesteld om releasetags te controleren (.github/workflows/ci.yml:3). De plugincontrole kijkt naar structuur en namen, niet naar de releaseversie (.github/workflows/ci.yml:41).

De tagvalidator controleert alleen aanwijzingen voor de hoofdversie. De bestaande tests laten zowel versies met drie getallen als niet-versietags toe (scripts/suite_versions.py:99; tests/roo_distribution/test_suite_versions.py:80). Daarom is het nu niet juist te zeggen dat de repository al een tweedelige versieafspraak volgt.

Een minimale aanvulling op CI zou nieuwe releasetags in de vorm v4.<nummer> controleren, nagaan of de tag overeenkomt met de centrale versiebron en relevante weergaveteksten op consistentie controleren. Oude geschiedenis hoeft daarvoor niet massaal te worden herschreven; versies van externe afhankelijkheden vallen buiten deze afspraak.

Voeg ook een controle op de volledigheid van skillpakketten toe. Er is al een validator (bmad-suite-v4/skills/bmad/scripts/validate-solo-package.py:5), maar de huidige CI-workflow voert die niet uit (.github/workflows/ci.yml:55). Controleer daarbij niet alleen verwijzingen binnen de repository, maar ook de verwijzingen die na installatie overblijven.

3. Upstream skills: lokaal aangepast, niet live gekoppeld

De actieve route verwijst naar processen binnen deze suite (bmad-suite-v4/skills/bmad/references/capability-map.md:3). De distributiemapping verzamelt de suitebestanden, niet de externe map met historische skills (scripts/deployment_source.py:64). In de bekeken actieve code is geen keten aangetroffen die upstream skills live controleert of bijwerkt.

Dat betekent dat de upstream skills geen directe runtime-afhankelijkheid zijn van de bekeken lokale ingangen. Het betekent óók dat wijzigingen upstream niet automatisch doorwerken in processen die lokaal zijn overgenomen en aangepast. Dat is een risico op onderhoudsachterstand, geen bewezen compatibiliteitsisolatie.

Historische skills opnieuw opnemen maakt ze niet vanzelf bruikbaar. Zo steunt de oude helpskill op configuratie, een directory-overzicht en een parser (_bmad-solo-source/legacy-skills/bmad-help/SKILL.md:25). De oude buildskill is afhankelijk van een renderprogramma (_bmad-solo-source/legacy-skills/bmad-build-auto/SKILL.md:6). Alleen een instructiebestand kopiëren is dus niet voldoende.

Een veiligere route is om stabiele lokale ingangen voor analyse en engineering te behouden, en goedgekeurde upstream skills per capaciteit te integreren. Leg daarbij de broncommit en vereiste ondersteunende bestanden vast. Controleer bij updates wat is toegevoegd of verwijderd en welke afhankelijkheden zijn veranderd; vervang de bestaande versie pas nadat de relevante controles slagen. Laat lopende taken niet rechtstreeks een voortdurend veranderende upstream-hoofdbranch uitlezen.

Maak ook onderscheid tussen updates ontdekken en ze automatisch vervangen. Een controle tijdens installatie of update, eventueel aangevuld met periodieke meldingen, is een lichtere optie dan standaard een achtergrondmonitor laten draaien.

4. Cline: de host bestaat, de repo-integratie is nog niet af

Cline biedt zowel een CLI als IDE-plug-ins en maakt onderscheid tussen globale configuratie en configuratie per project. 41

In deze repository is er vooralsnog een niet-geactiveerde, dunne routertemplate (bmad-suite-v4/cline/templates/bmad-router.md:3). Een distributietest schrijft expliciet voor dat deze in een niet-actieve spiegel blijft en niet in de actieve Cline-regels terechtkomt (tests/roo_distribution/test_host_adaptation.py:85). Dat is dus geen bewijs dat de Cline-integratie al geïnstalleerd of operationeel is.

Het advies is om één gedeelde set methodologische inhoud te onderhouden en daaruit afzonderlijke, lichte aanpassingen voor de CLI en plug-in te genereren. Koppel analyse en engineering aan Cline’s eigen Plan/Act-werkwijze. Zo hoeven gebruikers geen speciale skillcommando’s te onthouden en wordt configuratie voor Roo niet rechtstreeks overgenomen.

De paden in de template zijn relatief aan de root van deze repository (bmad-suite-v4/cline/templates/bmad-router.md:8). Bij installatie in een ander project moet de locatie van de benodigde bestanden opnieuw worden bepaald; kopiëren zonder die controle kan verwijzingen breken.

5. Roo en Gemini: geen bewezen complete globale installatie

Roo

De distributiemapping bevat globale regels en geselecteerde modi (scripts/deployment_source.py:86), maar het feit dat bestanden op schijf staan bewijst niet dat Roo ze heeft geladen.

Belangrijker: geen van de twee aangepaste modi declareert MCP-rechten (bmad-suite-v4/roo/settings/custom_modes.yaml:5), terwijl de validator uitgaat van vaste permissiegroepen (scripts/validate-roo-contracts.py:158). Als de dienst voor het uitwerken van projectmateriaal wordt aangesloten, moeten dus zowel de modusconfiguratie als de controles die deze consumeren worden beoordeeld. Alleen de instructietekst aanpassen is niet genoeg.

Gemini CLI

De huidige aanpak is een fysieke spiegel van plugin- en regelmappen (scripts/deployment_source.py:81), niet een aantoonbaar gecontroleerde installatie als native Gemini-extensie. De officiële extensies kunnen onder meer skills en MCP-servers bundelen; bij installatie maakt Gemini CLI een kopie die apart moet worden bijgewerkt. 119 Houd de bestaande spiegelroute daarom gescheiden van een eventuele native extensieroute, in plaats van beide als één reeds ondersteunde integratie te presenteren.

Er is ook een mogelijk probleem met verwijzingen na installatie: de globale core-regel gebruikt een relatief pad naar skills (bmad-suite-v4/rules/bmad-core.md:38), terwijl de mapping de regelkopie en de skills op verschillende locaties plaatst (scripts/deployment_source.py:83). Als die verwijzing relatief aan het bestand wordt opgelost, komt ze niet vanzelf bij de gedistribueerde skill uit.

Projectbestanden en globale regels

De projectingang gebruikt een aanwijzer naar één actuele focus (specs/tasks/_active.md:10), terwijl de gedeelde core-regel nog naar een ouder actief-planmechanisme zoekt (bmad-suite-v4/roo/rules/02-bmad-core.md:8). Ook de bewerkingsscope voor de analysestand dekt niet alle nieuwe projectdocumentlocaties (bmad-suite-v4/roo/settings/custom_modes.yaml:8). Die verschillende aannames moeten worden gelijkgetrokken.

Houd de scheiding helder: globaal installeer je herbruikbare methodologie, skills en hostaanpassingen; op projectniveau bewaar je alleen de ingang, domeinregels, beslissingen en taken van dat project. De bronverzameling neemt de projectbestanden niet als geheel mee (scripts/deployment_source.py:64); die grens is verstandig om te behouden.

6. solo-distill-mcp: zelfstandig en lokaal, met gecontroleerde integratie

De aanbevolen standaard is een zelfstandige lokale MCP-dienst. De host roept die aan, de dienst leest alleen goedgekeurde projectbronnen en stelt kandidaten samen, waarna een goedgekeurde documentroute materiaal aan het project kan toevoegen. Verbind de gedistribueerde methodologie met de vereiste capaciteit, maar voeg niet de volledige servicecode samen met het regelpakket.

Of de dienst bruikbaar is, moet per capaciteit worden vastgesteld. De bestaande brownfield-richtlijn verlangt al controles op versie, tooldeclaraties, taalondersteuning, consumers en mogelijkheden voor het opdelen van materiaal (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:22). De actuele servicebron is in deze audit niet bekeken; er kan dus niet worden toegezegd dat de vereiste interfaces of automatische registratie al werken.

Voor gewone analyse- en programmeertaken hoort MCP een aanvullende mogelijkheid te zijn. Een opstartproces dat expliciet de distillatie-engine vereist, mag die dienst wel als voorwaarde stellen. Ontbreekt de dienst, blokkeer dan alleen de stappen die ervan afhangen. Gewone bestandslezing mag niet worden voorgesteld als een geslaagde acceptatietest van de engine.

Offline scannen, bronverificatie en optioneel modelgebruik moeten aparte lagen zijn. Is een model niet beschikbaar, behoud dan structurele aanwijzingen en markeer onbekende zaken als onbekend. Volledige semantische distillatie kan dan niet worden gegarandeerd; dat past bij de offlinegrens in de bestaande richtlijn (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:24).

GitHub in combinatie met een SSH-tunnel is niet aan te raden als standaardarchitectuur. Houd de locatie van de broncode gescheiden van de locatie waar de dienst draait. Een externe dienst kan een optie zijn als daar een concrete reden voor is, maar vereist afzonderlijke afspraken over gegevensuitvoer, authenticatie, projectisolatie, verbindingsuitval en afhankelijkheid van een modeldienst. Een tunnel lost die aandachtspunten niet op.

Een beheerste koppeling kan bestaan uit registratie na goedkeuring bij installatie, controle van beschikbare capaciteiten bij gebruik en vastlegging van de serviceversie bij het begin van een taak. Download of start niet automatisch experimentele componenten en verruim niet ongemerkt de rechten.

Voorgestelde volgorde en acceptatie

1. Stel eerst de echte herkomst van v4.3 vast, kies één versiebron en maak een expliciete lijst van bestanden die mogelijk kunnen worden opgeschoond. Behoud materialen die nog nodig zijn voor herkomst of controles.
2. Herstel verwijzingen na installatie en maak de projectingangen en documentbereiken consistent. Voeg daarna CI-controles voor versieafspraken en pakketvolledigheid toe.
3. Pas Cline, Roo en Gemini afzonderlijk aan. Controleer per host het laden op globaal en projectniveau, toegestaan en geweigerd gedrag, updates en bescherming van bestanden van derden.
4. Koppel pas daarna de zelfstandige lokale distillatieservice aan. Test onder meer een werkende, ontbrekende of incompatibele service, een niet-beschikbaar model en fouten die een proces onderbreken.

Dit is voorgesteld vervolgwerk, geen werk dat al is uitgevoerd. De grootste open punten zitten niet in een te ingewikkeld versienummer, maar in de herkomst, distributiepaden, het laden door hosts en de manier waarop projectregels worden gebruikt. Maak de noodzakelijke controles daarom onderdeel van de v4.3-acceptatie; een aangepast versielabel alleen is geen releasebewijs.