7.8 KiB

AGENTS.md - ihm_client

Table des matières


Introduction

Ce document définit les agents, leurs rôles et leurs responsabilités dans le projet ihm_client. Chaque agent est assigné à un périmètre clair (frontend, WASM, tests, documentation, CI, gouvernance open source). L'objectif est d'assurer une maintenance cohérente de l'interface utilisateur, 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 frontend

Agent Vue.js

Rôle (Responsable) :

  • Maintenir la qualité du code Vue.js.
  • Assurer la cohérence des composants.
  • Optimiser les performances de l'interface.

Artefacts :

  • src/components/, src/pages/, src/services/.

Agent TypeScript

Rôle (Responsable) :

  • Maintenir la qualité du code TypeScript.
  • Assurer la cohérence des types.
  • Optimiser la compilation TypeScript.

Artefacts :

  • src/types/, tsconfig.json, vite.config.ts.

Agent UI/UX

Rôle (Responsable) :

  • Maintenir la cohérence de l'interface utilisateur.
  • Assurer l'accessibilité.
  • Optimiser l'expérience utilisateur.

Artefacts :

  • src/components/, src/pages/, src/assets/.

Agents spécialisés WASM

Agent Rust

Rôle (Responsable) :

  • Maintenir la qualité du code Rust.
  • Assurer la sécurité de la mémoire.
  • Optimiser les performances WASM.

Artefacts :

  • temp-deps/sdk_client/, temp-deps/sdk_common/.

Agent WASM

Rôle (Responsable) :

  • Maintenir la compilation WASM.
  • Assurer l'intégration avec le frontend.
  • Optimiser la taille du bundle WASM.

Artefacts :

  • pkg/, scripts/setup-remote-deps.sh.

Agent Silent Payments

Rôle (Responsable) :

  • Maintenir l'intégration des Silent Payments.
  • Assurer la sécurité des transactions.
  • Optimiser les performances de paiement.

Artefacts :

  • src/services/, src/types/sdk_client.d.ts.

Agents spécialisés tests

Agent Tests Frontend

Rôle (Responsable) :

  • Maintenir la couverture des tests frontend.
  • Assurer la qualité des tests Vue.js.
  • Optimiser l'exécution des tests.

Artefacts :

  • tests/unit/, tests/integration/.

Agent Tests WASM

Rôle (Responsable) :

  • Maintenir la couverture des tests WASM.
  • Assurer la qualité des tests Rust.
  • Optimiser l'exécution des tests WASM.

Artefacts :

  • temp-deps/sdk_client/tests/.

Agent Tests E2E

Rôle (Responsable) :

  • Maintenir la couverture des tests end-to-end.
  • Assurer la qualité des tests d'intégration.
  • Optimiser l'exécution des tests E2E.

Artefacts :

  • tests/e2e/, tests/performance/.

Agents documentation

Agent Documentation

Rôle (Responsable) :

  • Mettre à jour les fichiers de docs/ selon l'impact des changements.
  • Maintenir README.md comme documentation principale.
  • Produire des REX techniques dans archive/.

Artefacts :

  • docs/, README.md, CHANGELOG.md.

Agent API Documentation

Rôle (Responsable) :

  • Maintenir la documentation des APIs.
  • Assurer la cohérence des types TypeScript.
  • Optimiser la documentation des interfaces.

Artefacts :

  • docs/API.md, src/types/.

Agent User Documentation

Rôle (Responsable) :

  • Maintenir la documentation utilisateur.
  • Assurer la clarté des guides.
  • Optimiser l'expérience de lecture.

Artefacts :

  • docs/USAGE.md, docs/INSTALLATION.md.

Agents open source et CI

Agent Open Source

Rôle (Responsable) :

  • Maintenir la conformité open source.
  • Assurer la qualité des licences.
  • Optimiser la gouvernance open source.

Artefacts :

  • LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md.

Agent CI/CD

Rôle (Responsable) :

  • Maintenir la pipeline CI/CD.
  • Assurer la qualité des builds.
  • Optimiser l'automatisation.

Artefacts :

  • .gitea/workflows/, scripts/.

Agent Security

Rôle (Responsable) :

  • Maintenir la sécurité du code.
  • Assurer la qualité des audits de sécurité.
  • Optimiser la gestion des vulnérabilités.

Artefacts :

  • SECURITY.md, docs/SECURITY_AUDIT.md.

Agents complémentaires

Agent Performance

Rôle (Consulté) :

  • Optimiser les performances frontend.
  • Assurer la qualité des métriques.
  • Optimiser l'expérience utilisateur.

Artefacts :

  • src/, dist/.

Agent Accessibility

Rôle (Consulté) :

  • Maintenir l'accessibilité de l'interface.
  • Assurer la conformité WCAG.
  • Optimiser l'expérience pour tous les utilisateurs.

Artefacts :

  • src/components/, src/pages/.

Agent Internationalization

Rôle (Consulté) :

  • Maintenir l'internationalisation.
  • Assurer la qualité des traductions.
  • Optimiser l'expérience multilingue.

Artefacts :

  • src/locales/, src/i18n/.

Matrice de coordination

Agent Frontend WASM Tests Docs CI/CD Security
Fondation
Structure
Vue.js 🔴
TypeScript 🔴 🔴
UI/UX 🔴
Rust 🔴 🔴
WASM 🔴 🔴
Silent Payments 🔴 🔴 🔴 🔴
Tests Frontend 🔴 🔴
Tests WASM 🔴 🔴
Tests E2E 🔴 🔴 🔴
Documentation 🔴
API Documentation 🔴 🔴 🔴
User Documentation 🔴 🔴
Open Source 🔴
CI/CD 🔴 🔴 🔴 🔴
Security 🔴 🔴 🔴 🔴
Performance 🔴 🔴
Accessibility 🔴
Internationalization 🔴

Légende :

  • 🔴 Responsable - Agent principal pour ce domaine
  • Consulté - Agent consulté si nécessaire
  • Tous - Applicable à tous les domaines

Conclusion

Cette organisation des agents assure une couverture complète du projet ihm_client avec des responsabilités claires et une coordination efficace. Chaque agent contribue à maintenir la qualité, la sécurité et la performance de l'interface utilisateur pour les Silent Payments.


Objectif : Maintenir ihm_client comme une interface utilisateur moderne, sécurisée et performante pour les Silent Payments. 🚀