diff --git a/common/GSTACK-EVALUATION-MACBOOK-VS-HERMES.md b/common/GSTACK-EVALUATION-MACBOOK-VS-HERMES.md
new file mode 100644
index 0000000..78b1130
--- /dev/null
+++ b/common/GSTACK-EVALUATION-MACBOOK-VS-HERMES.md
@@ -0,0 +1,79 @@
+# 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.