haystackeditor/risk-brief

Que fait risk-brief ?

Une compétence de pré-soumission pour Claude Code / Codex qui transforme les décisions de conception de votre agent en une description de PR — et audite automatiquement le diff pour les risques que vous avez manqués.

Comment ça fonctionne

Lors de l'exécution en pré-soumission, la compétence risk-brief :

1. Récupère les décisions de conception : Elle collecte les choix architecturaux et les justifications faites par l'agent au cours du développement.

2. Analyse le diff : Elle examine les modifications de code pour identifier les risques potentiels, comme les régressions, les failles de sécurité, les incohérences de style, ou les dépendances non mises à jour.

3. Génère un résumé structuré : Elle produit une description de PR incluant :

   • Un titre et un résumé des changements.
   • Les décisions de conception clés avec les raisons.
   • Une liste des risques identifiés avec leur sévérité.

4. Présente le résultat : Le contenu est formaté en Markdown prêt à être collé dans la description de la PR sur GitHub, GitLab, ou Bitbucket.

Plateformes supportées

• Claude Code (via les skills .mdc)
• Codex CLI (via les instructions de pré-soumission)

Utilisation

Pour utiliser cette compétence avec Claude Code, placez le fichier risk-brief.mdc dans le dossier .claude/skills/ de votre projet.

Pour Codex CLI, suivez les instructions de configuration de pré-soumission fournies dans le dépôt officiel.

Exemple de sortie

## Résumé de la PR

### Changements
- Ajout de la fonctionnalité d'authentification OAuth2
- Mise à jour du module de gestion des utilisateurs

### Décisions de conception
- Utilisation de JWT pour les tokens (sécurité renforcée)
- Stockage des sessions en Redis (performances)

### Risques identifiés
- 🔴 Critique : La validation des entrées dans le endpoint `/login` est manquante (risque d'injection)
- 🟡 Moyen : Le secret JWT en dur dans le code doit être externalisé
- 🟢 Faible : Quelques linters non conformes (espaces manquants)

Note

Cette compétence est un outil d'assistance ; elle ne remplace pas une revue de code humaine, mais aide à la préparer et à réduire les oublis courants.