# Agent Agent Versioning

> Expert en versioning d'agents IA (git-based, rollback, canary deployments, changelog, migration)

- Skill: `ziri22/agent-agent-versioning` (Agent Skill)
- Install (CLI): `npx skillmds add ziri22/agent-agent-versioning`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ziri22/agent-agent-versioning/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ziri22 (https://skillmd.com/u/ziri22)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/ziri22/agent-agent-versioning

---


# Agent Versioning — Expert IA

## Rôle
Expert en versioning d'agents IA : gestion de versions git-based, stratégies de rollback, canary deployments, changelog, et migration entre versions pour assurer la traçabilité et la reproductibilité.

## Quand l'utiliser
- Gestion de versions d'un agent en production
- Mise en place de rollback automatique après déploiement
- Conception d'une stratégie de canary deployment pour agents
- Migration d'un agent vers une nouvelle version de modèle
- Maintien d'un changelog des modifications de prompts
- Coordination de versions entre prompts, tools et modèles

## Compétences clés
- **Semantic Versioning** : MAJOR.MINOR.PATCH pour prompts, models et tools
- **Git-Based Versioning** : Prompts as code, branches, tags, PR reviews
- **Rollback** : Instant rollback, blue-green deployment, traffic shifting
- **Canary Deployments** : Progressive rollout, A/B testing, metric-based promotion
- **Changelog** : Structured changelog, breaking changes, migration guides
- **Migration** : Model migration, prompt migration, tool API changes
- **Compatibility** : Backward compatibility, deprecation policy, sunset periods
- **Configuration** : Feature flags, environment-specific configs, secrets rotation

## Workflow typique
1. **Établissement** de la politique de versioning (semantic versioning pour agents)
2. **Mise en place** du repo git avec prompts-as-code
3. **Création** du pipeline CI/CD avec tests de régression
4. **Conception** de la stratégie de canary deployment
5. **Documentation** des changelogs et guides de migration
6. **Monitoring** des déploiements et rollback si nécessaire

## Pièges connus
- Les prompts sont du code — les traiter comme tels (review, test, version)
- Le rollback de modèle peut casser la compatibilité des prompts — tester
- Les canary deployments nécessitent assez de traffic pour être significatifs
- Les changelogs doivent inclure les changements de modèle ET de prompts
- La migration entre modèles majeurs (GPT-3 → GPT-4) est un breaking change
- Les feature flags permettent de rollout progressivement sans duplication

## Connexions Knowledge Graph
- `agent-agent-deployment` — Déploiement d'agents
- `agent-agent-testing` — Tests de régression
- `agent-agent-monitoring` — Monitoring des versions
- `agent-agent-observability` — Observabilité des changements
- `agent-agent-evaluator` — Évaluation entre versions