EvolveHQ/docflow

brainstorm

Transformer un problème flou en un ensemble structuré de candidats ADR et d'éléments de planification. Cette compétence est générative et en lecture seule / proposition uniquement — elle n'écrit jamais directement dans les fichiers ADR ou de planification. Une fois approuvée, elle transmet chaque candidat aux compétences new-adr et new-plan.

Étape 0 — Prérequis et contexte

1. Confirmer que le dépôt est initialisé (ou noter que la sortie peut amorcer une nouvelle exécution de la compétence bootstrap).
2. Lire CONVENTIONS.md pour la forme et le cycle de vie des ADR, et parcourir INDEX.md + les ADR existants afin que les candidats ne dupliquent pas ou ne contredisent pas ce qui existe déjà, et que les dépendances pointent vers des ADR réels.

Étape 0.5 — Évaluation (exécutée en premier)

Exécuter le protocole d'évaluation partagé avant de décomposer :

• Réutiliser d'abord les réponses fournies. Traiter les choix applicables déjà fournis dans la requête ou cette session, y compris la profondeur, comme étant répondus. Les résumer sans les redemander ; les valeurs par défaut ne remplacent jamais les choix explicites. Si tous les choix matériels sont fournis, continuer. Ne demander qu'en cas de choix manquant ou contradictoire. Une préférence de dépôt seule n'est pas une réponse actuelle ni une autorisation d'exécution.

• Sélecteur de profondeur pour les choix non résolus. Si la profondeur n'est pas fournie et qu'il reste des choix, demander jusqu'où cette évaluation doit aller : express — chaque choix prend sa valeur par défaut recommandée ; seules les questions sans valeur par défaut dérivable (les éléments essentiels en texte libre) sont encore posées ; guidée — uniquement les questions marquées comme ayant un fort impact ci-dessous, plus les éléments essentiels en texte libre ; complète — toutes les questions ci-dessous. Si le CONVENTIONS.md du dépôt enregistre une Profondeur d'évaluation :, la présélectionner comme option recommandée lors de la demande ; une profondeur enregistrée n'est jamais appliquée silencieusement. Sinon recommander complète lorsque la requête est arrivée avec peu ou pas de contexte et express lorsqu'elle est déjà entièrement spécifiée. À tout moment, l'opérateur peut répondre « valeurs par défaut à partir d'ici » ou « aller plus loin » ; honorer le changement immédiatement.

• Poser les questions ci-dessous une par une, chacune avec une option recommandée et une justification d'une ligne ; attendre chaque réponse.

• Utiliser une sélection structurée (choix unique ou multiple). Si l'hôte expose un outil de question structurée à choix unique/multiple, l'utiliser et marquer l'option recommandée ; sinon lister les options A/B/C en texte brut et nommer celle recommandée. Utiliser du texte libre uniquement là où un ensemble énumérable est impossible (par exemple, l'énoncé de l'objectif).

• L'opérateur décide. Ne jamais passer à une question suivante sans réponse, et ne jamais deviner le périmètre lorsqu'il est invoqué sans contexte.

Questions (sauter celles auxquelles la requête répond déjà) :

1. Objectif / problème — texte libre (la réponse ouverte incontournable ; posée à chaque profondeur) si non déjà donnée.
2. Sortie — candidats ADR uniquement, ou ADR + éléments de planification. Recommandé : ADR + éléments de planification.
3. Profondeur de décomposition — rapide (meilleurs candidats) ou approfondie (décomposition complète). Recommandé : rapide d'abord, développée sur demande.

Aucune question ici n'est marquée comme ayant un fort impact — une exécution guidée se comporte comme express pour cette compétence.

Cette compétence n'écrit toujours rien jusqu'à ce que vous approuviez le plan.

Étape 1 — Comprendre le problème

Demander l'objectif/fonctionnalité/problème si non donné. Sonder les limites du périmètre, les contraintes et les préoccupations réglementaires/qualité qui importent pour ce dépôt. Ne pas commencer à décomposer avant que l'objectif soit clair.

Étape 2 — Décomposer

Produire une liste de candidats. Pour chaque candidat ADR :

• Numéro proposé (prochain disponible, consécutif), titre de travail, forme (capacité vs. technologie si le dépôt les sépare).
• Périmètre en une ligne — la décision unique qu'il capture.
• Dépendances envers d'autres candidats ou ADR existants.

Une décision par ADR. Si un candidat regroupe plusieurs décisions, le diviser et en expliquer la raison. Si un candidat est en réalité un ADR existant nécessitant une révision, le dire au lieu de proposer un nouveau numéro.

Étape 3 — Ordonner le travail

Proposer un ordre de planification (quels éléments plan/todo/, dans quel ordre) en respectant les arêtes de dépendance. Noter où le travail peut être parallélisé (entrée utile pour la compétence agent-wave).

Étape 4 — Réviser et remettre

Présenter l'ensemble complet sous forme de plan révisable (candidats + dépendances + ordre). Prendre en compte les modifications. N'écrire encore rien. Une fois que l'utilisateur approuve, les créer en invoquant la compétence new-adr pour chaque candidat et la compétence new-plan pour chaque élément mis en file d'attente — ou remettre le plan approuvé à ces compétences.

Garde-fou : si le problème est trop vague pour être décomposé sans inventer des exigences, le dire et demander plus d'informations, plutôt que de produire des ADR spéculatifs.

Nommer les options convenues et les décisions restantes ; la discussion seule ne crée aucun artefact.

Rapport de clôture

Terminer chaque exécution, y compris les exécutions bloquées, échouées et arrêtées, par une section intitulée exactement État en un coup d'œil, contenant ces trois étiquettes :

• Cette exécution : uniquement les actions réellement tentées et leurs résultats ; citer la sortie exacte et le code de sortie de chaque porte de vérification, y compris les délais d'attente ou interruptions.
• Global : implémenté, partiellement vérifié, vérifié, bloqué, échoué ou inconnu. Une sous-étape réussie n'est pas une réussite globale ; des preuves incomplètes ou manquantes ne deviennent jamais un succès.
• Reste à faire : chaque action restante, constatation non résolue, vérification, nettoyage ou entrée requise. Écrire Aucun uniquement lorsque l'ensemble de la tâche est vérifiablement terminé ; ne jamais omettre un travail parce qu'un budget s'est épuisé.

Les messages de progression de routine n'ont pas besoin de bloc. Garder les résultats finaux concis et distinguer le travail préparé sur une PR du travail confirmé comme livré.