RafaelFerSilva/refinement-agent-skills

Configurer l'espace de travail

Écrivez la configuration au niveau de l'espace de travail que /refine-story, /qa-plan, /requirements-discovery et /meeting-minutes présupposent. Il s'agit d'une compétence guidée par la conversation, non d'un script automatisé : explorez, présentez les résultats, confirmez, puis écrivez les fichiers.

Étapes

1. Explorer. Inspectez les fichiers existants avant de faire des hypothèses : AGENTS.md et CLAUDE.md à la racine, CONTEXT.md, docs/agents/refinement.md et docs/agents/issue-tracker.md (sorties précédentes de cette compétence), .scratch/, et les signaux de code source : package.json, pyproject.toml, src/, go.mod, ou tout élément que l'équipe compile ou exécute. Si docs/agents/issue-tracker.md existe déjà suite à une autre convention, conservez-le : vérifiez simplement qu'il spécifie où publier. Si CLAUDE.md n'est qu'un pont avec @AGENTS.md, le fichier d'instructions principal est AGENTS.md. Terminé quand : vous savez si l'espace de travail est déjà configuré, le mode probable, la langue probable (en-US ou pt-BR), si un glossaire existe, si le suivi de tickets existe, et quel fichier d'instructions modifier.

2. Demander, une section à la fois, en proposant la réponse recommandée.

   Mode. Recommandez en fonction des résultats : si du code est présent, com-codigo (avec code) ; si absent, sem-codigo (sans code). Expliquez en une ligne : avec code, l'agent inspecte le code source avant de demander ; sans code, le PO est la source des faits et les questions d'architecture deviennent des questionnaires pour l'équipe.

   Langue. Recommandez en fonction des fichiers existants ou en-US par défaut : en-US ou pt-BR. Expliquez en une ligne : définit la langue de l'examen, des tours de questions, des récits, des critères Gherkin et des verdicts.

   Éléments de travail. Les User Stories proviennent-elles d'un outil de suivi externe ? Si oui, quelle est l'URL de base et la convention de champ (par exemple Azure: <ID> pour les éléments de travail Azure DevOps). Chaque US provient de là et chaque artefact porte cette ligne d'ID.

   Glossaire produit. CONTEXT.md existe-t-il déjà ? Si non, aucune action nécessaire maintenant : le premier examen qui résout un terme du domaine le créera. Énoncez cela clairement.

   Terminé quand : le mode, la langue, la convention d'élément de travail et l'URL de base sont confirmés.

3. Confirmer et écrire. Présentez le brouillon de docs/agents/refinement.md basé sur refinement.md, docs/agents/issue-tracker.md basé sur issue-tracker.md (uniquement s'il n'existe pas déjà), et le bloc ## Refinement pour le fichier d'instructions de l'agent. Permettez des ajustements. Puis écrivez les fichiers. Pour le fichier d'instructions : si CLAUDE.md existe et importe AGENTS.md (@AGENTS.md), modifiez AGENTS.md ; sinon modifiez CLAUDE.md s'il existe ; sinon AGENTS.md s'il existe ; si aucun n'existe, demandez lequel créer. Si le bloc ## Refinement existe déjà, mettez-le à jour sur place sans modifier le reste du fichier.

   Le bloc :

   ## Refinement
   
   Workflows de raffinement socratique : exécutez `/which-flow` pour sélectionner un workflow. Le mode et les conventions se trouvent dans `docs/agents/refinement.md` ; les conventions de suivi dans `docs/agents/issue-tracker.md`. Les artefacts se trouvent dans `.scratch/<slug>/` avec `Status:` et l'ID de l'élément de travail.
   

   Terminé quand : refinement.md, le fichier de suivi (nouveau ou conservé) et le bloc d'instructions existent avec un contenu confirmé.

4. Conclure. Confirmez que l'espace de travail est configuré, listez les workflows qui lisent docs/agents/refinement.md et notez que les fichiers peuvent être modifiés manuellement ultérieurement ; ré-exécuter cette compétence n'est nécessaire que pour changer de mode, de langue ou de conventions de suivi.