grahama1970/agent-status

Que fait agent-status ?

Utilisez cette compétence chaque fois qu'un agent de projet effectue un travail en plusieurs étapes et que l'humain a besoin de savoir ce qui se passe réellement.

Cette compétence n'est intentionnellement pas un générateur de tableau de bord. Elle produit une surface de vérité soutenue par des artefacts lisibles par machine :

.plan-iterate/<campaign-id>/status/
  status.json
  events.jsonl
  proof_manifest.json
  STATUS.html

Le HTML ne fait que restituer l'artefact de statut actuel. Il ne doit pas inventer de progression, de pourcentages ou d'affirmations d'achèvement.

Principe de base

d'abord l'artefact de statut → le HTML restitue l'artefact → l'humain peut inspecter la preuve

Ne faites jamais ceci :

d'abord la page jolie → un langage vert et vague → l'humain en déduit la progression

Réponses requises dans la première zone d'affichage

Une page de statut générée doit répondre :

1. Qu'est-ce que l'agent essaie de terminer ?
2. Où en sommes-nous exactement ?
3. Qu'est-ce qui vient de réussir ?
4. Qu'est-ce qui n'est toujours pas prouvé ?
5. Quelle est la prochaine action ?
6. L'agent est-il en cours d'exécution, bloqué, inactif ou en attente de l'humain ?
7. Quelle preuve soutient l'affirmation actuelle ?
8. Que ne doit pas faire l'agent ensuite ?

Modèle d'état

États autorisés :

• not_started
• running
• needs_attention
• blocked
• failed
• passed_scoped_gate
• done
• idle

Distinction importante :

passed_scoped_gate != done

N'utilisez done que lorsque l'objectif final déclaré possède un artefact de preuve final explicite.

Commandes courantes

Initialiser une campagne :

./run.sh init \
  --campaign refactor-harness-e2e \
  --goal "Terminer la preuve E2E du harnais de refactorisation limité"

Marquer un jalon comme en cours :

./run.sh update \
  --campaign refactor-harness-e2e \
  --state running \
  --current-step "Exécuter la porte de résumé LLM concurrente renforcée + OpenCode"

Enregistrer un jalon limité réussi :

./run.sh gate-passed \
  --campaign refactor-harness-e2e \
  --label "A01-A18 porte de résumé LLM concurrente renforcée + OpenCode" \
  --verdict PASS_SPEC \
  --proof ".plan-iterate/refactor-harness-e2e/proof/refactor-concurrent-mixed.json" \
  --next-action "Démarrer la phase de dossier de relecture + de convergence des relecteurs" \
  --not-proven "Interface utilisateur de la salle B1 de Transport" \
  --not-proven "build_review_packet convergence des relecteurs" \
  --not-proven "Livraison complète des messages OpenCode"

Demander une décision à l'humain :

./run.sh needs-human \
  --campaign refactor-harness-e2e \
  --question "Quelle prochaine campagne l'agent doit-il exécuter ?" \
  --option "A=Continuer le harnais : dossier de relecture + convergence des relecteurs" \
  --option "B=Interface utilisateur Transport : démarrer la salle B1" \
  --option "C=Stabiliser uniquement : point de contrôle et arrêt"

Restituer à nouveau la page de statut :

./run.sh render --campaign refactor-harness-e2e

Règles anti-théâtre de tableau de bord

1. Pas de pourcentages.
2. Pas de « terminé » en vert sauf si une preuve d'objectif final existe.
3. Chaque SUCCÈS doit nommer son artefact de preuve.
4. Chaque statut doit montrer ce qui n'est pas prouvé.
5. Chaque état inactif doit dire pourquoi l'agent est inactif.
6. Chaque état d'attente humaine doit inclure un menu de décision.
7. Chaque état bloqué doit nommer l'artefact, le service, la porte ou la décision manquants.
8. L'actualisation automatique est autorisée uniquement si la page lit status.json.
9. Si status.json est obsolète, la page doit l'indiquer.
10. Les verdicts de relecture sont des reçus, pas des preuves d'achèvement.

Quand utiliser

Utilisez cette compétence pour :

• /plan-iterate
• /orchestrate
• /review-design
• /review-code
• /debugger
• /ask deep-review
• /code-runner
• /subagent-runner
• tout travail d'agent-projet en plusieurs étapes durant plus d'une commande ciblée

Attentes concernant les artefacts

status.json est la source de vérité.

events.jsonl est en ajout seulement et enregistre les transitions d'état.

proof_manifest.json liste les artefacts de preuve nommés par les affirmations de statut.

STATUS.html est généré, sensible à l'obsolescence et peut être ouvert en toute sécurité dans un navigateur.

Norme d'achèvement

Une réponse finale pour un travail d'agent de longue durée doit résumer l'artefact de statut actuel et lier ou citer le chemin STATUS.html lorsqu'il est disponible.

Ne revendiquez pas l'achèvement sauf si :

• l'état est done ;
• last_completed.proof_path pointe vers un artefact de preuve final ;
• not_proven est vide ou explicitement hors de portée ;
• les bloqueurs sont vides.