Travailler avec des outils d'IA sur une nouvelle bibliothèque

Ceci est le guide de configuration de TypeScript orienté chemin de fer. Si vous n'avez pas encore lu l'aperçu, commencez par là.

@ chemin de fer-ts/pipelineset@railway-ts/use-formsont nouveaux. Cela crée un problème pratique : les assistants de codage de l'IA – Claude Code, Cursor, GitHub Copilot – ont été formés sur des millions d'exemples de Zod, de réaction-hook-form et de ne jamais lancer. Ils n'ont presque aucune donnée de formation pour@chemin de fer-ts.

Le résultat est prévisible. Demandez à Claude Code de construire un formulaire avec@railway-ts/use-forminstallé et il écrirazodRésolveur,utiliserFormulaireà partir de la forme de crochet de réaction, etsetErreur/effacerErreurs- en toute confiance, sans qu'on le lui demande, car c'est le schéma qu'il a vu des milliers de fois. Ce n'est pas un code aléatoire hallucinant. Il s'agit d'une comparaison de modèles avec la réponse la plus probable dans sa distribution de formation. Le problème est que la réponse est mauvaise pour votre projet.

Ce n’est pas une critique des outils d’IA. Il s'agit d'une réalité structurelle concernant leur fonctionnement qui mérite d'être comprise et contournée.

Pourquoi les documents livrés avec le package sont importants

Les deux bibliothèques expédient désormais leur documentation dans le package npm :