No description
- Add 05-documentation-writing-standard.md for proper documentation organization - Define decision process for shared vs project-specific documentation - Include checklist and automation scripts for doc creation - Update workflows README with new documentation standard - Ensure consistent documentation structure across all projects Features: - Decision algorithm for documentation location - Standard templates and structure - Integration with existing workflows - Automation script for doc creation - Examples and best practices |
||
|---|---|---|
| docs | ||
| examples | ||
| scripts | ||
| templates | ||
| workflows | ||
| .gitignore | ||
| cloud-sync.md | ||
| init-git-sharing.sh | ||
| README.md | ||
| share-to-station.sh | ||
| sync-docs.sh | ||
| update-projects.sh | ||
| UPDATE_SUMMARY.md | ||
| USAGE.md | ||
| watch-sync.sh | ||
🤖 AI Agents Workflows
Repository partagé des workflows et documentation pour agents IA.
🎯 Objectif
Centraliser et partager les workflows standards pour le développement avec agents IA, incluant l'intégration Git et Plane.
📂 Structure
AiAgentsWorkflows/
├── workflows/ # Workflows standards
│ ├── 01-before-feature-standard.md
│ ├── 02-after-feature-standard.md
│ ├── 03-bug-fix-standard.md
│ ├── 05-workflow-management-standard.md
│ └── project-specific/ # Workflows spécifiques par projet
├── docs/ # Documentation
│ ├── ai-agents/ # Documentation théorique IA
│ │ ├── overview.md # Types d'agents et architecture
│ │ ├── patterns.md # Patterns courants (Chain of Thought, etc.)
│ │ └── frameworks.md # LangChain, AutoGPT, etc.
│ ├── guides/ # Guides pratiques
│ │ ├── getting-started.md # Créer son premier agent
│ │ └── workflow-management-guide.md
│ ├── integrations/ # Intégrations
│ │ ├── git-executors-setup.md
│ │ ├── plane-integration.md # ⭐ NEW: Gestion des tâches avec Plane
│ │ └── forgejo-integration.md (archived)
│ └── README.md
├── examples/ # Exemples pratiques
│ └── code-review-agent.md
├── templates/ # Templates
│ └── workflow-template.md
└── scripts/ # Outils d'automatisation
├── sync-docs.sh
├── watch-sync.sh
└── update-projects.sh
🚀 Utilisation Rapide
Pour un nouveau projet
-
Cloner ce repository
git clone <URL> ai-agents-workflows cd ai-agents-workflows -
Synchroniser les workflows
./scripts/update-projects.sh -
Utiliser les workflows standards
- Avant de coder:
workflows/01-before-feature-standard.md - Après avoir codé:
workflows/02-after-feature-standard.md
- Avant de coder:
Pour mettre à jour les workflows
- Modifier les workflows dans ce repository
- Synchroniser les projets
./scripts/update-projects.sh - Partager les modifications
git add . git commit -m "Update workflows: description des changements" git push
✨ Fonctionnalités
🔄 Workflows Standards
- Before Feature: Préparation avec Git + Plane
- After Feature: Finalisation avec Git + Plane
- Bug Fix: Processus de correction
- Pre Commit: Vérifications avant commit
📋 Intégrations
- Git: Synchronisation complète (pull/push/rebase)
- Plane: Gestion des tâches et suivi
- Multi-projets: Synchronisation automatique
🛠️ Outils
- sync-docs.sh: Synchronisation manuelle
- watch-sync.sh: Surveillance automatique
- update-projects.sh: Mise à jour des projets
🤖 Documentation IA
- AI Agents Overview: Types d'agents et patterns d'architecture
- Common Patterns: Chain of Thought, Tool Calling, Memory Management
- Frameworks: Comparaisons LangChain, AutoGPT, Custom Agents
- Getting Started: Guide pour créer votre premier agent
- Examples: Agent de code review et autres implémentations
🎯 Workflows Disponibles
01. Before Feature Standard
Préparation avant développement:
- Synchronisation Git (pull/fetch/rebase)
- Intégration Plane (tâche + échéances)
- Planification technique
- Configuration environnement
02. After Feature Standard
Finalisation après développement:
- Tests finaux et revue de code
- Finalisation Git (commit/push/PR)
- Nettoyage (rebase -i)
- Mise à jour Plane (statut + leçons)
03. Bug Fix Standard
Processus de correction de bugs:
- Identification du problème
- Correction et tests
- Validation et déploiement
04. Pre Commit Standard
Vérifications avant commit:
- Tests automatiques
- Validation du code
- Documentation
🌐 Partage Multi-Stations
Installation sur une nouvelle station
-
Cloner le repository
git clone <URL> /home/user/developpement/AiAGentsWorkflows -
Synchroniser les projets existants
cd /home/user/developpement/AiAGentsWorkflows ./scripts/update-projects.sh -
Utiliser les workflows dans chaque projet
Mise à jour entre stations
# Sur la station principale
git add .
git commit -m "Update workflows"
git push
# Sur les autres stations
git pull
./scripts/update-projects.sh
📊 Projets Supportés
- ✅ event-calendar
- ✅ girls-management
- ✅ girls-management-backend
- ✅ girls-management-nextjs
- ➕ Ajoutez facilement vos projets
🤝 Contribution
- Fork ce repository
- Créez une branche:
git checkout -b feature/workflow-amelioration - Modifiez les workflows
- Testez:
./scripts/update-projects.sh - Commitez:
git commit -m "Improve workflow: description" - Push:
git push origin feature/workflow-amelioration - Créez une Pull Request
📄 Licence
MIT License - Utilisez et adaptez librement
Dernière mise à jour: 2025-11-26 Version: 2.0 - Consolidated with ai-agents-docs + Plane integration