4nk/sdk_common
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
sdk_common/AGENTS.md

8.7 KiB
Raw Blame History

AGENTS.md

Table des matières

Introduction

Ce document définit les agents, leurs rôles et leurs responsabilités dans le projet 4NK/4NK_node. Chaque agent est assigné à un périmètre clair (documentation, tests, dépendances, données, CI, gouvernance open source). L’objectif est d’assurer une maintenance cohérente de l’arborescence, une traçabilité complète et une exécution fiable des bonnes pratiques. Les règles détaillées de réalisation et de contrôle sont précisées dans .cursor/rules/.

Agents fondamentaux

Agent Fondation

Rôle (Responsable) :

  • Garantir que toute production est en français.
  • Vérifier l’absence d’exemples de code applicatif dans la base de code.
  • Imposer l’introduction et/ou conclusion dans chaque contenu.

Artefacts :

  • Tous fichiers.

Agent Structure

Rôle (Responsable) :

  • Maintenir l’arborescence canonique du projet.
  • Déplacer les documents obsolètes vers archive/.
  • Bloquer toute suppression non documentée.

Artefacts :

  • archive/, docs/, tests/, .gitea/, CHANGELOG.md.

Agents spécialisés documentation

Agent Documentation

Rôle (Responsable) :

  • Mettre à jour les fichiers de docs/ selon l’impact des changements.
  • Maintenir INDEX.md comme table des matières centrale.
  • Produire des REX techniques dans archive/.

Agent Données CSV

Rôle (Responsable) :

  • Considérer les CSV comme source de vérité des modèles de données.
  • Confirmer la structure et exiger une définition des colonnes.
  • Corriger automatiquement les incohérences de type documentées.

Agent Documents bureautiques

Rôle (Consulté) :

  • Lire les .docx via docx2txt.
  • Proposer des alternatives en cas d’échec.
  • Documenter les imports dans INDEX.md.

Agents spécialisés tests

Agent Tests

Rôle (Responsable) :

  • Maintenir la couverture : unit, integration, connectivity, performance, external.
  • Gérer tests/logs et tests/reports.
  • Exiger des tests verts avant commit.

Agent Performance

Rôle (Consulté) :

  • Conduire des benchmarks reproductibles.
  • Vérifier l’impact performance avant toute fusion.

Agents techniques

Agent Dépendances

Rôle (Responsable) :

  • Ajouter automatiquement les dépendances manquantes.
  • Vérifier les dernières versions stables.
  • Documenter les changements dans ARCHITECTURE.md, CONFIGURATION.md et CHANGELOG.md.

Agent Compilation

Rôle (Responsable) :

  • Compiler très régulièrement et à chaque étape critique.
  • Bloquer toute progression en présence d’erreurs.

Agent Résolution

Rôle (Responsable) :

  • Exécuter systématiquement la boucle de diagnostic (reproduction, logs, bissection, hypothèses, correctif, non-régression).
  • Produire un REX en cas d’hypothèses multiples.

Agents frontend

Agent Frontend

Rôle (Responsable) :

  • Implémenter le code splitting (React.lazy, Suspense).
  • Centraliser l’état via Redux ou Context API.
  • Créer une couche d’abstraction pour les services de données.

Agents open source et CI

Agent Open Source

Rôle (Responsable) :

  • Maintenir à jour : LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, OPEN_SOURCE_CHECKLIST.md.
  • Vérifier l’alignement continu avec 4NK_node.

Agent Gitea

Rôle (Responsable) :

  • Vérifier la présence et l’actualité de .gitea/ISSUE_TEMPLATE/*, PULL_REQUEST_TEMPLATE.md, .gitea/workflows/ci.yml.
  • Documenter la configuration dans docs/GITEA_SETUP.md.

Agent Versionnage

Rôle (Responsable) :

  • Maintenir CHANGELOG.md comme source unique de vérité.
  • Proposer un bump semver justifié.
  • Demander confirmation avant push et tag.

Agents complémentaires

Agent Coordination

Rôle (Accountable) :

  • Vérifier que tous les agents concernés ont bien agi lors d’un changement complexe.
  • Consolider les validations avant merge.

Agent Qualité / Linting

Rôle (Responsable) :

  • Appliquer les règles de style, lint et sécurité statique.
  • Surveiller la dette technique et l’accessibilité.

Agent Release Manager

Rôle (Responsable) :

  • Superviser le passage d’une version à l’autre.
  • Vérifier la cohérence entre CHANGELOG.md, ROADMAP.md et les tags Git.
  • Déclencher les workflows CI/CD de release.

Agent Sécurité proactive

Rôle (Responsable) :

  • Surveiller les dépendances vulnérables (CVE, advisories).
  • Mettre à jour SECURITY_AUDIT.md et notifier l’agent Dépendances.

Agent Contributeurs externes

Rôle (Consulté) :

  • Encadrer la réception de PRs et issues communautaires.
  • Veiller au respect de CODE_OF_CONDUCT.md.

Agent Documentation communautaire

Rôle (Responsable) :

  • S’assurer que COMMUNITY_GUIDE.md et OPEN_SOURCE_CHECKLIST.md sont accessibles, clairs et alignés avec l’expérience contributeurs.

Matrice de coordination

Type de changement Agents impliqués Artefacts principaux Validation obligatoire
Ajout de fonctionnalité Documentation, Tests, Dépendances, Frontend API.md, USAGE.md, ARCHITECTURE.md, tests/unit, tests/integration, CHANGELOG.md (Added), README.md Oui
Correction de bug Résolution, Tests, Documentation tests/unit, TESTING.md, archive/, CHANGELOG.md (Fixed) Oui
Refactorisation / amélioration Structure, Documentation, Compilation ARCHITECTURE.md, archive/, CHANGELOG.md (Changed) Oui
Dépendance ajoutée/mise à jour Dépendances, Compilation, Documentation ARCHITECTURE.md, CONFIGURATION.md, CHANGELOG.md (Dependencies) Oui
Données CSV modifiées Données CSV, Documentation, Tests API.md, ARCHITECTURE.md, USAGE.md, tests/unit, CHANGELOG.md (Data model update) Oui
Migration / breaking change Documentation, Tests, Résolution, Versionnage MIGRATION.md, INSTALLATION.md, RELEASE_PLAN.md, ROADMAP.md, tests/integration, CHANGELOG.md (Breaking) Oui
Sécurité / audit Documentation, Tests, Open Source, Sécurité proactive SECURITY_AUDIT.md, tests/external, tests/connectivity, CHANGELOG.md (Security) Oui
Préparation open source / CI Open Source, Gitea, Versionnage, Documentation communautaire, Contributeurs externes .gitea/**, GITEA_SETUP.md, OPEN_SOURCE_CHECKLIST.md, CHANGELOG.md (CI/CD / Governance) Oui
Optimisation performance Performance, Tests, Documentation tests/performance, tests/reports, ARCHITECTURE.md, CHANGELOG.md (Performance) Oui
Évolution frontend Frontend, Documentation, Tests ARCHITECTURE.md, USAGE.md, tests/integration, CHANGELOG.md (Frontend) Oui

Conclusion

Le présent AGENTS.md formalise non seulement les rôles et responsabilités, mais également la coordination opérationnelle entre agents pour chaque type de changement. Grâce à la table des matières, aux agents complémentaires et à la matrice structurée, ce fichier constitue une référence vivante garantissant la cohérence entre code, documentation, tests, dépendances, CI/CD et gouvernance open source.