Sommaire de la documentation

// Documentation Singularity

Le ticket de A à Z

Dans Singularity, un ticket est à la fois une carte de suivi, le cahier des charges lu par l'agent et le fil qui conserve ses échanges et son résultat.

Anatomie d'un ticket

Le libellé numéroté identifie le ticket. Le titre résume le résultat attendu et la description en donne le contexte. La priorité est low, medium, high ou critical. Les tags facilitent le classement et les projets concernés indiquent les dépôts à consulter.

Les huit types sont feature, bug, refactor, doc, test, ia, session et user-action. Ce dernier représente une action humaine et apparaît lorsque le module Actions utilisateur est actif.

Les six statuts exacts sont todo, in_progress, working, pending, done et failed. in_progress couvre la prise en charge, working une exécution active et pending une attente explicite.

Ouvrir un ticket

Double-cliquez sur une carte de Mission Control. Le détail s'ouvre comme un onglet du deck : gardez-le à côté de l'éditeur, du terminal ou d'un autre ticket sans perdre le contexte.

Détail d'un ticket de démonstration ouvert dans le deck
Le détail rassemble les métadonnées, la mission, les pièces jointes et le fil.

La description

La description est l'instruction principale lue par l'agent. Donnez le contexte et le problème observé, formulez des critères d'acceptation vérifiables, puis nommez le périmètre exclu. Ajoutez les chemins ou commandes utiles sans imposer une solution quand seul le résultat compte.

Une bonne description permet de savoir ce qui doit changer, comment vérifier la réussite et ce qui doit rester intact.

Pièces jointes

Déposez un fichier ou une image dans le formulaire de création, ou utilisez le bouton d'ajout. Images, PDF et textes se prévisualisent dans le détail. À l'exécution, Singularity expose leur liste à l'agent ; il peut les lire par la passerelle de session ou avec le chemin local fourni.

Utilisez des exemples minimaux et anonymisés : aucune capture ne doit révéler de secret ni le contenu d'un ticket réel.

Dépendances et sous-tickets

Le champ Bloqué par relie le ticket à ses prérequis. Il ne se lance que lorsqu'ils sont terminés et, s'ils ont produit un worktree, intégrés.

Un ticket complexe peut être découpé en enfants. Le parent devient le point de synthèse en pending, conserve leurs liens et attend leur achèvement avant de reprendre.

Planification

Une échéance indique la date cible sans lancer le travail. La planification programme une exécution récurrente quotidienne ou hebdomadaire à l'heure choisie. Vous pouvez démarrer la première occurrence immédiatement, puis suspendre, reprendre ou supprimer la programmation.

Le fil de conversation

Le fil conserve les tentatives, messages et réponses de l'agent. Écrivez pour préciser la demande pendant une exécution. Si l'agent pose une question bloquante, le ticket passe en pending : votre réponse revient à la même session avec son contexte.

Sur un ticket done ou failed, un nouveau message ou la relance démarre une nouvelle tentative sans effacer l'historique.

Le résultat

Le compte rendu final explique ce qui a été livré, les vérifications effectuées et les limites éventuelles. Il reste dans le détail et alimente la revue lorsqu'elle est activée.

La résolution courte est une phrase sans Markdown de moins de 120 caractères, affichée en gras sur la carte terminée pour rendre la colonne Done lisible d'un coup d'œil.

Questions fréquentes

Que lit l'agent avant de commencer ?

Il reçoit le titre, la description, les pièces jointes, les dépendances et le contexte du ticket. Une description autonome et vérifiable réduit les allers-retours.

Puis-je reprendre un ticket terminé ?

Oui. Envoyez un nouveau message ou relancez le ticket : Singularity conserve l'historique et ouvre une nouvelle tentative avec votre instruction supplémentaire.