BackboneNeo/ai-skills-hardware-wiring-diagrams

Workflow de schéma de câblage matériel

Considérez les fiches techniques et les dessins de connecteurs comme la source de vérité électrique. Considérez les photographies de composants comme une preuve de placement uniquement, sauf si leurs étiquettes de pastilles sont lisibles et l'orientation sans ambiguïté.

1. Établir le contrat de connexion

1. Inventoriez chaque composant, connecteur, broche, signal, domaine de tension, orientation et format de sortie demandé.
2. Enregistrez la source faisant autorité et la révision pour chaque brochage. N'inférez pas une affectation de broche à partir d'une photo de produit lorsqu'une fiche technique ou un schéma existe.
3. Normalisez chaque connexion dans une netlist lisible par machine avant de dessiner. Utilisez ensemble les numéros de broches physiques et les noms de signaux.
4. Marquez explicitement les broches inconnues, optionnelles, réservées, non connectées et les sources d'alimentation. Arrêtez-vous avant le routage si un brochage ou une tension critique pour la sécurité n'est pas résolu.
5. Distinguez un schéma de montage/câblage d'un schéma de principe. Maintenez-les synchronisés via la même netlist, même si un seul est montré à l'utilisateur.

Lisez source-truth-and-orientation.md avant d'interpréter des cartes tournées, des vues miroir, des photographies de dessous ou des faces d'accouplement de connecteurs. Lisez electrical-rules.md pour les vérifications des signaux et de l'alimentation.

2. Planifier la feuille avant le routage

1. Choisissez le format A4 ou A3 et réservez des zones pour le titre, les composants, les légendes de brochage, les notes et la légende.
2. Placez le contrôleur principal près du centre visuel. Mettez les périphériques près du côté du contrôleur auquel ils se connectent.
3. Faites pivoter l'image du composant et sa légende ensemble. Gardez chaque légende près du connecteur physique correspondant.
4. Utilisez une légende de brochage compacte lorsqu'un en-tête de carte est trop dense. Préservez l'ordre physique exact après rotation ou miroir.
5. Déplacez les étiquettes sur un côté libre avant le routage. Ne routez jamais à travers des photographies, des étiquettes, des numéros de broches ou des symboles de contact adjacents.

Lisez layout-and-callouts.md pour la composition A3, la légende GPIO et les motifs de cartes de composants.

3. Router les connexions de manière déterministe

1. Routez orthogonalement sauf si le projet exige explicitement un autre style.
2. Connectez depuis la limite d'une borne ou pastille étiquetée jusqu'à la limite de sa destination. Ne vous arrêtez pas avant, ne disparaissez pas sous une carte et ne traversez pas le centre du contact.
3. Réservez un canal par fil. Ne placez jamais deux segments de connexion sur le même segment géométrique.
4. Évitez les croisements. Si un croisement est inévitable, maintenez-le à 90 degrés, utilisez une convention de séparation visible et n'impliquez jamais une jonction.
5. Dessinez les routes sous les symboles de borne, puis redessinez les remplissages, numéros et étiquettes des bornes au-dessus des routes. Préservez un point d'extrémité visible au bord du contact.
6. Maintenez les routes parallèles séparées d'au moins l'écart de canal configuré, y compris leurs halos.
7. Appliquez le mappage de couleurs stable dans visual-language.md ; associez toujours la couleur à une étiquette de signal.

Utilisez scripts/validate_wiring.py après chaque modification de routage importante. Considérez tout chevauchement, intersection non intentionnelle, extrémité pendante, étiquette obscurcie ou connexion électrique invalide comme un candidat échoué.

4. Construire à partir de primitives SVG réutilisables

1. Commencez par wiring-a3-template.svg lorsqu'aucun modèle natif de projet n'existe.
2. Gardez les photos de composants dans assets/ ou le répertoire d'actifs du projet et référencez-les par chemin relatif.
3. Donnez aux routes, bornes, étiquettes, composants et zones de garde des ID stables et des attributs data-* sémantiques. Suivez svg-annotation-contract.md.
4. Placez les routes dans un calque dédié sous les bornes et le texte. Utilisez un halo uniquement pour séparer les routes de l'arrière-plan ; ne l'utilisez pas pour masquer une autre route.
5. Conservez le SVG éditable comme source. Produisez le PNG/PDF uniquement comme artefacts de révision dérivés.

5. Valider par couches

1. Exécutez l'analyse structurelle SVG et le validateur de câblage.
2. Vérifiez que chaque point d'extrémité de netlist existe exactement une fois et que chaque route se termine aux deux points d'extrémité déclarés.
3. Vérifiez la direction de l'alimentation, la compatibilité de tension, la masse commune, le croisement UART et les exigences spécifiques au bus.
4. Vérifiez la numérotation physique par rapport à l'orientation réelle affichée, y compris les indicateurs de broche 1 et les rangées paires/impaires.
5. Rendez la feuille complète et des recadrages en gros plan de chaque connecteur modifié.
6. Inspectez à la taille d'impression prévue. Les numéros de broches, les noms de signaux, l'identité du fil, le contact d'extrémité et les avertissements doivent rester lisibles.
7. Rerendez après chaque modification SVG ; ne signalez jamais la réussite sur la seule inspection de la source.

Utilisez scripts/render_svg.py. Dans Codex Desktop, chargez les dépendances de l'espace de travail lorsqu'elles sont disponibles ; le rendu détecte également automatiquement le Node.js et l'environnement d'exécution Sharp inclus pour la sortie PNG.

Lisez validation-gates.md avant de déclarer la fin. Lisez failure-patterns.md lors de la réparation d'un diagramme existant.

6. Livrer honnêtement

• Livrez le SVG éditable, un PNG rendu et un PDF si demandé.
• Indiquez le mappage exact broche-à-broche pour les connexions nouvellement ajoutées ou modifiées.
• Indiquez quels brochages ont été vérifiés par la source et quelles hypothèses subsistent.
• Signalez completed uniquement lorsque les portes structurelles, électriques, de routage et visuelles sont passées.
• Signalez blocked lorsqu'un brochage faisant autorité, une tension nominale, une orientation de connecteur ou une interprétation de face d'accouplement ne peut pas être établi.
• Ne prétendez jamais qu'une route visuellement plausible prouve la correction électrique.