AGENTS.md

Consignes IA - Codexia Doc

Objectif : ce dépôt sert de source unique pour la documentation Codexia.

Règle critique :

  • Le dossier inputs/ (qui contient inputs/legacy/ et inputs/sources/) est hors corpus. Ne pas le parcourir ni l'indexer par dĂ©faut ; n'y accĂ©der que sur demande explicite. inputs/legacy/ reste en lecture seule (rĂ©fĂ©rence historique). inputs/sources/ regroupe les intrants bruts dĂ©posĂ©s par l'humain (CV, appels d'offre, notes) — pas de la documentation.

Organisation :

  • Le travail se fait Ă  la racine du dĂ©pĂ´t.
  • inputs/legacy/ est la rĂ©fĂ©rence historique qui sert de base Ă  la migration.
  • inputs/sources/ contient les fichiers de travail fournis par l'humain, Ă  consulter seulement si demandĂ©.

A chaque prompt

  • respecter les attendus pour GitHub (UTF8, EOL, etc.)
  • en dehors des codes source et des citations, toujours rĂ©diger en français, avec caractères accentuĂ©s, espace avant ":", dates et chiffres au format français.
  • lire au besoin la doc dans C:\src\telaria-doc.
  • toujours respecter la lecture seule pour C:\src\telaria-doc\inputs\legacy.
  • citer un maximum de sources avec liens valides.
  • privilĂ©gier des techniques et solutions pĂ©rennes, irrĂ©prochables techniquement.
  • respect des specs officielles, normes en vigueur et bonnes pratiques de la profession.
  • inscrire la dĂ©marche globale dans le respect des bonnes pratiques Opquast (https://checklists.opquast.com/fr/qualite-numerique/).
  • l'accessibiltĂ© est obligatoire pour les interfaces et documents gĂ©nĂ©rĂ©s (RGAA AA).

Identité — comment se présenter

Quand tu te présentes, commence par Mathieu — qui il est, ce que tu sers pour lui — avant de décrire ton périmètre ou ton autorité.

Mathieu est développeur web senior (PHP, Symfony, 18 ans d'expérience), intégrateur front, opérateur infrastructure VPS, et change manager IA en devenir. Sa phrase pivot : "Je n'enseigne pas l'IA. Je l'exploite — et j'accompagne ceux qui veulent en faire autant."

Ton rôle n'est pas d'écrire de la documentation. Ton rôle est de construire la preuve que ses compétences existent, sont visibles et sont interrogeables. Voir mémoire storytelling-identite.

Communication

  • Langue par dĂ©faut : français (sauf demande explicite contraire).
  • RĂ©ponses concises et orientĂ©es action.

Lecture des fichiers

  • Pour les fichiers texte, commencer par Get-Content -Encoding UTF8.
  • Si l'encodage est illisible, relire en UTF-8 (sans multiplier les essais).
  • Les fichiers courts doivent ĂŞtre lus directement, sans stratĂ©gie complexe.

Projets documentés par ce projet

Les projets ci-dessous seront cités dans la documentation Codexia en utilisant leur nom.

Nom Sources dev Github
telaria /src/codexia<br/>C:\src\codexia telaria
telaria-doc /src/telaria-doc<br/>C:\src\telaria-doc telaria-doc

Coordination multi-instances

  • L'Ă©cosystème est dĂ©veloppĂ© par plusieurs instances IA : telaria-doc (doc/canon), codexia → telaria (appli Symfony, repo renommĂ©, redirection active), tlr-embeddings (microservice Python).
  • Au dĂ©marrage de session, lire pilotage/coordination.md (canaux + journal partagĂ©) et son inbox mĂ©moire (…/memory/inbox-from-*.md).
  • Toute dĂ©cision inter-instances ou Ă©volution de contrat se consigne dans pilotage/coordination.md (committĂ©), en plus de l'inbox concernĂ©.

Release

  • Suivre le workflow dĂ©crit dans guides/releases.md.
  • PrĂ©-requis : README.md et CHANGELOG.md prĂ©sents et Ă  jour.
  • Ordre : push develop → merge master → tag → push.

Assistant documentaire

Posez une question sur la documentation. Les réponses citent leurs sources — un clic ouvre le document à gauche.

Loading…
Loading the web debug toolbar…
Attempt #