Cadrage

Documents de cadrage, décisions, questions, brouillons et propositions, recettes.

bqo_ask

effortless_bqo_ask — Stabilité : stable · projet

Consigne une grande question ouverte (BQO) au niveau projet.

💬 Vous demandez à l’agent

« Note cette grande question ouverte au niveau du projet : « Faut-il migrer l'authentification vers OAuth2 ? » »

→ L’agent appelleeffortless_bqo_ask

• question = Faut-il migrer l'authentification vers OAuth2 ?

Nom	Type	Requis	Description
question	string	oui	Texte de la grande question ouverte (BQO) à consigner au niveau du projet. Obligatoire.

bqo_graduate

effortless_bqo_graduate — Stabilité : stable · projet

Promeut une BQO vers un épic EXISTANT (epic_id) : la question y est copiée et passe au statut graduated. Ne crée pas d'épic.

💬 Vous demandez à l’agent

« Promeus la grande question Q-02 vers l'épic existant 012. »

→ L’agent appelleeffortless_bqo_graduate

• question_id = Q-02
• epic_id = 012

Nom	Type	Requis	Description
question_id	string	oui	Id de la BQO à promouvoir en epic. Obligatoire.
epic_id	string	oui	Id de l'epic cible existant qui hérite de la BQO. Obligatoire.

bqo_list

effortless_bqo_list — Stabilité : stable · projet

Liste les grandes questions ouvertes (BQO) du projet.

💬 Vous demandez à l’agent

« Liste les grandes questions ouvertes du projet. »

→ L’agent appelleeffortless_bqo_list

Aucun paramètre.

bqo_resolve

effortless_bqo_resolve — Stabilité : stable · projet

Répond à une question du projet (statut résolu). Refuse une question déjà graduée en épic.

💬 Vous demandez à l’agent

« Réponds à la question Q-02 : « Non, on reste sur les sessions par cookie jusqu'à la v2. » »

→ L’agent appelleeffortless_bqo_resolve

• question_id = Q-02
• answer = Non, on reste sur les sessions par cookie jusqu'à la v2.

Nom	Type	Requis	Description
question_id	string	oui	Id de la question projet (BQO) à résoudre ; une question déjà graduée en epic est refusée. Obligatoire.
answer	string	oui	Réponse qui tranche la question. Obligatoire.

cadrage_docs_scaffold

effortless_cadrage_docs_scaffold — Stabilité : stable · story

Génère les stubs OPALE manquants d'une story dans blueprints/. Renvoie les fichiers créés.

💬 Vous demandez à l’agent

« Génère les documents de cadrage manquants pour la story 003 de l'épic 012. »

→ L’agent appelleeffortless_cadrage_docs_scaffold

• epic_id = 012
• story_id = 003

Nom	Type	Requis	Description
epic_id	string	oui	Id de l'epic qui porte la story. Obligatoire.
story_id	string	oui	Id de la story dont les stubs OPALE manquants sont générés sous blueprints/. Obligatoire.

cadrage_layer_next

effortless_cadrage_layer_next — Stabilité : beta · projet

Prochaine couche de cadrage projet à rédiger parmi les 4 blueprints racine.

💬 Vous demandez à l’agent

« Quelle est la prochaine couche de cadrage à rédiger pour le projet ? »

→ L’agent appelleeffortless_cadrage_layer_next

Aucun paramètre.

decision_add

effortless_decision_add — Stabilité : stable · story

Ajoute une décision (ADR) à une story. Renvoie l'id (DEC-NN).

💬 Vous demandez à l’agent

« Consigne la décision « SQLite plutôt que Postgres » sur la story 003 de l'épic 012, en phase O-analyse. Contexte : l'application reste mono-poste. Décision : utiliser SQLite. Conséquence : aucun serveur de base à installer. Alternative écartée : Postgres. »

→ L’agent appelleeffortless_decision_add

• epic_id = 012
• story_id = 003
• title = SQLite plutôt que Postgres
• context = L'application reste mono-poste.
• decision = Utiliser SQLite.
• consequences = Aucun serveur de base à installer.
• rejected_alternatives = Postgres
• phase = O-analyse

Nom	Type	Requis	Description
epic_id	string	oui	Id de l'epic qui porte la story. Obligatoire.
story_id	string	oui	Id de la story qui reçoit la décision. Obligatoire.
title	string	oui	Titre de la décision. Obligatoire.
context	string	oui	Contexte de la décision. Obligatoire.
decision	string	oui	La décision prise. Obligatoire.
consequences	any	oui	Conséquences : tableau de chaînes, ou chaîne multi-lignes avec une entrée par ligne. Obligatoire.
rejected_alternatives	any	oui	Alternatives rejetées : tableau de chaînes, ou chaîne multi-lignes avec une entrée par ligne. Obligatoire.
phase	string	oui	Phase OPALE de la décision, sous forme d'id de phase du workflow (workflow par défaut : O-analyse, P-cadrage, A-specs, L-plan, E-execute). Obligatoire.

decisions_list

effortless_decisions_list — Stabilité : stable · projet

Liste toutes les décisions (ADR) du projet avec leur origine epic/story.

💬 Vous demandez à l’agent

« Liste toutes les décisions prises sur le projet. »

→ L’agent appelleeffortless_decisions_list

Aucun paramètre.

draft_add

effortless_draft_add — Stabilité : beta · projet

Ajoute un draft (proposition de story) à un epic. Renvoie l'id.

💬 Vous demandez à l’agent

« Ajoute à l'épic 012 un brouillon de story « Export CSV des rapports » avec deux tâches proposées : le format et le bouton d'export. »

→ L’agent appelleeffortless_draft_add

• epic_id = 012
• title = Export CSV des rapports
• proposed_tasks = ["Le format","Le bouton d'export"]

Nom	Type	Requis	Description
epic_id	string	non	Epic qui reçoit le draft (défaut : epic actif).
title	string	oui	Titre du draft de story. Obligatoire.
summary	string	non	Résumé court du draft de story (défaut vide).
kind	string	non	Type de story : opale (défaut) ou fix.
depends_on	array<string>	non	Ids dont dépend le draft de story (défaut aucun).
proposed_tasks	array<string>	non	Liste des tâches proposées pour la story, sous forme de chaînes (défaut aucune).
rationale	string	non	Justification du draft (défaut vide).

draft_list

effortless_draft_list — Stabilité : beta · projet

Liste les drafts d'un epic (défaut : epic actif).

💬 Vous demandez à l’agent

« Montre-moi les brouillons de story de l'épic actif. »

→ L’agent appelleeffortless_draft_list

Nom	Type	Requis	Description
epic_id	string	non	Epic dont on liste les drafts (défaut : epic actif).

draft_reject

effortless_draft_reject — Stabilité : beta · projet

Rejette un draft (draft|pending → rejected).

💬 Vous demandez à l’agent

« Rejette le brouillon D-04 de l'épic 012, il ne sera pas fait. »

→ L’agent appelleeffortless_draft_reject

• epic_id = 012
• draft_id = D-04

Nom	Type	Requis	Description
epic_id	string	non	Epic qui porte le draft (défaut : le draft est cherché dans tous les epics ; si plusieurs portent cet id, l'epic actif est utilisé, sinon l'appel est refusé en nommant les candidats).
draft_id	string	oui	Id du draft (par exemple DFT-01) ; il n'est unique qu'au sein de son epic. Obligatoire.

draft_submit

effortless_draft_submit — Stabilité : beta · projet

Soumet un draft (draft → pending).

💬 Vous demandez à l’agent

« Soumets le brouillon D-04 de l'épic 012 à validation. »

→ L’agent appelleeffortless_draft_submit

• epic_id = 012
• draft_id = D-04

Nom	Type	Requis	Description
epic_id	string	non	Epic qui porte le draft (défaut : le draft est cherché dans tous les epics ; si plusieurs portent cet id, l'epic actif est utilisé, sinon l'appel est refusé en nommant les candidats).
draft_id	string	oui	Id du draft (par exemple DFT-01) ; il n'est unique qu'au sein de son epic. Obligatoire.

draft_update

effortless_draft_update — Stabilité : beta · projet

Met à jour les champs d'un draft existant.

💬 Vous demandez à l’agent

« Change le titre du brouillon D-04 de l'épic 012 en « Export CSV et Excel des rapports ». »

→ L’agent appelleeffortless_draft_update

• epic_id = 012
• draft_id = D-04
• title = Export CSV et Excel des rapports

Nom	Type	Requis	Description
epic_id	string	non	Epic qui porte le draft (défaut : le draft est cherché dans tous les epics ; si plusieurs portent cet id, l'epic actif est utilisé, sinon l'appel est refusé en nommant les candidats).
draft_id	string	oui	Id du draft (par exemple DFT-01) ; il n'est unique qu'au sein de son epic. Obligatoire.
title	string	non	Nouveau titre ; absent, il reste inchangé.
summary	string	non	Nouveau résumé ; absent, il reste inchangé.
kind	string	non	Nouveau type de story : opale ou fix ; absent, il reste inchangé.
depends_on	array<string>	non	Nouvelle liste d'ids dont dépend le draft (remplace la précédente) ; absente, elle reste inchangée.
proposed_tasks	array<string>	non	Nouvelle liste de tâches proposées (remplace la précédente) ; absente, elle reste inchangée.
rationale	string	non	Nouvelle justification ; absente, elle reste inchangée.

draft_validate

effortless_draft_validate — Stabilité : beta · projet

Valide un draft (le matérialise en story). Renvoie l'id de story créée.

💬 Vous demandez à l’agent

« Valide le brouillon D-04 de l'épic 012 pour en faire une vraie story. »

→ L’agent appelleeffortless_draft_validate

• epic_id = 012
• draft_id = D-04

Nom	Type	Requis	Description
epic_id	string	non	Epic qui porte le draft (défaut : le draft est cherché dans tous les epics ; si plusieurs portent cet id, l'epic actif est utilisé, sinon l'appel est refusé en nommant les candidats).
draft_id	string	oui	Id du draft (par exemple DFT-01) ; il n'est unique qu'au sein de son epic. Obligatoire.

interruption_proof

effortless_interruption_proof — Stabilité : beta · projet

Prouve qu'un ordre d'écriture survit à une interruption réelle : coupe la commande déclarée (SIGKILL) à chaque position qu'elle annonce, puis lance le contrôle d'état.

💬 Vous demandez à l’agent

« Prouve que mon écriture de la sauvegarde survit à une coupure : lance la preuve d'interruption « save-order » à chaque position annoncée. »

→ L’agent appelleeffortless_interruption_proof

• proof_id = save-order

Nom	Type	Requis	Description
proof_id	string	oui	Id de la preuve déclarée dans effortless.json sous settings.interruption_proofs. Obligatoire.
positions	array<integer>	non	Positions à couper, sous forme d'entiers (défaut : toutes celles que la commande annonce).

proposal_add

effortless_proposal_add — Stabilité : stable · story

Ajoute une proposition (résumé) à une story (statut pending).

💬 Vous demandez à l’agent

« Ajoute à la story 003 la proposition « Découper le parseur en deux modules ». »

→ L’agent appelleeffortless_proposal_add

• story_id = 003
• summary = Découper le parseur en deux modules

Nom	Type	Requis	Description
story_id	string	non	Story visée (défaut : story active).
summary	string	oui	Résumé de la proposition. Obligatoire.

proposal_reject

effortless_proposal_reject — Stabilité : stable · story

Rejette la proposition d'une story (statut rejected).

💬 Vous demandez à l’agent

« Rejette la proposition de la story 003. »

→ L’agent appelleeffortless_proposal_reject

• story_id = 003

Nom	Type	Requis	Description
story_id	string	non	Story visée (défaut : story active).

proposal_validate

effortless_proposal_validate — Stabilité : stable · story

Valide la proposition d'une story (statut validated).

💬 Vous demandez à l’agent

« Valide la proposition de la story 003. »

→ L’agent appelleeffortless_proposal_validate

• story_id = 003

Nom	Type	Requis	Description
story_id	string	non	Story visée (défaut : story active).

question_ask

effortless_question_ask — Stabilité : stable · story

Ajoute une question ouverte à une story. Renvoie l'id (Q-NN).

💬 Vous demandez à l’agent

« Pose une question sur la story 003 de l'épic 012, en phase O-analyse : « Quel format de date l'API attend-elle ? » Contexte : l'export CSV contient des dates. Impact : avec un mauvais format, l'API rejette les requêtes. Suggestion : ISO 8601. »

→ L’agent appelleeffortless_question_ask

• epic_id = 012
• story_id = 003
• question = Quel format de date l'API attend-elle ?
• context = L'export CSV contient des dates.
• impact = Mauvais format : l'API rejette les requêtes.
• suggestion = ISO 8601
• phase = O-analyse

Nom	Type	Requis	Description
epic_id	string	oui	Id de l'epic qui porte la story. Obligatoire.
story_id	string	oui	Id de la story qui reçoit la question. Obligatoire.
question	string	oui	La question ouverte. Obligatoire.
context	string	oui	Contexte de la question. Obligatoire.
impact	string	oui	Impact de la question restée sans réponse. Obligatoire.
suggestion	string	oui	Piste ou suggestion de réponse. Obligatoire.
phase	string	oui	Phase OPALE de la question, sous forme d'id de phase du workflow (workflow par défaut : O-analyse, P-cadrage, A-specs, L-plan, E-execute). Obligatoire.

question_resolve

effortless_question_resolve — Stabilité : stable · story

Résout une question (statut Resolved + réponse + date).

💬 Vous demandez à l’agent

« Résous la question Q-05 de la story 003 de l'épic 012 : « L'API attend de l'ISO 8601 en UTC. » »

→ L’agent appelleeffortless_question_resolve

• epic_id = 012
• story_id = 003
• question_id = Q-05
• answer = L'API attend de l'ISO 8601 en UTC.

Nom	Type	Requis	Description
epic_id	string	oui	Id de l'epic qui porte la story. Obligatoire.
story_id	string	oui	Id de la story qui porte la question. Obligatoire.
question_id	string	oui	Id de la question à résoudre (par exemple Q-01). Obligatoire.
answer	string	oui	Réponse apportée à la question. Obligatoire.

questions_list

effortless_questions_list — Stabilité : stable · projet

Liste toutes les questions du projet avec leur origine epic/story.

💬 Vous demandez à l’agent

« Liste toutes les questions ouvertes du projet. »

→ L’agent appelleeffortless_questions_list

Aucun paramètre.

recipe_maturity

effortless_recipe_maturity — Stabilité : beta · projet

Liste les scénarios de recette par statut de maturité (stable, candidat, beta, prévu), rend le travail restant (prévu + beta) et les recettes bloquées par un manque. Lecture seule.

💬 Vous demandez à l’agent

« Quelles recettes de la story 003 sont encore en beta ou prévues, et lesquelles sont bloquées ? »

→ L’agent appelleeffortless_recipe_maturity

• story_id = 003

Nom	Type	Requis	Description
epic_id	string	non	Limite à un epic (défaut : tout le projet).
story_id	string	non	Limite à une story (défaut : toutes celles de l'epic ou du projet).