Migrations Cloudflare D1 & Seeding de Production

Ce qu'il fait

Cette compétence ajoute un workflow concret pour traiter les bases de données Cloudflare D1 comme du schéma-as-code : elle définit les fichiers de schéma initiaux, crée et applique des migrations ordonnées via Wrangler, et fournit des modèles de seeding sensibles à l'environnement pour le dev/test. Elle met l'accent sur les migrations sécurisées en ajout seul (append-only), les backfills et l'évolution non destructive du schéma en plusieurs étapes afin de préserver les données de production.

Quand l'utiliser

Utilisez cette compétence lorsque vous devez : configurer des migrations D1 pour une application Worker/Hono, appliquer des modifications de schéma à travers dev→staging→prod, générer ou exécuter des scripts de seed pour le dev/test, ou planifier des migrations de données complexes/backfills devant éviter les interruptions de service ou les pertes de données. Évitez de l'utiliser pour le code de requête TypeScript ou la logique de routage non liée.

Ce qui est inclus

• Scripts : aucun script packagé, mais la compétence recommande des commandes Wrangler et des extraits de scripts package.json pour migrate/apply/seed.
• Références : conseils pour la structure de projet recommandée (db/migrations, db/seeds, src/db/schema.sql) et commandes Wrangler.
• Instructions : explique la création de fichiers de migration horodatés, l'application des migrations localement et aux environnements, les modèles de seeding et les stratégies d'évolution de schéma/backfill en plusieurs étapes.

Agents compatibles

Outillage compatible inféré : agents et environnements pouvant exécuter des commandes shell/CLI (Wrangler) et fournir des conseils au niveau du code — par exemple, Claude Code, assistants de type Codex/Copilot opérant sur des fichiers de dépôt.