jumibot/informe_deliberativa

Rapport d'une tâche délibérative

Une tâche délibérative (recherche, délibération ou conception ; « Sept types de tâche en trois familles », 223) donne un rapport et les tâches qui en découlent (« Une tâche délibérative donne un rapport et les tâches qui en découlent », 218). Ses dilemmes vivent dans le rapport, à jour avec chaque réponse du propriétaire, et non dans la file d'attente ni dans un autre fichier. Ce qui relève d'une autre tâche est proposé à la séparation ; à la fermeture, ce qui reste ouvert sort vers sa tâche (« Dans une délibérative, ce qui relève d'une autre tâche est proposé à la séparation », 221). Une délibérative ne teste rien et ne modifie que son rapport : ce qui doit être appliqué est fait par les tâches qu'elle crée.

Cette skill décrit ce que contient le rapport, comment ses questions sont rédigées et comment se déroule chaque itération. Le générateur, les ressources, les thèmes et la vérification sont ceux de crear_documentos, qui doit être lu en complément. C'est la skill de l'agent de la famille délibérative, lorsqu'il existera (« Agents spécialisés, un par famille de tâche », 304) ; en attendant, elle est chargée par le sous-agent de la tâche.

Le lecteur est le propriétaire, qui doit décider. Le rapport lui fait gagner du temps : ce qui doit être décidé apparaît en premier, chaque question se répond par une lettre et la recommandation se distingue d'un coup d'œil. Bien communiquer est un objectif de la SF (décision 231).

Emplacement

• Dans un projet intégré à la SF, dans sf/informes/ (« Les documents de la SF se trouvent dans le dossier sf/ », 203).
• Dans la SF elle-même, dans docs/referencias/reports/, jusqu'à ce que son passage vers sf/ soit décidé (question 13 du rapport « Tipos de tarea », dans la tâche 303).

Le nom du fichier est le thème, pas le numéro de la tâche : Tipos de tarea.md et son .html. Les versions remplacées vont dans _respaldo/, dans le même dossier.

Modèle : le rapport docs/referencias/reports/Tipos de tarea.md de la SF (tâche 274). S'il est sur le poste, on le lit comme exemple ; son contenu n'est pas copié. Le modèle vide se trouve dans assets/plantilla-informe.md.

Structure

Les sections sont toujours dans cet ordre, avec ces {#id}, pour que le propriétaire sache où regarder et que les tâches puissent y faire référence :

1. Résumé {#resumen}. La conclusion en deux ou trois courts paragraphes : ce qui est proposé, sur quoi cela s'appuie, combien de questions restent et où. Si un schéma clarifie l'ensemble, il va ici. Termine par des sauts vers ce qui doit être décidé ([Voir les N questions](#por-decidir){: .salto}).
2. Analyse, dans une ou plusieurs sections propres : ce qui a été étudié et ce qui est proposé, avec le pourquoi. D'abord ce qui est proposé ou conclu, même si cela découle du reste ; ensuite, l'évaluation qui le soutient et ses limites. Les cartes, les schémas et les tableaux du thème se trouvent ici.
3. Décidé {#decidido}. Un tableau des décisions du propriétaire que cette tâche fixe : Nº | Décision | Ce qui est fixé ici. Chaque décision est enregistrée dans son fichier de décisions avant d'apparaître ici.
4. À décider {#por-decidir}. Les questions ouvertes, dans un bloc ::: preguntas. Si elles sont nombreuses, elles sont divisées en blocs, chacun dans sa section ({#por-decidir-<destination>}), par importance ou par le lieu où elles iraient si elles étaient séparées ; chaque bloc s'ouvre par une phrase qui indique ce qu'il regroupe et un saut vers sa séparation.
5. Séparer {#separar}. Les propositions de séparation : une carte par séparation ({: #a-<destination>}), avec ce qu'elle emporte (les questions, avec un lien vers chacune) et vers où (une nouvelle tâche, une étape d'une tâche existante ou /sf_split). Si le choix de la séparation doit être fait, c'est aussi une question.
6. Tâches {#tareas}. Les tâches qui en découlent : Tâche | Type | Ce qu'elle fait. Celles qui existent déjà, avec leur numéro.

Annexes, à la fin et seulement si nécessaire : sources (::: fuentes), données complètes, texte proposé pour un document qui sera modifié par une autre tâche.

Si l'analyse ne laisse rien à décider, à séparer ou à créer, ces sections sont supprimées ; les autres ne changent pas d'ordre.

En-tête : antetitulo avec « Projet · Rapport de <analyse, conception ou recherche> · <mois année> », lema, subtitulo avec ce à quoi le rapport répond, version, estado (« Proposition · Tâche N », « Décidé · Tâche N »…), portada: oscura, destino: proyecto, herramientas, menu: secciones (le propriétaire saute entre les sections), tipo (« Rapport d'analyse », « Rapport de conception », « Rapport de recherche ») et pie avec la tâche, l'origine du rapport et qui décide.

Les questions

Chaque question est une carte de ::: preguntas, la ressource « question avec options » de crear_documentos :

::: preguntas 2 plegables

### 1 · Comment respecter « son seul document » {recomendada=A} {: #p1}

Aujourd'hui rien ne le vérifie : toute étape entre dans la tâche.

Option A
:   La tâche déclare son document avec une commande, et `cerrar` refuse si la branche touche à d'autres fichiers.

Option B
:   Seule la règle, écrite dans l'orchestration.

Recommandation
:   **A.** Cela se fait avec une commande, pas avec la mémoire du principal.

:::

• Une décision par question, avec un titre qui la nomme et un numéro par importance (1 la plus importante). Le numéro et l'ancre {: #pN} ne changent pas, même si la question est décidée ou séparée : les étapes des tâches y font référence (« Décider … (question 5) (rapport « Tipos de tarea », 274) »).
• Contexte en une ou deux phrases, seulement si nécessaire pour choisir : ce qui se passe aujourd'hui ou pourquoi il faut décider.
• Deux ou trois options, Option A, Option B…, chacune avec ce qu'elle implique en une ou deux phrases. « Comme aujourd'hui » est une option quand elle l'est vraiment.
• Recommandation avec son pourquoi en une phrase, et recomendada=A dans le titre pour qu'elle soit mise en évidence. Toute question ouverte comporte une recommandation ; le générateur prévient si elle manque.
• État, mis à jour à chaque réponse :
  • estado=abierta (par défaut) : la réponse est attendue ;
  • estado=decidida elegida=B : avec un champ Decisión qui indique ce qui a été choisi, avec ses nuances, et le numéro de la décision enregistrée ; l'option choisie est marquée et les autres passent en gris ;
  • estado=separada destino=tarea_303 : est partie vers une autre tâche (le _ est lu comme un espace dans la marque). Elle reste dans le rapport pour que la tâche de destination puisse y faire référence.
• Les questions qui dépendent d'une autre sont mentionnées dans leur contexte, avec un lien vers l'autre.

Lorsqu'une question est décidée ou séparée, sa carte reste dans son bloc avec le nouvel état, et la décision passe également dans le tableau « Décidé ». Le résumé indique combien de questions restent ouvertes.

Chaque itération

Chaque réponse du propriétaire, ou chaque avancée de l'analyse qui modifie le rapport, constitue une itération :

1. Sauvegarder la version qui va être remplacée : python -I -X utf8 <skills>/crear_documentos/scripts/respaldar.py <rapport>.md <motif> (« Avant de remplacer un document, on le sauvegarde dans _respaldo/ », 217).

2. Écrire les modifications : l'état des questions répondues, « Décidé », les séparations et les tâches, et le résumé. Incrémenter la version dans l'en-tête (2.5 → 2.6 ; le premier nombre change lorsque la structure du rapport change) et mettre à jour le estado.

3. Régénérer le HTML dans le même changement (« Chaque modification d'un .md régénère son HTML », 220) :

   python -I -X utf8 <skills>/informe_deliberativa/scripts/informe_to_html.py <rapport>.md
   

4. Livrer sur develop sans branche, car il s'agit d'un nouveau document (« Les nouveaux documents vont sur develop à chaque itération et sont proposés dans le navigateur », 216), avec la commande qui le fait lorsqu'elle existera (« Nouveaux documents sur develop à chaque itération, et les ouvrir dans le navigateur », 297).

5. Proposer d'ouvrir le HTML dans le navigateur, avec la nouvelle version.

Vérification

Celle de crear_documentos (« Vérification ») et, en plus :

• chaque question ouverte a au moins deux options et une recommandée ; aucune question décidée sans elegida ni séparée sans destino ;
• les comptes du résumé (questions ouvertes, séparations, tâches) correspondent aux sections ;
• chaque lien vers une question (#pN) ou une séparation (#a-…) existe ;
• le tableau « Décidé » ne contient que des décisions déjà enregistrées.