¶ Playbook (Debug / Maintenance / Développement)
Ce document définit nos règles de travail persistantes pour tous les échanges.
À chaque fois que tu me demandes quelque chose (implémentation, correction, déploiement, investigation), je commence par produire un plan qui précise :
- ce que je vais faire (étapes concrètes)
- ce que ça implique (fonctionnalités impactées, périmètre)
- les risques (régression, downtime, sécurité, perte de données)
- l'estimation (ordre de grandeur : rapide / moyen / long)
Ensuite seulement, je passe à l'exécution.
¶ 2) Contexte d'infra à maintenir
- Notre infrastructure cible est Debian.
- Notre workflow principal est Docker (et Docker Compose).
- Les déploiements seront favorisés via Docker/Compose.
- Les déploiements seront aussi favorisés via dockhand (quand c’est disponible/pertinent).
- On garde une version du
docker-compose.yml (ou équivalent) dans un dossier approprié et versionné (ex : Docker-Composes/).
Je dois relire/mettre à jour une trace dans docs/MEMORY.md pour tenir compte :
- de ce qui tourne déjà (containers, services, ports)
- des contraintes connues (volumes, réseaux, reverse proxy, domaines)
- de l'état actuel des dossiers Compose versionnés
- Toute mise en place et toute modification doivent être documentées.
- On maintient un worklog dans
docs/WORKLOG.md.
- Quand c'est pertinent, on mentionne :
- quels fichiers ont été modifiés/ajoutés
- quel dossier Compose est utilisé
- quelles commandes ont servi à valider
Objectif : que toute notre documentation en Markdown soit facilement consultable depuis l’interface web.
Règles :
- La source de vérité des docs est
docs/*.md (dans le repo/workspace).
- Si on utilise Docmost : on suit la procédure documentée dans
docs/DOCMOST-IMPORT.md.
- Si on utilise Wiki.js : on considère
docs/ comme la source de vérité, puis on met à jour les pages Wiki.js (import éventuel selon les capacités de Wiki.js).
Fréquence recommandée :
- Après chaque modif significative (nouvelle procédure, nouveau stack compose, changement de workflow), on publie la doc correspondante dans l’outil choisi (Docmost ou Wiki.js).
Quand tu connectes GitHub privé :
- on créera de nouveaux répertoires et versions
- on privilégiera une approche “petits commits / PR claires”
- on évite de laisser des modifications non documentées