# Workflow Claude-GLM -- Nyora API Builder

**Date** : 2026-06-17 (rev 2)
**Scope** : hermes-nyora (GLM-5.1 via opencode-go) + Telegram bot
**Objectif** : Economiser les tokens Claude -- garder Claude pour le strategique

---

## Architecture

  PLANNER   -> Claude (discussion + accord + generation plan)
  EXECUTOR  -> hermes-nyora / GLM-5.1 via Telegram (implementation)
  REVIEWER  -> Claude (validation finale, problemes critiques uniquement)

Ratio economies tokens : ~7x (Claude = 20-30k, GLM = 150k+)

---

## Workflow complet (4 etapes)

### Etape 1 -- Discussion et accord (session Claude)

Nabil decrit son projet librement a Claude.
Claude pose les questions necessaires :
  - Stack existante et contraintes
  - Perimetre exact de l API / feature
  - Integrations (Bifrost, Baserow, n8n, etc.)
  - Chemin du repo Gitea

Pas de template a remplir avant -- la discussion IS le template.
Accord explicite avant de passer a l etape 2.

### Etape 2 -- Generation du plan (Claude)

Claude genere un PLAN.md complet et structure.
Format : PROJECT / CONTEXT / TECH STACK / PHASES / REVIEW CRITERIA
Maximum 5 phases. Chaque phase : GOAL + TASKS + FILES + VALIDATION.
Claude inclut les criteres de review qu il utilisera a l etape 4.

### Etape 3 -- Execution (Telegram -> hermes-nyora)

Nabil copie-colle le PLAN.md dans le Telegram bot hermes-nyora.
hermes-nyora active automatiquement le skill claude-glm-workflow.
Execution phase par phase avec rapport standardise.
hermes-nyora genere HANDOFF.md a la fin.

  Bot Telegram hermes-nyora : token 8914117708:AAHNysUFMy8eFRagLmcNMvCkiCuArf0aZMs
  allowed_chats : '' (tous les chats autorises par defaut)

### Etape 4 -- Review finale (session Claude)

Nabil copie HANDOFF.md + prompt review dans Claude.
Prompt review disponible dans : workspace/templates/claude-plan-template.md
Claude identifie uniquement les problemes critiques et majeurs.
Verdict : Ready to deploy | Needs fixes.

---

## Fichiers deployes

  hermes-nyora/data/skills/nyora/claude-glm-workflow/SKILL.md
  hermes-nyora/data/workspace/templates/claude-plan-template.md
  hermes-nyora/data/SOUL.md (section WORKFLOW CLAUDE-GLM)

---

## Modele et couts

  Modele actuel  : glm-5.1 (opencode-go, $10/mois = $60 valeur)
  Fallback       : qwen3.7-plus (opencode-go)
  GLM-5.2        : disponible semaine 22 juin -- changer config.yaml model.default

---

## Pieges connus

- SOUL.md et config.yaml : 100% ASCII obligatoire
- hermes-nyora voit /opt/data/workspace/ (pas /workspace/)
- Bifrost requis pour tout LLM depuis n8n (opencode.ai inaccessible)
---

## Bonne pratique -- Plans longs (> limite Telegram)

Pour tout plan depasse quelques centaines de caracteres :

  1. Claude depose le PLAN.md dans /opt/data/workspace/plans/<projet>.md via MCP
  2. Nabil envoie UNE LIGNE dans Telegram :
       Execute le plan : /opt/data/workspace/plans/<projet>.md
  3. hermes-nyora lit le fichier et execute normalement

Avantages : plans illimites en taille, historique des plans conserve sur le NAS,
relance facile sans re-coller le prompt, traçabilite Gitea possible.

Convention nommage : <slug-projet>-YYYYMMDD.md (ex: panda-theme-switcher.md)