Skip to content

Commit 09d2ed2

Browse files
AmadouMamaneclaude
andcommitted
Ephor 1.1.4 : plafond de réponse d'opencode, alerte de contexte, planner sans terminal
- opencode coupe chaque réponse à 32 000 tokens, réflexion comprise (anomalyco/opencode#29363). Au plus haut niveau d'effort, et même en high, la réflexion du planner le remplissait : réponse vide, sans erreur, après 5 à 17 minutes. Le greffon relève le plafond de chaque requête jusqu'à la limite du modèle (au plus le quart de sa mémoire), sauf si le poste a fixé OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX. Mesuré sous opencode 1.18.32 : 128 000 demandés au lieu de 32 000. - Une réponse coupée est annoncée à l'écran, et l'agent qui a délégué reçoit la raison avec la réponse vide. - Alerte de contexte : au-delà de 60 %, un message en fin de tour (/handoff, puis une nouvelle session). Exacte sous opencode ; supposée sous Claude Code, dont les hooks ignorent la taille de la mémoire (EPHOR_CONTEXTE_TOKENS la déclare) ; rien sous Copilot. - Le planner n'a plus l'ordre de lancer la carte du dépôt, qu'il n'a pas le droit de lancer : l'agent qui l'appelle la lui passe. Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
1 parent 37cde46 commit 09d2ed2

19 files changed

Lines changed: 488 additions & 15 deletions

File tree

‎.claude/agents/planner.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,9 @@ vrai : chaque détail technique inventé trop tôt devient une contrainte que pe
2323

2424
1. Lis `tasks/README.md`, puis `docs/00-beliefs.md` et `docs/01-architecture.md` s'ils
2525
existent (Ephor ne les pose dans un dépôt existant que sur demande).
26-
2. Dépôt existant : `bash .ephor/scripts/repo_map.sh`, puis au plus cinq fichiers ciblés.
26+
2. Dépôt existant : pars de la carte du dépôt que la demande te fournit (`make map`). Tu
27+
n'as pas de terminal : sans carte, repère les dossiers de code et de tests avec Glob.
28+
Puis au plus cinq fichiers ciblés.
2729
3. Liste les inconnues avant les certitudes. Une question non posée coûte plus cher.
2830
4. Choisis le risque : `faible` (local, sans enjeu), `modere` (fonctionnalité, contrat
2931
d'API compatible), `eleve` (authentification, argent, données, droits, migration).

‎.claude/settings.json‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -179,6 +179,11 @@
179179
"type": "command",
180180
"command": "\"${CLAUDE_PROJECT_DIR}/.ephor/hooks/checkpoint.sh\"",
181181
"timeout": 30
182+
},
183+
{
184+
"type": "command",
185+
"command": "\"${CLAUDE_PROJECT_DIR}/.ephor/hooks/contexte.sh\"",
186+
"timeout": 10
182187
}
183188
]
184189
}

‎.claude/skills/brownfield-onboard/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,8 @@ et pourquoi il ne faut pas les lire.
5151
## Étape 4 — Un premier contrat, minuscule
5252

5353
Pas de contrat sur du code que personne n'a relu. Prends la plus petite demande réelle et
54-
fais préparer par le sous-agent `planner` un contrat d'un seul critère. L'opérateur le
55-
crée (`make task-new`), le relit et le commite sur la branche principale. `make judge`
54+
fais préparer par le sous-agent `planner` un contrat d'un seul critère, en lui passant la
55+
carte de l'étape 1 : il n'a pas de terminal. L'opérateur le crée (`make task-new`), le relit et le commite sur la branche principale. `make judge`
5656
doit alors fonctionner de bout en bout : c'est le test d'Ephor, pas celui du code.
5757

5858
## Étape 5 — Contraintes mécaniques, progressivement

‎.claude/skills/feature/SKILL.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,8 @@ Contrats disponibles :
2121

2222
**1. Un contrat approuvé, avant tout code.**
2323
S'il n'existe pas de `tasks/<ID>/contract.json` sur la branche principale, délègue au
24-
sous-agent `planner`. Donne son contrat et ses tests d'acceptation à l'opérateur, puis
24+
sous-agent `planner`, avec la sortie de `make map` dans la demande : il n'a pas de
25+
terminal pour la faire lui-même. Donne son contrat et ses tests d'acceptation à l'opérateur, puis
2526
**arrête-toi** : c'est lui qui les crée (`make task-new`, ou `FROM=` sur le plan que tu
2627
lui rends), les relit, les voit échouer (`make task-check`) et les commite sur
2728
`main`. Tu ne peux ni écrire dans `tasks/`, ni commencer sans ce commit.

‎.ephor/CHANGELOG.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,37 @@
33
Une entrée par version : ce qui change pour qui s'en sert. Les raisons de fond sont dans
44
`.ephor/docs/adr/`. La version en place est dans `.ephor/VERSION`.
55

6+
## 1.1.4 — 29 septembre 2026
7+
8+
Le sous-agent `planner`, vu échouer sur un vrai projet, et la règle des 60 % de contexte,
9+
que personne n'appliquait.
10+
11+
- **Le plafond de réponse d'opencode est relevé.** opencode coupe chaque réponse à 32 000
12+
tokens, réflexion comprise, quel que soit le modèle (défaut connu, ouvert chez lui). Au
13+
plus haut niveau d'effort, et même en `high`, la réflexion du planner le remplissait :
14+
quatre échecs à 32 000 tokens de réflexion et 0 de réponse, de 5 à 17 minutes chacun, et
15+
environ 4,60 $ pour rien. Le greffon relève maintenant le plafond de chaque requête jusqu'à
16+
la limite du modèle, sans dépasser le quart de sa mémoire. Au plus haut niveau, le même
17+
planner a répondu en 132 secondes, pour le prix d'une réussite en `high`, avec un meilleur
18+
contrat. Un poste qui a fixé `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` garde son choix.
19+
- **Une réponse coupée ne passe plus en silence.** opencode finissait le tour comme si de
20+
rien n'était ; l'agent qui avait délégué recevait du vide et concluait, une demi-heure
21+
plus tard, que le planner « n'était fiable que sur les demandes triviales ». Le greffon
22+
l'affiche à l'écran, et l'agent reçoit la raison avec la réponse.
23+
- **L'alerte de contexte.** Au-delà de 60 % de la mémoire du modèle, un message en fin de
24+
tour : `/handoff`, puis une nouvelle session. Ephor ne vide rien lui-même. Sous opencode,
25+
le pourcentage est exact. Sous Claude Code, dont les hooks ignorent la taille de la
26+
mémoire, elle est supposée et le message le dit ; `EPHOR_CONTEXTE_TOKENS` la déclare.
27+
Rien sous Copilot, qui ne donne ses tokens qu'à la fermeture de la session.
28+
- **On demandait au planner de lancer la carte du dépôt, sans terminal.** Ses droits le lui
29+
interdisent, à raison : il ne fait que lire. C'est désormais l'agent qui l'appelle qui lui
30+
passe la carte (`make map`) ; à défaut, il se repère avec ses outils de lecture. Un test
31+
refuse qu'un sous-agent sans terminal reçoive l'ordre de lancer un script.
32+
33+
Dans un projet équipé : `bootstrap_existing_repo.sh --mettre-a-jour`, puis relancer opencode
34+
pour qu'il recharge son greffon. Rien à installer sur le poste, et rien à reprendre pour
35+
Copilot.
36+
637
## 1.1.3 — 27 septembre 2026
738

839
Relecture des textes : des formulations neutres, partageables telles quelles (exemples du

‎.ephor/VERSION‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Ephor 1.1.3 — 27 septembre 2026
1+
Ephor 1.1.4 — 29 septembre 2026

‎.ephor/adapters.py‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,9 @@
5454
REGLE = re.compile(r"^([A-Za-z]+)(?:\((.*)\))?$")
5555
VERSION = re.compile(r"\b\d+\.\d+\.\d+\b")
5656
BLOC_SHELL = re.compile(r"```!\n(.+?)\n```", re.S)
57-
# Hooks que Copilot ne sait pas exploiter : il ignore `matcher` et ne réécrit pas l'appel.
58-
HOOKS_HORS_COPILOT = ("filter-output.sh",)
57+
# Hooks que Copilot ne sait pas exploiter : il ignore `matcher` et ne réécrit pas l'appel ;
58+
# il n'écrit ses tokens qu'à la fermeture de la session, donc pas de remplissage à mesurer.
59+
HOOKS_HORS_COPILOT = ("filter-output.sh", "contexte.sh")
5960
# Garde-fous que seul Copilot a besoin qu'on lui branche : Claude Code et opencode
6061
# appliquent déjà ces refus par leurs permissions. (write-guard.sh n'en est plus : depuis que
6162
# les zones vivent dans le moteur, les trois outils le lancent, et il est dans les réglages.)

‎.ephor/docs/07-token-budget.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,14 @@ dans `.claude/settings.json` de ce template — remontez-le pour les phases d'ar
190190
Les modèles à raisonnement adaptatif ignorent un budget non nul : chez eux, seul le
191191
niveau d'effort compte.
192192

193+
Plus d'effort demande plus de place : la réflexion est comptée dans la réponse. opencode
194+
plafonne une réponse à 32 000 tokens ; au plus haut niveau, la réflexion du `planner` le
195+
remplissait et la réponse sortait vide. Le greffon d'Ephor relève ce plafond jusqu'à la
196+
limite du modèle, et dit quand une réponse est coupée (`.ephor/docs/11-trois-agents.md`).
197+
Baisser l'effort n'est pas le remède : en `high`, le planner a aussi été coupé, et au plus
198+
haut niveau, avec la place, il a rendu un meilleur contrat pour le même prix (un essai,
199+
le 29/09/2026).
200+
193201
### 2.8 Hygiène de session
194202

195203
- `/clear` entre deux tâches sans rapport. Un contexte périmé est repayé à **chaque**

‎.ephor/docs/11-trois-agents.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,32 @@ des skills à entretenir.
8181
n'arrête l'agent que s'il dépasse déjà le plafond. opencode n'a pas de plafond par tâche.
8282
Sous Claude Code, les sous-agents comptent : chacun écrit son propre journal, lu avec
8383
celui de la session (un tiers d'une vraie session y était invisible, le 25/09/2026).
84+
- **Le plafond d'une réponse.** opencode coupe chaque réponse à 32 000 tokens, réflexion
85+
comprise, quel que soit le modèle (défaut connu, ouvert :
86+
<https://github.com/anomalyco/opencode/issues/29363>). Quand la réflexion le remplit, le
87+
tour finit sans réponse et sans erreur. Mesuré le 28/09/2026 sur le `planner` (Sonnet 5 via
88+
Copilot) : quatre échecs, au plus haut niveau d'effort et même en `high`, chacun terminé à
89+
32 000 tokens de réflexion et 0 de réponse, après 5 à 17 minutes ; l'agent qui l'appelait
90+
recevait du vide et concluait que le planner « n'était fiable que sur les demandes
91+
triviales ». L'agent principal y échappe presque toujours : il avance par petites
92+
réponses, le planner doit tout rendre en une seule. Le greffon relève
93+
donc le plafond de chaque requête jusqu'à la limite du modèle, sans dépasser le quart de
94+
sa mémoire (pour Sonnet 5 via Copilot : 128 000) : le même planner, au plus haut niveau, a
95+
répondu en 132 secondes, 12 955 tokens de réflexion, sans erreur. Un poste qui fixe
96+
`OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` garde son choix. Si une réponse est encore coupée,
97+
opencode ne dit rien, le greffon si : un message à l'écran, et l'agent qui a délégué reçoit
98+
la raison avec la réponse vide. Relever le plafond ne touche pas au moment où opencode
99+
compacte la conversation (lu dans son code, 1.18.32). Sa branche v2 abandonne ce plafond.
100+
Claude Code demande la limite du modèle quand il le reconnaît, et 32 000 sinon, par exemple
101+
derrière une passerelle qui renomme les modèles : `CLAUDE_CODE_MAX_OUTPUT_TOKENS` le relève.
102+
- **L'alerte de contexte.** La règle « contexte au-delà de 60 % : `/handoff`, puis une
103+
nouvelle session » n'était appliquée par personne : l'agent ne voit pas son remplissage.
104+
À chaque fin de tour, `contexte.sh` le dit à l'opérateur, sans rien vider lui-même (vider
105+
avant que l'état soit écrit perdrait du travail). opencode : un message à l'écran, calculé
106+
comme le pourcentage qu'il affiche. Claude Code : un message sous la réponse ; ses hooks ne
107+
connaissent pas la taille de la mémoire du modèle, Ephor la suppose (200 000, ou un million
108+
dès que la conversation dépasse 200 000) et le dit ; `EPHOR_CONTEXTE_TOKENS` la déclare.
109+
Copilot ne donne ses tokens qu'à la fermeture de la session : pas d'alerte.
84110
- **La sentinelle** regarde le résultat, pas le moyen : au début du tour, elle photographie
85111
les zones de contrôle ; à la fin, une zone changée pendant le tour, par quelque chemin
86112
que ce soit, pose `AGENT_STOP` avec la liste des fichiers. Sous Claude Code et Copilot
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"name": "ephor",
3-
"version": "1.1.3",
3+
"version": "1.1.4",
44
"description": "Relais des garde-fous du dépôt ouvert : bouton d'arrêt, anti-secret, périmètre du contrat, dépôts de référence, zones de contrôle."
55
}

0 commit comments

Comments
 (0)