API and Interface Design

npx skills add addyosmani/agent-skills --skill api-and-interface-design

Le point de départ est la loi de Hyrum : dès qu’une interface compte suffisamment d’utilisateurs, chaque comportement observable devient un contrat, y compris le texte des erreurs et l’ordre des éléments. La compétence préconise donc une surface exposée volontairement réduite, sans fuite de détails d’implémentation, ainsi qu’une stratégie de retrait définie dès la conception plutôt que découverte plus tard. La même approche s’applique aux endpoints REST, aux schémas GraphQL, aux frontières entre modules et aux propriétés des composants.