Document qualified logic families and textured molecule model preservation - adom-molecule

Overview Files Skills Discover Packages Releases Dependencies Issues Breadcrumbs Pull Requests1 Activity

Document qualified logic families and textured molecule model preservation #1

Open opened by Ray 2026-09-11

Repeated logic-gate molecule work exposed guidance that encouraged repeated builds/screenshots, discarded detailed model textures, or conflated board revision with page title. This documentation change records the tested workflow and routes family generation/review to the focused skills in Logic Molecule Workflows.

The skill bundle is installed locally for Claude and Codex; registry publication is waiting on the required human Hero Studio step. The new guidance keeps electrical, grid, anchoring and ownership gates, distinguishes merged upstream fixes from installed versions, and preserves the existing source/CLI workflows outside this scope. The comparison prompt uses isolated work directories and identical inputs/checks; no Claude evaluation has been run.

Validation: the two new skills pass the skill validator and reference checks, and their installer passes isolated-home/idempotence/preservation checks. Workflow evidence comes from eight individually inspected local expansion boards with zero native KiCad violations/unconnected items and the detailed textured models of the five published gates. This is not a fabrication or bench qualification claim.

Ownership app checked on 2026-09-11: Drew owns adom-molecule; owner merges, others PR. Submitted by Ray for owner review. No runtime code or dependency upgrade is included. Related upstream fixes: tscircuit/core#3892, tscircuit/cli#4715, tscircuit/props#844 (merged); remaining presentation fixes are tracked in tscircuit/cli#4719, tscircuit/circuit-to-svg#739 and tscircuit/circuit-json-to-gltf#197.

Diff Skip to comments (1)

--- a/SKILL.md+++ b/SKILL.md@@ -1,246 +1,256 @@⋯ 11 unchanged lines ⋯  # Adom Molecule CLI +## Designing families and preserving detailed models++For new component-wiki-based logic molecules, use **adom-molecule-families** from `adom/logic-molecule-workflows`: reuse CO rankings and exact manufacturer assets, qualify full footprint/pin/support-circuit contracts, then generate variants from a shared routed base. Importing an existing molecule and designing a new one are distinct workflows.++A wiki model should retain the detailed board textures and actual component geometry. STEP-to-GLB alone does not recreate baked silkscreen. A detailed EDA GLB can be used only after verifying the molecule coordinate frame and every MP/MC against the footprint contract; use **adom-molecule-visual-review** for that path. Do not silently substitute a simplified model during import/optimization.++Wiki display title and board revision are separate: e.g. `Molecule 74LVC1G00GW,125` on the page, `74LVC1G00GW,125 v1.0` on silk. Keep package versions independent. Publishing a molecule and linking its page to the represented IC are separate operations.++ Create and manage Adom molecules from KiCad, Fusion 360, and EasyEDA design files. Wraps the Hydrogen molecule import pipeline — file upload, Blender 3D optimization, listing, and deletion.⋯ 226 unchanged lines ⋯ ### Optimization queued but molecule doesn't update The Blender optimization pipeline runs asynchronously. Check the molecule page at `https://hydrogen.adom.inc/{owner}/molecules/{name}` after a few minutes.+

Comments

Ray · 1mo ago

Published the shared workflow skills as Logic Molecule Workflows v0.1.0. Verified the registry download against the reviewed skill sources. Install with adom-wiki pkg install adom/logic-molecule-workflows; both Claude and Codex are supported. This PR remains for owner review of the existing skill updates.