v3.0.0 — Organic Driven Development como workflow por defecto
Major de verdad. A partir de acá el orquestador arranca con Organic Driven Development (ODD) como protocolo obligatorio en los cuatro runtimes soportados (Claude Code, OpenCode, Codex y Pi): un pedido común de feature ya corre solo por explore, resolve, classify, track, implement y close, sin que vos pidas ningún workflow ni tracking de tareas.
Cuando el laburo autorizado es sustancial, te deja un documento durable en odd/tasks/<feature>.md con espejo completo en Engram, así sobrevive interrupciones y resume. Y la implementación respeta el modo TDD que tengas configurado en vez de adivinarlo.
Ojo con esto, que acá está la carne de los breaking: SDD adelgazó. Research pasa a ser una investigación opcional en vez de un certificado de admisión, verify es opcional y diagnóstico en lugar de precondición, y archive procede con el estado real de las tareas —trabajo sin terminar incluido— sin exigir attestation. Se retiró toda la maquinaria de attempt governance y las proyecciones de review de internal/sddstatus e internal/cli. Lo que sigue firme: integridad de grants vivos, locators de artefactos, ruteo de progreso de tareas y composición segura de archive.
RDD sale del ciclo SDD, pero no se muere: sigue siendo el switch propio del usuario con gentle-ai review mode enable|disable|status, independiente de si el cambio salió por ODD o por SDD.
Tres fixes acompañan: los artefactos de agentes instalados en global ya no se filtran al working directory del proyecto actual, las skills de workflow para contributors dejan de viajar en el preset por defecto, y se resolvió un flake de test de CLI solo en Windows.
Un detalle que te va a morder si estás en Windows: esta major se cortó todavía desde el módulo /v2, así que go install la rechaza. Se arregla en el v3.0.1 de acá abajo. Después de actualizar, corré gentle-ai sync sí o sí.
v3.0.1 — El módulo Go se muda a /v3 y vuelve a ser instalable en todas las plataformas
Hotfix directo al problema que dejó el v3.0.0: la major se cortó desde github.com/gentleman-programming/gentle-ai/v2, y Go rechaza cualquier versión v3.x.y para un path de módulo que termina en /v2. Resultado: go install, install.ps1, las instalaciones desde fuente, la instrucción de upgrade que imprimía el binario y el instalador de gentle-pi para Windows no podían instalar v3.0.0. Y como Windows no tiene archivos binarios, los usuarios de Windows quedaron directamente afuera.
El path del módulo ahora vive en /v3: go.mod, todos los imports Go, el símbolo de ldflags de GoReleaser, scripts/install.sh, scripts/install.ps1, la instrucción impresa por gentle-ai upgrade y la documentación. El path de self-upgrade del canal beta armaba su target con un /v2 literal; ahora apunta a /v3.
El breaking es ese mismo: si importás el módulo o instalás desde fuente, tenés que usar /v3. Un binario v3.0.0 todavía imprime la instrucción vieja con /v2, así que a ese lo actualizás una vez a mano y listo. Todo lo que trajo el v3.0.0 queda intacto y el contrato de provider sigue congelado en 1.2.0.
v3.0.2 — Los install scripts por fin apuntan al módulo /v3
Tercer release del mismo día y cierre de la migración a /v3. El v3.0.1 movió el módulo, pero scripts/install.sh e install.ps1 seguían armando su target de go install por interpolación sobre el path /v2, así que la rewrite del string literal se los salteó.
El síntoma era feo justamente porque era silencioso: el fallback estable resolvía /v2@latest e instalaba v2.9.1 sin tirar un solo error, y GENTLE_AI_CHANNEL=beta resolvía /v2@main, que falla porque main ya es un módulo /v3. Lo reportó alguien de la comunidad en Discord.
Ahora ambos scripts apuntan a /v3/cmd/gentle-ai y —esto es lo que más vale— hay un test de regresión que deriva el major esperado desde go.mod, así que la próxima migración se rompe en CI antes de llegar a producción. Como los scripts se sirven crudos desde main, el curl ... | bash y el one-liner de PowerShell ya venían arreglados; este release hace que el tag también los lleve corregidos. Ninguna feature nueva, ningún breaking.
v3.0.0 — Organic Driven Development as the default workflow
A real major. From here on the orchestrator opens with Organic Driven Development (ODD) as the mandatory protocol on all four supported runtimes (Claude Code, OpenCode, Codex and Pi): a plain feature request now runs through explore, resolve, classify, track, implement and close without you asking for a workflow or task tracking.
When authorized work is substantial, it leaves a durable document at odd/tasks/<feature>.md with a full Engram mirror, so it survives interruptions and resumes. Implementation honors your configured TDD mode instead of guessing it.
Here is where the breaking changes live: SDD got lighter. Research is now an optional investigation rather than an admission certificate, verification is optional and diagnostic rather than a precondition, and archive proceeds from the true task state — unfinished work included — without requiring an attestation. Attempt-governance machinery and retired review projections were removed from internal/sddstatus and internal/cli. Still enforced: live grant integrity, artifact locators, task-progress routing and safe archive composition.
RDD leaves the SDD lifecycle but does not die: it stays a user-owned switch via gentle-ai review mode enable|disable|status, independent of whether the change came from ODD or SDD.
Three fixes ship alongside: globally installed agent artifacts no longer leak into the current project's working directory, contributor-only workflow skills stop travelling in the default preset, and a Windows-only CLI test flake is resolved.
One detail that bites on Windows: this major was still cut from the /v2 module, so go install rejects it. Fixed in v3.0.1 below. After upgrading, run gentle-ai sync.
v3.0.1 — Go module path /v3, installable again on every platform
A hotfix aimed straight at what v3.0.0 left behind: the major was cut from github.com/gentleman-programming/gentle-ai/v2, and Go refuses any v3.x.y version for a module path ending in /v2. The result: go install, install.ps1, source installs, the upgrade instruction printed by the binary and the gentle-pi Windows installer could not install v3.0.0. With no Windows binary archives, Windows users were locked out entirely.
The module path now lives at /v3: go.mod, every Go import, the GoReleaser ldflags symbol, scripts/install.sh, scripts/install.ps1, the instruction printed by gentle-ai upgrade, and the docs. The beta channel's self-upgrade path built its target with a literal /v2; it now appends /v3.
That is the breaking change: if you import the module or install from source, you must use /v3. A v3.0.0 binary still prints the old /v2 instruction, so upgrade that one binary by hand once. Everything shipped in v3.0.0 is unchanged and the provider contract stays byte-frozen at 1.2.0.
v3.0.2 — Install scripts finally target the /v3 module
Third release of the same day, closing out the /v3 migration. v3.0.1 moved the module, but scripts/install.sh and install.ps1 still assembled their go install target by interpolating over the /v2 path, so the literal-string rewrite skipped them.
The symptom was nasty precisely because it was silent: the stable fallback resolved /v2@latest and installed v2.9.1 without a single error, while GENTLE_AI_CHANNEL=beta resolved /v2@main, which fails because main is already a /v3 module. A community member reported it on Discord.
Both scripts now target /v3/cmd/gentle-ai and — the part that actually matters — a regression test derives the expected major from go.mod, so the next migration breaks in CI before it ships. Since the scripts are served raw from main, the curl ... | bash and PowerShell one-liners were already fixed; this release makes the tag carry the corrected scripts too. No new features, no breaking changes.
v3.0.0 — l'Organic Driven Development comme workflow par défaut
Une vraie version majeure. Désormais l'orchestrateur démarre avec l'Organic Driven Development (ODD) comme protocole obligatoire sur les quatre runtimes supportés (Claude Code, OpenCode, Codex et Pi) : une simple demande de fonctionnalité passe par explore, resolve, classify, track, implement et close sans que vous demandiez un workflow ou un suivi de tâches.
Quand le travail autorisé est conséquent, un document durable est créé dans odd/tasks/<feature>.md avec un miroir Engram complet, qui survit aux interruptions et aux reprises. L'implémentation respecte le mode TDD configuré au lieu de le deviner.
C'est ici que se trouvent les ruptures : SDD s'est allégé. Research devient une investigation optionnelle plutôt qu'un certificat d'admission, la vérification est optionnelle et diagnostique plutôt qu'une précondition, et archive procède depuis l'état réel des tâches — travail inachevé inclus — sans exiger d'attestation. La machinerie de gouvernance des tentatives et les projections de review retirées ont été supprimées de internal/sddstatus et internal/cli. Toujours appliqués : intégrité des grants vivants, locators d'artefacts, routage de progression des tâches et composition sûre de l'archive.
RDD quitte le cycle SDD sans disparaître : il reste un interrupteur contrôlé par l'utilisateur via gentle-ai review mode enable|disable|status, indépendamment du workflow ayant produit le changement.
Trois correctifs accompagnent la version : les artefacts d'agents installés globalement ne fuient plus dans le répertoire de travail du projet courant, les skills de workflow réservées aux contributeurs ne voyagent plus dans le preset par défaut, et un flake de test CLI propre à Windows est résolu.
Un détail qui pique sous Windows : cette majeure a été coupée depuis le module /v2, donc go install la refuse. Corrigé en v3.0.1 ci-dessous. Après la mise à jour, lancez gentle-ai sync.
v3.0.1 — Module Go /v3, de nouveau installable sur toutes les plateformes
Un correctif visant directement ce que v3.0.0 a laissé derrière : la majeure a été coupée depuis github.com/gentleman-programming/gentle-ai/v2, et Go refuse toute version v3.x.y pour un chemin de module se terminant par /v2. Résultat : go install, install.ps1, les installations depuis les sources, l'instruction de mise à jour affichée par le binaire et l'installateur gentle-pi pour Windows ne pouvaient pas installer v3.0.0. Sans archives binaires Windows, ces utilisateurs étaient totalement bloqués.
Le chemin du module vit désormais en /v3 : go.mod, tous les imports Go, le symbole ldflags de GoReleaser, scripts/install.sh, scripts/install.ps1, l'instruction affichée par gentle-ai upgrade et la documentation. Le chemin d'auto-mise à jour du canal beta construisait sa cible avec un /v2 littéral ; il ajoute maintenant /v3.
Voilà la rupture : si vous importez le module ou installez depuis les sources, utilisez /v3. Un binaire v3.0.0 affiche encore l'ancienne instruction /v2 : mettez à jour ce binaire une fois à la main. Tout ce qu'apportait v3.0.0 reste inchangé et le contrat de provider reste figé à 1.2.0.
v3.0.2 — Les scripts d'installation ciblent enfin le module /v3
Troisième version du même jour, qui clôt la migration vers /v3. v3.0.1 avait déplacé le module, mais scripts/install.sh et install.ps1 construisaient encore leur cible go install par interpolation sur le chemin /v2 : la réécriture de la chaîne littérale les avait ignorés.
Le symptôme était pénible parce qu'il était silencieux : le fallback stable résolvait /v2@latest et installait v2.9.1 sans la moindre erreur, tandis que GENTLE_AI_CHANNEL=beta résolvait /v2@main, qui échoue puisque main est déjà un module /v3. Un membre de la communauté l'a signalé sur Discord.
Les deux scripts ciblent désormais /v3/cmd/gentle-ai et — c'est le point essentiel — un test de régression dérive le major attendu depuis go.mod, donc la prochaine migration cassera en CI avant d'être publiée. Comme les scripts sont servis bruts depuis main, le curl ... | bash et le one-liner PowerShell étaient déjà corrigés ; cette version fait que le tag porte aussi les scripts corrigés. Aucune nouvelle fonctionnalité, aucune rupture.