RespuestasPublicado14 fuentes
v4.3: una auditoría de lo que falta antes de darlo por listo
La propuesta es usar versiones públicas como v4.3 y v4.4, sin renombrar todo el proyecto ni reescribir su historial. La revisión no modificó el repositorio ni ejecutó pruebas o despliegues: todavía no hay base para afirmar que v4.3 esté listo.
Publicado porImágenes generadas con GPT Image 2
Respuesta de investigación
Conclusiones clave
- La propuesta es usar versiones públicas como v4.3 y v4.4, sin renombrar todo el proyecto ni reescribir su historial.
- La revisión no modificó el repositorio ni ejecutó pruebas o despliegues: todavía no hay base para afirmar que v4.3 esté listo.
- Faltan controles de versión y de integridad de paquetes en CI, además de cerrar brechas en las rutas de instalación y las adaptaciones para Cline, Roo y Gemini.
- La integración con el servicio local de destilación debería ser opcional para el trabajo habitual y obligatoria solo en los flujos que dependan de ella.
![[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)
Prompt de IA
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
La recomendación es sencilla: usar v4.3 como versión pública y evitar convertir el control de versiones en un proyecto aparte. Pero hay una distinción importante: una auditoría de solo lectura no equivale a una actualización. En esta revisión no se modificó el repositorio, no se borró historial, no se ejecutaron pruebas ni se hizo ningún despliegue. Por tanto, todavía no se puede afirmar que el árbol de trabajo esté limpio y listo para publicar como v4.3.
Una versión pública clara, sin rehacer el historial
La propuesta es adoptar un esquema público breve —v4.3, v4.4— y conservar V4 como identidad interna del conjunto. No hace falta renombrar directorios ni reescribir el historial para que el número de versión resulte comprensible.
Hoy la documentación aún señala v4.2.0 (README.md:3) y la entrada principal del proyecto indica V4.2 (bmad-suite-v4/skills/bmad/SKILL.md:11). Además, el mapeo de identidad del conjunto solo reconoce V4 y no existe una única fuente para el número menor (scripts/suite_versions.py:28). La revisión tampoco encontró evidencia suficiente para verificar que una etiqueta remota v4.3 corresponda al estado actual del repositorio: cambiar una insignia no bastaría para dar por cerrado ese desfase.
Conviene definir una sola fuente para la versión y usarla en la documentación, las instrucciones de instalación y las comprobaciones de CI. Los identificadores de commit y las huellas de los archivos pueden seguir sirviendo para rastrear el origen y proteger los recursos de los usuarios, sin convertirse en otro sistema de versiones.
También hay una caché antigua en .versions/v4.0.0/ que podría evaluarse para su limpieza, pero antes habría que comprobar que ningún despliegue o enlace dependa de ella. El punto de entrada de caché (scripts/tag-cache.py:109) ya impide reutilizar automáticamente cachés con nombres de etiquetas antiguos. En cambio, no conviene tratar como prescindibles, sin más, el directorio histórico de verificación, citado por un ADR (docs/adrs/ADR-20261012-bmad-solo-anti-bureaucracy-and-programmatic-guards.md:232), ni el directorio de skills históricos, que aporta información relevante sobre su origen (_bmad-solo-source/legacy-skills/). No se eliminó ningún recurso durante la revisión.
Instalación: hay protecciones, pero faltan comprobaciones y opciones
El proceso ya cuenta con salvaguardas que conviene mantener: install.sh:50 rechaza sobrescribir un árbol de trabajo con cambios sin guardar; bs.sh:298 exige una actualización por avance rápido y delega en el script nuevo; y scripts/deploy-managed-cli.py:104 comprueba conflictos antes de escribir. Simplificar las versiones no requiere renunciar a estas protecciones.
Lo que falta es una experiencia de instalación más completa. install.sh:14 acepta parámetros de compatibilidad V4, pero no permite elegir el anfitrión ni transmite opciones de previsualización de solo lectura o de destino por modo. Los requisitos de dependencias se explican sobre todo en README.md:30, sin una comprobación previa unificada desde el instalador. Además, la ruta de actualización usa el remoto configurado (bs.sh:305), pero la revisión no encontró una verificación de que siga siendo el repositorio esperado.
Una separación de responsabilidades puede mantener el sistema simple: el instalador debería obtener el origen confiable, revisar los requisitos y pasar los parámetros; el mecanismo de despliegue debería encargarse de adaptar el contenido al anfitrión, previsualizar cambios, actualizar, desinstalar y proteger los recursos existentes.
CI: todavía no se aplica la regla de versiones propuesta
El flujo de trabajo actual (.github/workflows/ci.yml:3) se activa con cambios en la rama principal y con solicitudes de integración, pero no con etiquetas de publicación. La comprobación de plugins (.github/workflows/ci.yml:41) revisa estructura y nombres, no el formato de la versión.
Por su parte, scripts/suite_versions.py:99 comprueba indicios de la línea principal, pero no impone una regla de dos componentes. Las pruebas existentes (tests/roo_distribution/test_suite_versions.py:80) permiten versiones de tres componentes y etiquetas que no son versiones. Así que, hoy, no se puede decir que el proyecto ya siga la convención v4.n.
Como mínimo, CI debería comprobar que las nuevas etiquetas de publicación sigan el formato v4.n, que coincidan con la única fuente de versión y que el texto visible esté actualizado. Eso no obliga a reescribir etiquetas históricas ni afecta a las versiones de dependencias de terceros.
También falta ejecutar en CI el validador de integridad del paquete de skills (bmad-suite-v4/skills/bmad/scripts/validate-solo-package.py:5). El flujo actual (.github/workflows/ci.yml:55) no lo invoca. La comprobación debería cubrir tanto las referencias dentro del repositorio como las que quedan después de instalar el paquete.
Skills de upstream: adaptadas localmente, no actualizadas en tiempo real
Las rutas activas apuntan a los flujos propios del conjunto (bmad-suite-v4/skills/bmad/references/capability-map.md:3). El mapeo de distribución recopila ese directorio, pero no el repositorio histórico de skills externas (scripts/deployment_source.py:64). En el código activo revisado tampoco se encontró un mecanismo para detectar o incorporar actualizaciones de upstream en tiempo real.
Eso significa que las skills upstream no son una dependencia directa en tiempo de ejecución de estas entradas locales. Pero también significa que actualizar el material de origen no actualiza automáticamente los flujos ya extraídos y adaptados: existe riesgo de desfase de mantenimiento, no una garantía de compatibilidad.
Tampoco bastaría con volver a conectar una skill histórica y darla por operativa. Por ejemplo, la skill histórica de ayuda depende de configuración, un inventario de directorios y un analizador (_bmad-solo-source/legacy-skills/bmad-help/SKILL.md:25); la de construcción depende de un renderizador (_bmad-solo-source/legacy-skills/bmad-build-auto/SKILL.md:6). Copiar sus instrucciones no incorpora esas dependencias.
La recomendación es conservar las entradas locales estables y conectar solo skills upstream aprobadas, según el mapa de capacidades, dejando registrado el commit de origen y los recursos que necesitan. Las actualizaciones deberían detectar cambios, eliminaciones y nuevas dependencias, y pasar las comprobaciones pertinentes antes de sustituir el contenido. No conviene que una tarea en curso lea directamente una rama upstream que cambia continuamente.
También es útil separar detectar que hay una actualización de reemplazar contenido automáticamente. Se puede revisar al instalar o actualizar y, si se desea, enviar avisos periódicos, sin poner en marcha por defecto un monitor en segundo plano.
Cline, Roo y Gemini: tener archivos no demuestra que la integración esté lista
Cline ofrece una CLI y una extensión para IDE, y distingue entre configuración global y configuración del proyecto.4
1 Sin embargo, el repositorio solo contiene una plantilla de enrutamiento sin activar (
bmad-suite-v4/cline/templates/bmad-router.md:3). Una prueba de distribución exige que siga siendo una copia inactiva y que no se escriba en la ubicación efectiva de reglas de Cline (tests/roo_distribution/test_host_adaptation.py:85).
La propuesta es mantener una metodología compartida y generar adaptaciones ligeras para la CLI y la extensión. El análisis y la ejecución deberían ajustarse a los modos Plan y Act de Cline, sin exigir al usuario recordar comandos de skills ni importar directamente la configuración de modos de Roo. Además, la plantilla resuelve sus rutas a partir de la raíz de este repositorio (bmad-suite-v4/cline/templates/bmad-router.md:8); al instalarla en otro proyecto, habrá que recalcular dónde están los recursos.
En Roo, el mapeo de distribución incluye reglas globales y modos seleccionados (scripts/deployment_source.py:86), pero que los archivos estén en disco no prueba que el anfitrión los haya cargado. Hay otra brecha: los dos modos personalizados no declaran permisos MCP (bmad-suite-v4/roo/settings/custom_modes.yaml:5), mientras que el validador fija grupos de permisos (scripts/validate-roo-contracts.py:158). Para conectar una herramienta de destilación hay que revisar tanto la configuración como lo que valida el sistema, no solo cambiar las instrucciones.
En Gemini CLI, lo que hay hoy es un espejo físico de directorios de reglas y plugins (scripts/deployment_source.py:81), no una instalación nativa de extensión que se haya verificado. Las extensiones oficiales pueden agrupar skills y servidores MCP; al instalarlas se crea una copia, que se actualiza mediante un mecanismo propio.11
9 Por eso conviene distinguir la ruta de espejado actual de una integración nativa con Gemini, en lugar de presentarlas como una única vía ya soportada.
La auditoría detectó además una referencia que podría romperse tras la instalación: la regla global apunta a una skill mediante una ruta relativa (bmad-suite-v4/rules/bmad-core.md:38), pero el mapeo distribuye las reglas y las skills en ubicaciones distintas (scripts/deployment_source.py:83). Si la ruta se interpreta respecto del archivo, no llega directamente a la skill distribuida.
También conviven criterios antiguos y nuevos para gobernar el proyecto. La entrada actual usa un puntero a un único foco (specs/tasks/_active.md:10), mientras que las reglas centrales de Roo siguen buscando un plan activo anterior (bmad-suite-v4/roo/rules/02-bmad-core.md:8). El alcance de edición del modo de análisis tampoco incluye los nuevos espacios de documentación (bmad-suite-v4/roo/settings/custom_modes.yaml:8). El límite recomendado es claro: la instalación global debe contener metodología, skills y adaptaciones reutilizables; cada proyecto debe conservar sus propios puntos de entrada, normas de dominio, decisiones y tareas. También conviene mantener ese límite en la distribución: la recopilación actual no despliega en bloque los materiales propios del proyecto (scripts/deployment_source.py:64).
Un servicio de destilación local, conectado de forma gradual
Para solo-distill-mcp, la forma recomendada es un servicio MCP independiente que se ejecute localmente. El servicio leería los proyectos autorizados y produciría materiales candidatos; un punto de publicación aprobado sería quien los incorporase al proyecto. La metodología distribuida debería facilitar el descubrimiento y la conexión, sin incluir todo el código del servicio en el paquete de reglas.
La disponibilidad debe evaluarse según la capacidad real. El procedimiento actual para proyectos existentes pide revisar versión, herramientas declaradas, cobertura de idiomas, consumidores y capacidad de fragmentación (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:22). Pero en esta revisión no se examinó el código actual del servicio, así que no se puede asegurar que sus interfaces o su registro automático estén listos.
Para el análisis y la programación cotidianos, MCP debería ser una capacidad adicional. En cambio, si un flujo de inicialización requiere explícitamente el motor de destilación, el servicio sí debe ser un requisito previo. Si falta, debería bloquearse solo el paso que depende de él, no toda la metodología. Y leer archivos de forma convencional no equivale a haber validado el motor.
También conviene distinguir entre análisis sin conexión, autenticación del origen y capacidades opcionales de modelos. Si el modelo no está disponible, el sistema puede conservar evidencias estructurales y marcar lo que desconoce; no debería prometer el mismo nivel de destilación semántica. Ese límite coincide con el procedimiento existente (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:24).
No se recomienda usar «GitHub más un túnel SSH» como arquitectura predeterminada. El lugar donde se publica el código y el lugar donde se ejecuta el servicio son decisiones distintas. Un servicio remoto puede tener sentido en casos concretos, pero requiere definir por separado la salida de datos, la autenticación, el aislamiento entre proyectos, el comportamiento ante cortes y la dependencia de modelos. Un túnel no resuelve por sí solo esos requisitos.
La asociación automática también debería ser gradual: registrar el servicio con autorización durante la instalación, comprobar sus capacidades al usarlo y vincular la versión al inicio de cada tarea. Sin descargas automáticas, ejecuciones experimentales ni ampliaciones de permisos por defecto.
Orden recomendado para avanzar
- Verificar el origen real de v4.3, definir una única fuente de versión y acordar qué elementos históricos pueden limpiarse sin romper referencias ni despliegues.
- Corregir las rutas que dejan de funcionar tras instalar, unificar los puntos de entrada de gobierno del proyecto y precisar el alcance de edición de la documentación.
- Añadir comprobaciones de formato de versión e integridad de skills a CI.
- Adaptar Cline, Roo y Gemini por separado, y probar en cada uno la carga global, las reglas de proyecto, los permisos, las actualizaciones y la protección de recursos de terceros.
- Integrar por último el servicio local de destilación y probar tanto el caso normal como la ausencia del servicio, la incompatibilidad, la falta de modelo y las interrupciones.
La conclusión no es que v4.3 necesite un sistema de versiones más complejo, sino que aún hay que cerrar el circuito entre el origen, la distribución, la carga en cada anfitrión y las reglas de gobierno de cada proyecto. El número de versión no debería darse por terminado solo porque se actualizó el texto: v4.3 tendría que publicarse cuando se completen las verificaciones necesarias.
Studio Global AI
Continúe su investigación
Esta página incluye una respuesta respaldada por fuentes que puede continuar dentro de Studio Global.
La gente también pregunta
¿Cuál es la respuesta corta a "v4.3: una auditoría de lo que falta antes de darlo por listo"?
La propuesta es usar versiones públicas como v4.3 y v4.4, sin renombrar todo el proyecto ni reescribir su historial.
¿Cuáles son los puntos clave a validar primero?
La propuesta es usar versiones públicas como v4.3 y v4.4, sin renombrar todo el proyecto ni reescribir su historial. La revisión no modificó el repositorio ni ejecutó pruebas o despliegues: todavía no hay base para afirmar que v4.3 esté listo.
¿Qué debo hacer a continuación en la práctica?
Faltan controles de versión y de integridad de paquetes en CI, además de cerrar brechas en las rutas de instalación y las adaptaciones para Cline, Roo y Gemini.