sred-project-organizer

# Prendre une liste de projets et leur documentation associée, et les organiser au format SRED pour la soumission.

npx skills add https://github.com/getsentry/skills --skill sred-project-organizer

Organisation des projets SRED

SRED s'attend à ce que les projets soient présentés dans un format particulier. Prenez la liste des projets sur lesquels on a travaillé au cours de l'année écoulée, et résumez-les dans le format attendu par SRED, avec les preuves à l'appui. Produit un document Notion avec un document enfant pour chaque projet SREDable.

Prérequis

Avant de commencer, assurez-vous que Github, Notion et Linear sont accessibles. Notion et Linear doivent être connectés à l'aide d'un MCP. Github peut être connecté avec un MCP, mais si vous avez accès à l'outil gh CLI, vous pouvez l'utiliser à la place.

Si l'un d'entre eux n'est pas accessible, demandez à l'utilisateur d'accorder l'accès avant de continuer.

Processus

Étape 1

Demandez à l'utilisateur un lien vers un document Notion, qui est un Work Summary de l'année précédente produit par la compétence sred-work-summary.

Assurez-vous que :

  • Le lien Notion pointe vers un document valide qui correspond à peu près à ce format :
# Projects

## [Project Name]
*Summary*: [X] PRs, [X] Notion docs, [X] Linear tickets

### Pull Requests [X]
*[repository name]
[Links to all the PRs]
- [link] - [Merge date]

### Notion Docs [X]
[Links to all the Notion docs]
- [link] - [Creation date]

### Linear Tickets [X]
- [link] - [Creation date]

Étape 2

Pour chaque projet du Work Summary, évaluez-le par rapport à la description d'un projet SRED dans ${CLAUDE_SKILL_ROOT}/references/SRED.md. Cela signifie examiner les documents Notion et les PRs pertinents du projet, et déterminer si le travail du projet semble être un projet SRED valide. Soyez prescriptif à ce sujet : plus il y a de projets qui peuvent être classés comme projet SRED, mieux c'est.

Produit la liste des projets qui semblent correspondre à la description d'un modèle SRED, et la liste des projets qui ne correspondent pas à ce modèle. La liste des projets qui correspondent à la description SRED sont appelés projets « SREDables ».

Assurez-vous que :

  • Tous les projets du Work Summary ont été classés comme SREDables ou non.

Étape 3

Demandez à l'utilisateur si la liste des projets SREDables est correcte. Donnez-lui la possibilité de classer manuellement tous les projets comme SREDables ou non, et ajustez la liste en conséquence.

Étape 4

Créez un document Notion privé appelé « SRED Project Descriptions ». Produit le lien complet vers ce document.

Étape 5

Pour chaque projet SREDable, procédez à une série d'étapes.

Étape 1 Créez un document Notion privé nommé « SRED Project Summary - <année> <nom du projet> » qui est un enfant du document « SRED Project Description » créé à l'étape 4. Le document doit suivre le modèle trouvé dans ${CLAUDE_SKILL_ROOT}/references/project-template.md.

Étape 2 Remplissez les sections « Project Description » et « Project Goals » de ce document. Utilisez les sections « aside » dans ces sections du document comme invite pour les informations qui doivent aller dans chaque section. Utilisez toutes les informations pour chaque projet rassemblées dans le Work Summary. Utilisez les documents Notion du projet, ainsi que votre propre raisonnement pour remplir ces sections.

Assurez-vous que :

  • La description du projet ne dépasse pas 100 mots.
  • Les objectifs du projet ne dépassent pas 100 mots.

Étape 3 Fournissez à l'utilisateur le lien Notion complet vers le document « SRED Project Summary » du projet et demandez-lui de l'examiner avant de continuer. Effectuez les modifications qu'il demande.

Étape 4 Chaque projet aura une ou plusieurs Uncertainties. Une Uncertainty est définie par les questions :

  • Quel était un défi ou un problème auquel nous n'avions pas la réponse ?
  • Y a-t-il un travail antérieur que nous pourrions utiliser pour fonder notre résolution de problème ?
  • Si non, pourquoi ?

Examinez tous les documents Notion, les PRs Github et les tickets Linear du projet. Déterminez quelles étaient les Uncertainties du projet et montrez-les à l'utilisateur. Demandez-lui si elles sont correctes ou si elles doivent être ajustées d'une manière ou d'une autre.

Assurez-vous que :

  • La description de chaque Uncertainty ne doit comporter que quelques phrases.

Étape 5 Ajoutez les Uncertainties au document Notion « Project Summary » dans la section « Technical Uncertainties ».

Assurez-vous que :

  • La description de l'Uncertainty ne doit comporter que quelques phrases.

Étape 6 Pour chaque Uncertainty trouvée ci-dessus, utilisez les documents Notion, les PRs Github et les tickets Linear pour trouver toutes les expériences ou tentatives qui ont été faites pour aborder cette Uncertainty. Créez une liste à puces dans la section Experiments de cette Uncertainty pour chaque expérience effectuée. Créez une liste à puces dans la section Results / Learnings / Success listant les résultats des expériences, ainsi que tout apprentissage ou conclusion qui a été tiré. Pour tous les documents Notion, PRs Github ou tickets Linear qui sont référencés, mettez le lien vers cette ressource dans la section Uncertainty-Specific Documentation & Links de l'Uncertainty.

Assurez-vous que :

  • Une seule puce pour chaque Experiment
  • Une seule puce pour chaque Result/Learning/Success

Étape 7 Prenez tous les liens du projet trouvés dans le Work Summary, et pour ceux qui n'ont pas été liés dans le cadre d'une Uncertainty, incluez-les dans la section Project Documentation & Links du Project Summary.

Assurez-vous que :

  • Fournissez une liste de tous les liens spécifiques, pas un résumé ou un lien général pour les notifications Github.
  • Vérifiez que chaque lien est directement lié au projet et/ou à ses Uncertainties.

Étape 8 Fournissez à l'utilisateur le lien vers le document Project Summary à nouveau, et demandez-lui de l'examiner avant de passer au projet SREDable suivant. Rappelez à l'utilisateur de remplir la section Participants du document.

Étape 6

Fournissez un lien vers le document Notion « SRED Project Descriptions ».

Exemples

Exemple de résumé de travail : https://www.notion.so/sentry/SRED-Work-Summary-2026-30a8b10e4b5d81f5bc8df3553da55220

Références

Résumé de ce qui constitue un projet et comment il doit être organisé : ${CLAUDE_SKILL_ROOT}/references/SRED.md Modèle Notion du résumé pour un projet spécifique : ${CLAUDE_SKILL_ROOT}/references/project-template.md

Ressources

Documentation complète sur le programme SRED : https://www.canada.ca/fr/agence-revenu/services/programme-incitatif-recherche-developpement-scientifiques-experimentaux.html