Directives et Instructions pour les Sessions d’Agents — COHABITAT.CC

Ce document compile les règles impératives, conventions éditoriales, architecture technique et contexte juridique nécessaires pour toute session d’assistant IA ou d’agent intervenant sur ce dépôt.

Le site web principal et les documents de gouvernance se trouvent dans le sous-dossier cohabitat.cc/ (dépôt officiel : github.com/cohabitat-cc/cohabitat.cc).

1. RÈGLE FONDAMENTALE ET ABSOLUE (HARD CONSTRAINT)

[!CAUTION]

RÈGLE 1 : NE JAMAIS MODIFIER L’INDEX GIT OU LE DÉPÔT DISTANT

Il est strictement interdit pour l’agent d’exécuter des commandes qui modifient le staging ou le remote Git :

❌ JAMAIS de git add

❌ JAMAIS de git commit

❌ JAMAIS de git push

❌ JAMAIS de git checkout -b ou manipulations d’index.

Laissez TOUJOURS l’utilisateur effectuer lui-même les opérations de staging (git add), de commit et de synchronisation distante. L’agent doit se limiter à la création/modification des fichiers dans l’arbre de travail (working tree) et à des commandes d’inspection non destructives (git status, git diff).

2. PRÉFÉRENCES DE TEST ET ENVIRONNEMENT LOCAL

Tests manuels par l’utilisateur :
- L’utilisateur préfère vérifier le rendu et naviguer lui-même dans son navigateur sur http://127.0.0.1:4000. Ne pas lancer d’outils de test automatisé du navigateur sauf demande explicite.
Gestion de l’encodage et de la locale UTF-8 (macOS / Nix) :
- Jekyll sur macOS peut planter lors de la compilation avec l’erreur invalid byte sequence in US-ASCII si des fichiers contiennent des caractères accentués.
- Toujours lancer Jekyll depuis cohabitat.cc/ en forçant la locale UTF-8 :
```
LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 nix-shell -p jekyll --run "jekyll serve --host 127.0.0.1 --port 4000"
```
- En arrière-plan, un processus démon Jekyll surveille le répertoire et regénère les fichiers en ~30 ms dès qu’un fichier est modifié.
Environnement Python (.venv) & Pillow :
- Un environnement virtuel .venv est configuré à la racine du projet (.venv/).
- Toujours exécuter les commandes, scripts et outils Python via cet environnement virtuel (ex. .venv/bin/python, .venv/bin/pip ou source .venv/bin/activate) de façon consistante, plutôt que d’invoquer le python3 global du système.
- La bibliothèque Pillow est installée dans .venv. Ne jamais utiliser l’utilitaire système macOS sips qui échoue dans le sandbox IDE (erreur 13 d’accès à /var/folders/). Toujours utiliser les scripts Python internes.

Scripts d’automatisation du blogue (scripts/) :

Génération instantanée de visuels LinkedIn (1200x627, ratio 1.91:1) :

.venv/bin/python cohabitat.cc/scripts/generate_social_preview.py cohabitat.cc/assets/images/.../image.png

Scaffolding complet et structuré d’un nouvel article :

.venv/bin/python cohabitat.cc/scripts/new_post.py --title "Titre" --image "cohabitat.cc/assets/..."

Environnement Nix et dépendances :
- Utiliser Nix / nix-shell (ou direnv / flake.nix) pour exécuter et charger de manière consistante les dépendances de développement (Jekyll, packages, etc.) afin d’isoler l’environnement sans dépendre d’installations globales ou d’états machine non reproductibles.
Périmètre des recherches et outils d’inspection (Grep / Find) :
- Restreindre impérativement le périmètre à cohabitat.cc/ : Le workspace parent contient d’autres projets volumineux (comme OpenConstructionERP/ avec des catalogues et changelogs de milliers de lignes). Ne jamais lancer de recherche globale non filtrée à la racine du workspace.
- Cibler par type de fichier et termes contextuels : Toujours spécifier un filtre de fichiers (ex. Includes: ["*.md"] ou *.html) et utiliser des termes contextuels précis (ex. "règlement 1.2" ou "### 1.2"). Ne jamais chercher de chaînes numériques génériques ou isolées (comme "1.2" ou "1.3") qui engendrent un bruit massif et inutile (valeurs CSS, numéros de version, etc.).

3. CONTEXTE JURIDIQUE ET IDENTITÉ DU PROJET

Statut légal

Personne morale sans but lucratif (OBNL) : En cours de constitution sous la Loi sur les compagnies du Québec (RLRQ, c. C-38, Partie III) auprès du Registraire des entreprises du Québec (REQ).
Mention obligatoire du statut : Toujours identifier et rappeler clairement que la requête pour obtenir les lettres patentes est « en cours » (ne pas affirmer que l’incorporation est déjà finalisée tant que les lettres patentes ne sont pas délivrées).
Siège social : District judiciaire de Montréal, municipalité de Montréal, Québec.
Plafond patrimonial autorisé : Jusqu’à 50 000 000 $ CAD en biens immobiliers (revenus annuels max 5 000 000 $ CAD).

Requérants et premiers administrateurs provisoires

Ricky Ng-Adam : Ingénieur logiciel, architecte de systèmes civiques chez HABILE.ca, fondateur de Coderbunker, ex-Google.
Claire Buffet : Direction de la production et des opérations, ex-VP Opérations chez Cloud Imperium Games, associée 15 ans chez Turbulent.
Philippe Chartier : Analyste en information et systèmes à l’Université de Montréal, ex-spécialiste gouvernance des données au CN (12 ans).

Les 7 Objets statutaires de la corporation (Art. 5 de la requête)

Habitats écologiques partagés : Développer, construire, acquérir et administrer des ensembles immobiliers sans but lucratif avec espaces privatifs compacts et infrastructures mutualisées.
Épanouissement humain, laïque et démocratique : Milieu multigénérationnel, fondé sur la raison, l’autonomie et l’égalité stricte, sans dogme, hiérarchie spirituelle ni vénération d’aucune autorité personnelle.
Ancrage dans l’économie sociale : Priorité aux partenariats et approvisionnements avec coopératives, mutuelles et OBNL québécois.
Mutualisation, fabrication locale et résilience : Fablabs, ateliers d’autoréparation mécanique vélo, réserves collectives d’urgence.
Mobilité active et transition écologique : Mode de vie sans automobile individuelle solo, flottes de vélos-cargos et autopartage électrique.
Défense d’intérêts et représentation civique : Plaidoyer public non partisan auprès des instances publiques et municipales.
Recherche libre et financement solidaire : Diffusion sous licences ouvertes (open source / Creative Commons) et recours aux obligations communautaires.

Les 7 Principes fondamentaux de gouvernance (Art. 6)

Langue officielle : Le français est la langue officielle de travail, d’administration et de communication interne.
Laïcité, égalitarisme et prévention de l’emprise personnelle : Organisation strictement laïque et rationnelle. Tout prosélytisme spirituel, religieux ou sectaire est interdit. Aucun membre ne peut s’arroger un statut de guide spirituel, de gourou ou d’autorité doctrinale.
Neutralité politique : Action strictement non partisane, aucune affiliation ni contribution à des entités politiques.
Absence de gain pécuniaire : Réinvestissement intégral des surplus dans la mission et le fonds de réserve écologique.
Prise de décision agile par consentement : Sociocratie (absence d’objections raisonnables argumentées), cercles décentralisés et bilans critiques systématiques (post-mortems et analyse de cause racine).
Portes de sortie équitables et claires : Protocoles d’intégration, de départ volontaire et d’exclusion motivée garantissant dignité individuelle et sérénité collective.
Dévolution des biens à la dissolution (Asset Lock) : En cas de dissolution, transfert impératif de tout l’actif net résiduel à des OBNL, coopératives ou fiducies d’utilité sociale (FUS) foncières du Québec.

4. ARCHITECTURE DU CODE ET SYSTÈME DE DESIGN

Stack technique : Jekyll statique, Markdown Kramdown (GFM), syntax highlighter Rouge, Vanilla CSS. Aucun framework CSS tiers (pas de Tailwind).
Typographie : Google Fonts (Inter pour le corps de texte, Playfair Display pour les titres et accents éditoriaux).
Couleurs du thème :
- Primaire : --color-primary: #064E3B (Vert forêt profond)
- Accent : --color-accent: #C2410C (Ambre / rouille chaleureux)
- Fond neutre doux : --color-secondary: #FAFAF9 (Sable clair)
- Texte : --color-text: #1C1917 (Anthracite chaud)
Règle impérative pour les fichiers Markdown : Rédigez toujours en Markdown simplifié pur (titres #, ##, listes à puces -, citations > , tableaux | ... |). Évitez toute balise HTML (<div>, <section>, <p style="...">) qui nuit à l’édition citoyenne. Utilisez le gabarit layout: page qui injecte automatiquement la bannière d’en-tête (Hero) et le conteneur typographique .markdown-content.

5. CONVENTIONS ÉDITORIALES PAR TYPE DE CONTENU

A. Articles de blogue (`cohabitat.cc/_posts/`)

Nom de fichier : _posts/YYYY-MM-DD-titre-en-kebab-case.md.

Front Matter YAML obligatoire :

---
layout: post
title: "Titre percutant"
subtitle: "Sous-titre descriptif en une phrase"
date: YYYY-MM-DD HH:MM:SS -0400
author: "Ricky Ng-Adam" # ou "Équipe cohabitat.cc"
categories: [urbanisme, participation-citoyenne]
tags: [mot-cle-1, mot-cle-2]
image: "/assets/images/nom-image.jpg"
image_caption: "Légende de l'image d'en-tête ou de l'illustration dans l'article."
# Image optimisée spécifique pour LinkedIn et Open Graph (optionnel mais fortement recommandé) :
linkedin_image: "/assets/images/og-nom-image.jpg"
og_image: "/assets/images/og-nom-image.jpg"
linkedin_image_width: 1200
linkedin_image_height: 627
description: "Résumé concis pour SEO et partages Open Graph (1 à 2 phrases)."
---

Règle pour les prévisualisations LinkedIn et réseaux sociaux :
- Si l’illustration de l’article (image:) est un schéma vertical, un tableau, un graphique ou une capture de document (ratio différent de 1.91:1), toujours générer et spécifier un bandeau horizontal dédié sous linkedin_image:.
- Le robot de prévisualisation LinkedIn exige un ratio 1.91:1 (idéalement 1200 × 627 px), un poids inférieur à 5 Mo, un format JPG ou PNG (éviter WebP pour les crawlers sociaux) et un nom de fichier ASCII pur (sans espaces ni accents).
Style rédactionnel : Accroche en citation d’exergue (> **« ... »**), structure fluide avec intertitres (###), liens hypertextes vers les organisations citées.

B. Membres de l’équipe (`cohabitat.cc/membres.md`)

Centralisé dans le front matter YAML sous la clé members:.
Chaque entrée comprend : name, role, linkedin, avatar (/assets/images/members/...), bio, experience (liste à puces de 3-4 faits marquants).
Les photos d’avatar doivent être carrées (min. 400x400 px).

C. Règlements généraux (`cohabitat.cc/_reglements/` et `cohabitat.cc/reglements.md`)

Décomposé en fichiers Markdown individuels dans cohabitat.cc/_reglements/ (un fichier par article : 01-...md à 09-...md).
Rédigé en Markdown pur (syntaxe ### X.Y Titre de clause) sans balises HTML afin de permettre une édition immédiate par n’importe quel contributeur via l’éditeur web GitHub.
La page reglements.md assemble dynamiquement la collection Jekyll, génère le sommaire latéral et intègre un bouton d’édition directe pour chaque article.
L’Article 9 formalise la gouvernance ouverte et la possibilité d’amender les statuts par demande de fusion (pull request) GitHub.

D. Résolutions du Conseil d’administration & Décisions de l’Exécutif (`cohabitat.cc/ca/`)

Registre numérique formalisé des décisions du CA (cohabitat.cc/ca/resolutions/) en vertu de l’article 89.1 de la Loi sur les compagnies du Québec (Partie III).
Délégation de gestion courante (< 5 000 $) au Comité exécutif (cohabitat.cc/ca/exec/decisions/ avec nomenclature EXEC-YYYY-XX).
Approbation par écrit via les revues GitHub (Review > Approve) valant signature légale.

E. Projets et Sites concrets de cohabitats (`cohabitat.cc/projets/`)

Gabarit officiel : cohabitat.cc/projets/modele-fiche-projet.md avec front matter YAML et arrimage aux résolutions CA/Exec.
Toute nouvelle proposition de site est versée sous projets/YYYY-nom-du-projet.md.
Critères obligatoires d’un site : zéro case de stationnement pour auto solo (100 % mobilité active), haute mutualisation (cuisine partagée, atelier vélo), déspéculation permanente (OBNL ou FUS foncière), laïcité stricte.

F. Métadonnées SEO & Réseaux sociaux (`cohabitat.cc/_includes/seo.html`)

Domaine de référence absolu : https://cohabitat.cc.
Génération automatique et cascade d’images :
- Priorité : page.linkedin_image > page.og_image > page.image > site.linkedin_image > site.og_image > site.image > /assets/images/og-cohabitat-concept.jpg.
- Les URLs d’images et canoniques sont toujours générées en HTTPS absolu avec protection uri_escape.
Balises de secours spécifiques LinkedIn :
- <meta name="image" content="..."> et <link rel="image_src" href="..."> sont automatiquement injectés comme fallbacks natifs recherchés par le scraper LinkedIn.
- <meta name="author" content="..."> est injecté au niveau standard pour renseigner l’auteur dans l’aperçu LinkedIn.
- Données structurées Schema.org JSON-LD (BlogPosting et WebPage) avec objet image détaillé (ImageObject avec largeur/hauteur).
Contraintes techniques LinkedIn à respecter pour toute nouvelle image :
- Ratio d’aspect : 1.91:1 (résolution standard : 1200 × 627 px ou 1200 × 630 px).
- Poids du fichier : Moins de 5 Mo impérativement (idéalement 100 à 300 Ko en JPG optimisé).
- Formats compatibles : JPG ou PNG (éviter WebP pour les cartes sociales).
- Nomenclature : Caractères ASCII stricts sans espaces ni accents (ex. og-titre-article.jpg).
Cache LinkedIn (7 jours) & Purge :
- LinkedIn met en cache les métadonnées pendant 7 jours après la première tentative de partage.
- Lors de la publication ou modification d’un article, toujours inviter l’utilisateur à purger le cache via le LinkedIn Post Inspector avant ou immédiatement après la mise en ligne.

6. SOMMAIRE RAPIDE DES CHEMINS CLÉS

Fichier / Dossier	Description
`cohabitat.cc/_posts/`	Articles du blogue
`cohabitat.cc/_reglements/`	Articles des règlements en Markdown individuel (01 à 09)
`cohabitat.cc/ca/resolutions/`	Registre des résolutions écrites du Conseil d’administration
`cohabitat.cc/ca/exec/`	Décisions déléguées du Comité exécutif (< 5 000 $)
`cohabitat.cc/scripts/`	Scripts Python d’automatisation (recadrage social, scaffolding de posts)
`cohabitat.cc/.github/`	Gabarits de demandes de fusion (pull request) pour règlements et CA
`cohabitat.cc/formation-gouvernance.md`	Manuel de gouvernance & Guide de formation des membres
`cohabitat.cc/organisation.md`	Structure organisationnelle, délégation des pouvoirs et 5 paliers
`cohabitat.cc/gouvernance.md`	Guide public de prise de décision par consentement et demandes de fusion (pull request)
`cohabitat.cc/membres.md`	Liste YAML des fondateurs et membres actifs
`cohabitat.cc/a-propos.md`	Présentation institutionnelle, statut légal REQ et 7 objets
`cohabitat.cc/reglements.md`	Page publique assemblant la collection des règlements
`cohabitat.cc/projets/`	Gabarit et fiches de sites de cohabitats modulaires
`cohabitat.cc/projets.md`	Page publique de présentation des projets
`cohabitat.cc/_includes/navbar.html`	Menu de navigation principal
`cohabitat.cc/_layouts/default.html`	Gabarit de base et pied de page
`cohabitat.cc/_includes/seo.html`	Métadonnées Open Graph, Twitter Cards et URLs canoniques
`cohabitat.cc/style.css`	Feuille de style principale
`cohabitat.cc/README.md`	Documentation publique et guide des contributeurs
`.agents/skills/blog-post/`	Skill Antigravity pour la création et publication d’articles