Registre des évolutions

Anomalies, fonctionnalités, améliorations et découvertes : les noter, les trier, les promouvoir, les résoudre.

evolution_add

effortless_evolution_add — Stabilité : stable · projet

Consigne une évolution produit (type, titre, détail, statut, reporter, criticité, priorité). born_marker (optionnel) : fragment de texte stable qui nomme le défaut dans le code suivi par git ; fourni pendant un chantier, il fait refuser l'entrée si le défaut est né de ce chantier (corrige-le dedans). La réponse porte implication : les verbes suggérés, jamais déclenchés automatiquement.

💬 Vous demandez à l’agent

« Note une anomalie « L'export CSV perd les accents » de criticité 2, priorité 1. »

→ L’agent appelleeffortless_evolution_add

• type = Anomalie
• title = L'export CSV perd les accents
• criticality = 2
• priority = 1

Nom	Type	Requis	Description
type	string	oui	Marqueur de l'évolution : Découverte, Fonctionnalité, Amélioration, Anomalie ou Test. Obligatoire.
title	string	oui	Titre de l'évolution. Obligatoire.
detail	string	non	Texte de détail (défaut vide).
status	string	non	Statut initial : Planifié (défaut), En cours, En Attente, Résolu ou Retiré ; une entrée active dont le quota de type est atteint (hors Anomalie) est posée En Attente.
reporter	string	non	Personne ou agent qui rapporte l'entrée (texte libre, optionnel).
criticality	string	non	Niveau de criticité, entier de 1 à 3 où 1 est le plus urgent ; absent, l'entrée reste non classée.
priority	string	non	Niveau de priorité, entier de 1 à 3 où 1 est le plus urgent ; absent, l'entrée reste non classée.
born_marker	string	non	Fragment de texte stable qui nomme le défaut dans le code suivi par git (code de refus, nom de fonction, nom de test). S'il est fourni, le moteur vérifie si le défaut préexistait au premier commit de la story active et refuse l'entrée s'il est né de ce travail ; absent, l'entrée est acceptée avec une note « non classé ».

evolution_depends_on

effortless_evolution_depends_on — Stabilité : beta · projet

Déclare après quoi la graduation d'une évolution peut démarrer : elle est reléguée dans l'ordre tant que la cible n'est pas close, sans être retirée ni décomptée. Une target absente ou vide lève la dépendance. Refuse une cible inconnue, une dépendance à soi-même et tout cycle, dès l'écriture.

💬 Vous demandez à l’agent

« L'évolution 26FCT001 ne doit pas démarrer avant la clôture de l'épic 012 : déclare cette dépendance. »

→ L’agent appelleeffortless_evolution_depends_on

• evo_id = 26FCT001
• target = 012

Nom	Type	Requis	Description
evo_id	string	oui	Id de l'évolution qui attend. Obligatoire.
target	string	non	Id de l'évolution ou de l'epic dont la clôture la libère ; absent ou vide, la dépendance est levée.

evolution_edit

effortless_evolution_edit — Stabilité : beta · projet

Corrige une évolution : criticité, priorité et détail. La révision précédente du détail est conservée en ajout seul dans detail_revisions, jamais écrasée. Un statut terminal (Résolu ou Retiré) n'empêche pas la correction. Ne touche ni au titre, ni au statut, ni au type. Refuse un appel sans aucun champ.

💬 Vous demandez à l’agent

« Passe l'évolution 26FCT001 en criticité 1 et remplace son détail par : « Touche aussi l'import. » »

→ L’agent appelleeffortless_evolution_edit

• evo_id = 26FCT001
• criticality = 1
• detail = Touche aussi l'import.

Nom	Type	Requis	Description
evo_id	string	oui	Id de l'évolution à corriger. Obligatoire.
criticality	string	non	Nouveau niveau de criticité, entier de 1 à 3 où 1 est le plus urgent.
priority	string	non	Nouveau niveau de priorité, entier de 1 à 3 où 1 est le plus urgent.
detail	string	non	Texte de détail corrigé ; la révision précédente est conservée dans detail_revisions.

evolution_graduate

effortless_evolution_graduate — Stabilité : stable · projet

Promeut une évolution en épic : la rattache à l'épic existant epic_id, ou en crée un (et l'active) à partir de zone (+ title, description). Ne crée aucune story.

💬 Vous demandez à l’agent

« Promeus l'évolution 26FCT001 en épic dans la zone « rapports », sous le titre « Export fiable ». »

→ L’agent appelleeffortless_evolution_graduate

• evo_id = 26FCT001
• zone = rapports
• title = Export fiable

Nom	Type	Requis	Description
evo_id	string	oui	Id de l'évolution à promouvoir. Obligatoire.
zone	string	non	Zone fonctionnelle de l'epic à créer ; requise si epic_id est absent.
title	string	non	Titre de l'epic à créer (défaut : dérivé de l'id de l'évolution) ; ignoré si epic_id est fourni.
epic_id	string	non	Id d'un epic existant auquel rattacher l'évolution ; absent, un nouvel epic est créé à partir de zone puis activé.
description	string	non	Description de l'epic à créer (défaut vide) ; ignorée si epic_id est fourni.

evolution_list

effortless_evolution_list — Stabilité : stable · projet

Lecture seule. Liste les évolutions du registre du projet, avec un filtre optionnel par statut ou texte et une forme compacte optionnelle.

💬 Vous demandez à l’agent

« Liste les évolutions au statut « Planifié ». »

→ L’agent appelleeffortless_evolution_list

• status = Planifié

Nom	Type	Requis	Description
status	string	non	Filtre de statut exact : Planifié, En cours, En Attente, Résolu ou Retiré ; absent, aucun filtre de statut.
query	string	non	Sous-chaîne recherchée sans tenir compte de la casse dans id, title et detail uniquement ; absente ou vide, aucun filtre texte.
form	string	non	Forme de la réponse : full (défaut) ou compact ({id, status, title, epic}).

evolution_migrate_levels

effortless_evolution_migrate_levels — Stabilité : beta · projet

Réécrit les niveaux hérités du registre : convertit en entiers les valeurs libres reconnaissables, fait passer « Moyenne » au niveau 2 (les entrées ouvertes qui la portaient passent En attente, jamais les closes) et nomme dans son rapport chaque valeur qu'il n'a pas su convertir. Idempotent : rejoué, il ne touche plus rien.

💬 Vous demandez à l’agent

« Migre les niveaux de criticité et de priorité hérités du registre vers des entiers. »

→ L’agent appelleeffortless_evolution_migrate_levels

Aucun paramètre.

evolution_migrate_markers

effortless_evolution_migrate_markers — Stabilité : beta · projet

Convertit le champ type de chaque évolution héritée (finding, besoin, amélioration, refonte, chantier) vers l'un des cinq marqueurs déterministes. Idempotent ; aucun identifiant ne change.

💬 Vous demandez à l’agent

« Convertis les types hérités du registre des évolutions vers les cinq marqueurs actuels. »

→ L’agent appelleeffortless_evolution_migrate_markers

Aucun paramètre.

evolution_queue

effortless_evolution_queue — Stabilité : beta · projet

Lecture seule. La file du registre : les entrées actives déjà triées par la clé du moteur (dépendance non satisfaite, puis criticité, priorité, ancienneté, identifiant), bornées et filtrables par statut et par type. Répond à « par quoi reprendre ». Forme compacte, sans détail ni résolution ; une entrée se lit ensuite par son identifiant. Le total est rendu à côté de la fenêtre, pour qu'une file tronquée ne passe pas pour une file courte.

💬 Vous demandez à l’agent

« Par quelle évolution devrions-nous reprendre ? Donne-moi les cinq premières de la file. »

→ L’agent appelleeffortless_evolution_queue

• limit = 5

Nom	Type	Requis	Description
status	string	non	Ne garder qu'un statut ; absent, rend la file des entrées actives.
type_	string	non	Ne garder qu'un marqueur : Découverte, Fonctionnalité, Amélioration, Anomalie ou Test.
limit	integer	non	Taille de la fenêtre, plafonnée à 200 (défaut 25).

evolution_requalify

effortless_evolution_requalify — Stabilité : beta · projet

Requalifie une évolution entre Anomalie et Amélioration uniquement ; refuse toute autre paire de marqueur courant et cible. L'identifiant ne change jamais.

💬 Vous demandez à l’agent

« L'évolution 26FCT002 (« Export Excel ») est en fait une amélioration, pas une anomalie : requalifie-la en Amélioration. »

→ L’agent appelleeffortless_evolution_requalify

• evo_id = 26FCT002
• marker = Amélioration

Nom	Type	Requis	Description
evo_id	string	oui	Id de l'évolution à requalifier. Obligatoire.
marker	string	oui	Marqueur cible : Anomalie ou Amélioration uniquement (l'entrée doit porter actuellement l'autre). Obligatoire.

evolution_resolve

effortless_evolution_resolve — Stabilité : beta · sans projet

Résout une évolution sans exiger d'épic. Une raison est obligatoire. Refuse, en le nommant, un statut terminal ou un identifiant inconnu.

💬 Vous demandez à l’agent

« Marque l'évolution 26FCT001 comme résolue : « Corrigée dans la v1.4.1. » »

→ L’agent appelleeffortless_evolution_resolve

• evo_id = 26FCT001
• note = Corrigée dans la v1.4.1.

Nom	Type	Requis	Description
evo_id	string	oui	Id de l'évolution à résoudre. Obligatoire.
note	string	oui	Raison de la résolution ; sans elle, une évolution close est indiscernable d'une évolution oubliée. Obligatoire.

evolution_retire

effortless_evolution_retire — Stabilité : stable · projet

Écarte explicitement une évolution (statut Retiré) ; le motif est obligatoire. Fonctionne même sur une évolution déjà graduée, contrairement au retrait simple réservé à ce qui n'a pas encore de suite. Ne pose jamais Résolu.

💬 Vous demandez à l’agent

« Écarte l'évolution 26FCT001, motif : le besoin a disparu avec l'abandon de l'export Excel. »

→ L’agent appelleeffortless_evolution_retire

• evo_id = 26FCT001
• reason = Le besoin a disparu avec l'abandon de l'export Excel.

Nom	Type	Requis	Description
evo_id	string	oui	Id de l'évolution à retirer. Obligatoire.
reason	string	oui	Motif du retrait, toujours exigé. Obligatoire.

evolution_set_ready

effortless_evolution_set_ready — Stabilité : beta · projet

Pose ou lève ready_to_graduate sur une évolution. Refuse sur un statut terminal (Résolu ou Retiré), comme evolution_retire.

💬 Vous demandez à l’agent

« Marque l'évolution 26FCT001 comme prête à être promue en épic. »

→ L’agent appelleeffortless_evolution_set_ready

• evo_id = 26FCT001
• ready = true

Nom	Type	Requis	Description
evo_id	string	oui	Id de l'évolution. Obligatoire.
ready	boolean	oui	Nouvelle valeur du drapeau ready_to_graduate. Obligatoire.