Files
IdeA/CLAUDE.md
2026-06-27 12:42:37 +02:00

3.4 KiB

IdeA — Contexte projet global

Contexte commun minimal du projet IdeA. Les détails spécialisés doivent vivre dans le contexte de l'agent propriétaire, pas ici.


1. Project root

Le project root est :

/home/anthony/Documents/Projects/IdeA

Les agents peuvent être lancés depuis un dossier d'exécution isolé .ideai/run/<agent>/, mais leurs travaux portent sur le project root.


2. Orchestration IdeA

Les agents collaborent via les outils IdeA natifs :

  • idea_list_agents pour lister les agents.
  • idea_ask_agent pour déléguer une tâche et recevoir la réponse finale capturée par IdeA.
  • idea_launch_agent pour lancer ou rattacher un agent.

Quand un agent est sollicité via IdeA, il répond normalement en fin de tour. IdeA capture automatiquement cette réponse finale ; les agents ne gèrent pas de ticket et n'appellent pas d'outil de remise de résultat.

Ne jamais utiliser les subagents natifs du fournisseur IA pour déléguer dans ce projet.


3. Rôles

  • Main : chef d'orchestre. Il découpe, délègue, relaie les résultats, arbitre le produit et garantit le cycle. Il ne code pas les features.
  • Architect : propriétaire de l'architecture hexagonale, SOLID, ports/adapters, contrats, DTO, invariants et cartographie.
  • DevBackend : implémentation backend Rust selon les contrats validés par Architect.
  • DevFrontend : implémentation UI TypeScript/React selon les contrats validés par Architect.
  • QA : tests unitaires/intégration ciblés, exécution réelle, rapports d'échec, re-test jusqu'au vert.
  • Git : propriétaire des branches, commits, merges/rebases locaux. Aucune action sortante sans validation explicite.

4. Cycle obligatoire

Pour toute feature ou correction applicative :

1. Architect cadre ou valide l'architecture et les contrats.
2. Git décide de la branche locale.
3. DevBackend et/ou DevFrontend implémente.
4. QA écrit/exécute les tests.
5. Si KO : Main relaie le rapport réel au dev, puis retour QA.
6. Si OK : Git committe et décide du merge local éventuel.

Une feature n'est terminée que lorsque les tests pertinents sont verts avec sortie réelle.


5. Produit : repères communs

IdeA est un IDE next-gen 100 % IA : l'utilisateur y pilote des agents IA plutôt que coder directement.

Repères stables :

  • Un onglet par projet, multi-fenêtres OS à terme.
  • Workspace organisé en terminaux/cellules redimensionnables.
  • Agents par projet, templates globaux, synchronisation template → agents.
  • Contextes d'agents en Markdown dans .ideai/.
  • Profils IA déclaratifs et éditables, configurés au premier lancement.
  • Git, SSH et WSL intégrés.
  • Stack validée : Tauri v2, Rust, TypeScript + React, xterm.js, portable-pty, git2/libgit2, russh/ssh2, wsl.exe.

Les détails d'architecture et de découpage technique appartiennent au contexte d'Architect. Les détails de développement et de test appartiennent aux contextes DevBackend, DevFrontend et QA.


6. Mémoire projet

Consulter la mémoire projet selon le besoin au lieu de recopier tous les détails ici :

  • agent-context-memory-and-profile-handoff
  • idea-product-directives-main-handoff
  • remaining-work-idea-agent-control-ide
  • mcp-bridge-and-delegation-runtime-notes
  • permissions-sandbox-system-state
  • session-limit-handling-design
  • git-owns-commit-merge-decisions
  • conversation-rotation-safety-design

Dernière mise à jour : 2026-06-20