Imported from Alpinechain/Alpinechain_Association (AGENTS.md). Install upstream with npx skills add Alpinechain/Alpinechain_Association. Copyright stays with the author.

AGENTS.md

Instructions pour les agents IA travaillant sur le dépôt AlpineChain Association.

Version : V0.8 Dernière mise à jour : 2026-09-06

1. Rôle du dépôt

Ce dépôt est le centre de pilotage des activités associatives AlpineChain :

• gouvernance et coordination ;
• Meetup Bitcoin Annecy ;
• Souveraineté 3.0 ;
• B-Only ;
• communication et calendrier éditorial ;
• actions, décisions et risques ;
• capitalisation après événement ;
• usage structuré de l’IA.

Le fichier de cadrage est ALPINECHAIN_ASSOCIATION_OS.md. Le point d’entrée opérationnel est dashboard/NOW.md.

2. Principe général

Un agent IA ne décide pas à la place de l’association.

Il peut cadrer, structurer, rédiger, relire, documenter, proposer, coordonner et signaler les risques.

Il ne doit pas :

• publier automatiquement ;
• inventer des décisions associatives ;
• parler au nom du bureau sans validation ;
• présenter une hypothèse comme une décision validée ;
• copier des secrets ou données personnelles inutiles dans GitHub ;
• transformer AlpineChain en canal commercial.

3. Sources de vérité

Une conversation ChatGPT peut préparer une décision ou une action. Toute information durable doit être consolidée dans la source de vérité appropriée.

Pour chaque écriture comptable, la pièce justificative est stockée dans Nextcloud. Paheko conserve dans l’écriture la référence précise du document ou de son dossier Nextcloud. Il n’est pas nécessaire de joindre une seconde copie du fichier dans Paheko.

Les textes, calendriers, fichiers de liens et preuves publiques ne sont pas dupliqués dans Nextcloud. GitHub en conserve l'unique version de référence.

4. Agent coordinateur

L’agent coordinateur est prioritaire lorsqu’une tâche touche à plusieurs projets ou fichiers.

Sa mission :

• identifier le projet et le résultat attendu ;
• vérifier le périmètre et la source de vérité ;
• empêcher les doublons ;
• maintenir une structure courte et lisible ;
• créer ou mettre à jour les Issues nécessaires ;
• proposer la prochaine action utile ;
• signaler clairement les limites et les échecs.

Règle :

Un fichier créé doit avoir un rôle clair, sinon il n’est pas créé.

5. Rôles IA autorisés

6. Règles de production

Avant toute production, identifier :

Projet : [association | meetup-bitcoin | souverainete | b-only]
Objectif : [objectif unique]
Public : [public cible]
Sortie attendue : [format]
Contraintes : [contraintes connues]
Validation : humaine avant publication

Pour les contenus publics, vérifier le CTA, le lien, la date, le lieu, le format, le niveau technique et la cohérence AlpineChain.

Pour X, appliquer docs/GUIDE_REDACTIONNEL_X.md, notamment la limite interne de 240 caractères, lien compris, et les règles de thread. Cette limite est un plafond et non une longueur cible.

7. Gestion des actions

Une action concrète doit être créée ou suivie dans une Issue GitHub.

Chaque Issue doit comporter :

• un objectif ;
• un résultat attendu ou une Definition of Done ;
• un label project:* ;
• un label type:* ;
• un responsable lorsque possible ;
• une échéance dans le corps si elle est connue ;
• les dépendances ou validations nécessaires.

Le vocabulaire des labels est défini dans references/github-labels.md.

8. Structure

.
├── AGENTS.md
├── ALPINECHAIN_ASSOCIATION_OS.md
├── README.md
├── dashboard/
│   ├── NOW.md
│   └── .daily-review-state.json
├── skills/
│   ├── alpinechain-daily-review/
│   │   └── SKILL.md
│   ├── b-only-source-of-truth/
│   │   └── SKILL.md
│   └── publication-multicanale/
│       ├── SKILL.md
│       └── profiles/
│           ├── alpinechain.md
│           ├── b-only.md
│           ├── meetup-bitcoin.md
│           └── souverainete-3-0.md
├── projects/
│   ├── association/
│   ├── meetup-bitcoin/
│   ├── souverainete/
│   └── b-only/
├── references/
├── docs/
├── notes/
├── templates/
└── assets/

Rôles :

• dashboard/ : vue synthétique du présent ;
• skills/ : procédures IA réutilisables et versionnées ;
• projects/ : cadrage stable de chaque activité ;
• references/ : outils, labels, liens et conventions ;
• docs/ : documentation principale ;
• templates/ : modèles réutilisables ;
• notes/ : suivi périodique ;
• assets/ : index de ressources stockées ailleurs.

9. Skills locales

Lorsqu’une demande correspond à une Skill existante, l’agent doit lire son SKILL.md avant d’exécuter la tâche.

Commandes canoniques :

• Fais le point AlpineChain. → skills/alpinechain-daily-review/SKILL.md
• Contrôle B-Only. → skills/b-only-source-of-truth/SKILL.md
• Prépare la publication multicanale. → skills/publication-multicanale/SKILL.md

Les commandes canoniques sont des raccourcis mémorisables. Elles ne sont pas obligatoires : une formulation en langage naturel déclenche la Skill dès lors que l’intention correspond clairement à son périmètre.

Exemples :

• Qu’est-ce que j’ai à faire aujourd’hui pour AlpineChain ? → revue quotidienne AlpineChain ;
• Vérifie si le programme B-Only est cohérent. → contrôle source de vérité B-Only ;
• Est-ce que Bitstack est réellement payé ? → contrôle ciblé B-Only sur le statut financier de Bitstack ;
• Prépare les communications pour cette annonce B-Only. → publication multicanale avec le profil B-Only ;
• Fais les posts pour le prochain Meetup. → publication multicanale avec le profil Meetup Bitcoin Annecy ;
• Prépare une campagne pour Souveraineté 3.0. → publication multicanale avec le profil Souveraineté 3.0.

La Skill publication-multicanale est strictement associative. Elle route les demandes vers un profil local correspondant à la branche concernée : AlpineChain institutionnel, B-Only, Meetup Bitcoin Annecy ou Souveraineté 3.0. Elle ne doit jamais importer de données, comptes, CTA, ton ou contexte issus d’activités professionnelles ou personnelles.

10. Validation humaine

Validateur opérationnel actuel : Cyrille.

Aucun contenu généré par IA ne doit être considéré comme publiable sans validation humaine. Les partenariats, sujets sensibles, décisions du bureau et engagements financiers exigent une validation renforcée par la personne compétente.

11. Definition of Done minimale

Une tâche est terminée quand :

[ ] le livrable demandé existe ;
[ ] son rôle est clair ;
[ ] les actions sont tracées ;
[ ] il respecte le cadrage AlpineChain ;
[ ] les limites et échecs sont explicites ;
[ ] la prochaine action est identifiable ;
[ ] aucune publication automatique n’a été faite.

12. Utilisation de Codex

• Ouvrir ce dépôt dans une fenêtre et une discussion dédiées à AlpineChain ; vérifier le remote avant toute écriture. Le workspace personnel ~/.codex/alpinechain-association.code-workspace ouvre ce dépôt seul.
• Le modèle, le raisonnement et le style héritent de ~/.codex/config.toml : GPT-6 Astra, medium, pragmatic. Un effort high ponctuel convient aux rapprochements complexes ; le sélectionner dans l’interface si nécessaire.
• Avancer de façon autonome sur les lectures et préparations autorisées, puis présenter un livrable concret pour les validations humaines prévues ci-dessus. Une préparation autorisée ne vaut pas accord de publication, de fusion dans main ou d’engagement financier.
• Préserver les formulations validées. Distinguer explicitement PRÊT À RELIRE, PRÊT À PROGRAMMER, PROGRAMMÉ, PUBLIÉ, URLS ARCHIVÉES et MÉTRIQUES RELEVÉES ; ne déclarer un état que sur preuve actuelle. Un déploiement du programme ne prouve pas une publication sociale.
• Vérifier les informations changeantes dans les sources de vérité de la section 3. Utiliser l’historique pour retrouver le contexte, sans transformer une ancienne observation en état actuel.
• Pour la comptabilité, archiver chaque justificatif dans Nextcloud et inscrire sa référence précise dans l’écriture Paheko. Ne pas dupliquer la pièce dans Paheko et ne pas créer d’Issue uniquement pour suivre cette absence de copie.
• Exécuter les validations adaptées aux fichiers modifiés et examiner le diff. Pour une modification du programme, lancer node projects/b-only/programme/validate.mjs ; vérifier également git diff --check. Préserver les changements préexistants hors périmètre.