nas-runbooks/common/GSTACK-EVALUATION-MACBOOK-V...

4.4 KiB

gstack (garrytan/gstack) — evaluation et decision d'installation

Contexte

gstack est un ensemble de skills Claude Code (23 commandes core, ~50 avec les sous-outils) qui simule une equipe d'ingenierie complete : CEO, Designer, Eng Manager, QA, Release Manager. Cree par Garry Tan (PDG YC), MIT, open-source. Repo : https://github.com/garrytan/gstack

Evalue le 02/07/2026 pour un deploiement sur hermes-perso. Ecarte au profit d'une installation locale sur le futur MacBook M5 Pro via Claude Code natif.

Pourquoi PAS sur hermes-perso (ni sur hermes-tt/hermes-nyora en l'etat)

  1. Memoire container insuffisante. hermes-agent-perso tourne avec mem_limit: 600m et memswap_limit: 600m identiques (pas de swap de secours). Chromium/Playwright (utilise par GStack Browser, /qa, /open-gstack-browser, /design-review) consomme 300-500 Mo rien qu'au lancement, en plus du runtime Bun et du process agent deja en place. Risque d'OOM kill quasi certain sans remonter la limite -- ce qui reporte la pression sur les 19 Go RAM globaux du NAS (10 Go disponibles apres cache au moment de l'audit).

  2. Routage modele incompatible avec la regle DeepSeek exclusif. gstack route certaines briques (GStack Browser notamment) vers Sonnet (actions) / Opus (analyse) via cle Anthropic native. hermes-agent-perso n'a dans son environnement que OPENROUTER_API_KEY et OPENCODE_GO_API_KEY -- aucune cle Anthropic directe. Installer gstack tel quel casse soit le routing intelligent de gstack (tout en DeepSeek, degrade), soit la regle "modele exclusif DeepSeek V4 Flash" du stack Hermes.

  3. Bug upstream non resolu : AskUserQuestion vs clarify. Issue GitHub gstack #2015 (encore ouverte a la derniere verification) : les skills generes en mode --host hermes referencent encore AskUserQuestion (outil natif Claude Code) au lieu de clarify (outil natif Hermes Agent pour les questions interactives). Les boucles STOP + confirmation de gstack (/plan-ceo-review, /plan-eng-review) risquent de mal se declencher ou de retomber en texte brut demandant de repondre par une lettre plutot que des choix cliquables.

  4. Densite de skills. hermes-perso a deja ~75 skills actifs (superpowers, vercel-agent-skills, agent-browser, deep-research, kanban-workflow, etc.). +20 skills gstack augmente le risque de mauvaise selection par l'agent -- meme classe de piege que le skill local pptx-presentation qui gagnait systematiquement sur nyora-doc-api (cf. capitalisation 02/07/2026).

Ce qui fonctionne quand meme cote Hermes

gstack supporte nativement ./setup --host hermes (fichier hosts/hermes.ts dans le repo, reecrit les noms d'outils generiques Bash/Read/Write/Edit vers l'equivalent Hermes). Un utilisateur tiers (cite dans l'issue #2015) fait tourner /autoplan, /review, /ship en production quotidienne dans Hermes -- donc l'incompatibilite n'est pas totale, elle est concentree sur la brique navigateur + le routing modele + le bug clarify.

Decision actee

Installation de gstack sur le futur MacBook M5 Pro, via Claude Code natif (deja installe en mai 2026 -- npm install -g @anthropic-ai/claude-code). Pas de contrainte RAM container, acces Anthropic natif disponible, pas de conflit avec la regle DeepSeek exclusif (celle-ci ne s'applique qu'aux instances Hermes).

Point GitHub/Gitea -- non tranche, a traiter seulement si besoin confirme

gstack detecte la plateforme d'hebergement Git depuis l'URL du remote et bascule entre gh (GitHub) et glab (GitLab) -- logique deja presente et extensible, trouvee dans document-release/SKILL.md. Pas de branche tea (CLI officiel Gitea) nativement supportee. Seules 3-4 commandes sur 23 touchent a un forge Git : /ship, /document-release, /spec. Le reste (/office-hours, /plan-ceo-review, /plan-eng-review, /design-review, /qa, /review) est purement local, aucune dependance a GitHub/Gitea.

Si /ship s'avere indispensable a l'usage : fork cible sur ces 3-4 skills, remplacer les appels gh issue create / gh pr create / gh pr view par leurs equivalents tea issues create / tea pulls create / tea pulls list. Ne pas fork preventivement -- tester d'abord la boucle sans forge.

Regle absolue rappelee

Tous les repos vont sur Gitea auto-heberge (bolbol/*), jamais GitHub -- donc meme en cas d'usage gstack sur MacBook, tout push de code produit reste sur Gitea. gstack peut etre clone depuis GitHub (lecture seule, outil tiers), mais aucun repo de travail personnel/Nyora/TT ne doit etre pousse sur GitHub.