Codebase Design
Un vocabulaire partagé pour concevoir des modules profonds — petites interfaces, vraies coutures, testables par construction
- Quoi
- Un vocabulaire partagé pour concevoir des modules profonds — petites interfaces, vraies coutures, testables par construction
- Coût
- Gratuit
- Prérequis
- un compte Muse avec l'installation de skills activée
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — un skill de vocabulaire de conception qui donne des mots exacts pour dessiner des modules profonds : beaucoup de comportement derrière une petite interface. Il définit module, interface (tout ce qu'un appelant doit savoir — pas juste la signature de types), implémentation vs adaptateur, profondeur (le levier à l'interface), couture (là où vit l'interface), adaptateur, levier (ce que gagnent les appelants) et localité (ce que gagnent les mainteneurs) — en bannissant les substituts flous : ni « component », ni « service », ni « API », ni « boundary ». Principes inclus : le test de suppression (supprimez le module — la complexité disparaît-elle ou réapparaît-elle chez les appelants ?), « l'interface est la surface de test », et « un adaptateur = couture hypothétique, deux = vraie couture ». La testabilité en découle : acceptez les dépendances au lieu de les créer, retournez des résultats plutôt que des effets de bord, gardez la surface petite. Crédit : @mattpocock. Bémols honnêtes : c'est une référence à consulter, pas une session à lancer — il change la façon dont l'agent parle du design plutôt que de designer à votre place ; les approfondissements (approfondir un cluster, design-it-twice avec sous-agents parallèles) vivent dans les fichiers compagnons du dépôt. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.
Version :
Installation
Prérequis : un compte Muse avec l'installation de skills activée Installe-moi « Conception de modules ». Un vocabulaire partagé pour concevoir des modules profonds — petites interfaces, vraies coutures, testables par construction Dépôt : https://github.com/mattpocock/skills/blob/main/skills/engineering/codebase-design/SKILL.md 1. Récupère le fichier SKILL.md (et les fichiers auxiliaires) depuis le chemin du dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Contrôle de sécurité : examine le SKILL.md et les scripts pour tout comportement suspect (appels réseau inattendus, commandes shell, récolte d'identifiants). Ce dépôt ne doit contenir aucun secret dans le code, les identifiants passent uniquement par le coffre sécurisé. Vérifie que c'est bien le cas ; ARRÊTE sur le moindre drapeau rouge et dis-le-moi. 3. Installe-le comme skill : copie SKILL.md et ses fichiers auxiliaires dans le répertoire des skills de l'agent, dans un dossier nommé « mattpocock-codebase-design ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (ex. enregistrer ma clé API dans le coffre). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne l'exige jamais sauf si c'est dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête et demande-moi.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours une création avant de l’installer.