80 lines
4.4 KiB
Markdown
80 lines
4.4 KiB
Markdown
# 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.
|