skill
molecule-pipeline
Public Made by Adomby adom
Top-level router for moving molecules between EDA tools, the wiki, and Hydrogen: one entry point that routes publish/import intents to the right skill chain and enforces the pipeline invariants.
← Commit history
README.md+61−13@@ -1,21 +1,69 @@-# molecule-pipeline-# molecule-pipeline — the coordination layer+# molecule-pipeline — move molecules through the Adom ecosystem -One mental model for the whole trip. Humans say what they want; this skill-picks the chain and the downstream skills fill in the constraint knowledge-(preflight gates, OCCT molecule-mode routing, stats verification, packaging).+**This is the page.** If you want a board you designed to live in the Adom+ecosystem — on the wiki, importable into any Hydrogen account, wireable in the+3D editor — everything starts here. Share this page; nothing else is required+reading.++## Say one sentence, get the whole pipeline++Your agent handles every step below from a single prompt:++> **"Move molecule ABC from KiCad on my computer up to the wiki."**+> **"Get molecule ABC into my Hydrogen account."**+> **"Publish my molecule ABC and import it into my Hydrogen account."**++Works the same for Fusion 360 and Altium sources — name your tool or let the+agent detect it from your files.++## What happens under the hood ``` KiCad ──kicad-export-molecule──┐ Fusion ─fusion-export-molecule─┼→ molecule-publish → WIKI → adom-molecule-import → HYDROGEN- Altium ─altium-export-molecule─┘ (convert+package+publish) (authenticated fetch + register)+ Altium ─altium-export-molecule─┘ convert · package authenticated fetch+ · publish · verify · register · verify ``` -## Routing table+| Stage | Skill / tool | What it guarantees |+|---|---|---|+| 1. Export | `kicad-export-molecule` / `fusion-export-molecule` / `altium-export-molecule` | STEP exported **on your machine** (so your 3D models bake in) + schematic + board + silk, pulled via adom-desktop |+| 2. Convert + publish | `molecule-publish` → OCCT service (`adom-step2glb`) | Anchored GLB (Z-up, front-left pin at origin), gold machine pins, silkscreen, footprint + symbol JSON with real wire-attach heights — gated on conversion stats, never published degraded |+| 3. Import | `adom-molecule-import` (ships with `adom-molecule`) | Reuses the published GLB (no re-optimization), registers under YOUR owner, collision-guarded |++## Setup (once per container)++```bash+adom-wiki pkg install adom/molecule-pipeline+```++Dependencies install automatically: `molecule-publish` and `adom-molecule`+(+ its import skill). Add your EDA's export skill for stage 1:+`adom-wiki pkg install adom/kicad-export-molecule` (or `fusion-…` / `altium-…`)+— those pull `adom-desktop` for the laptop bridge.++On your laptop: Adom Desktop running, your EDA installed, and for molecules+your board needs the Adom machine-pin furniture (MP1–MP4 markers + corner+machine pins — see `kicad-to-molecule` to add them to a plain board).++## What your board must have (the bare-minimum bundle)++Every molecule page on the wiki carries: **STEP + schematic + board/layout ++metadata** (footprint/symbol JSON, generated for you). The pipeline enforces+this — no partial molecules, no ambiguity about what "published" means.++## The invariants (why results are consistent)++1. The bare-minimum bundle always reaches the wiki.+2. The **only** GLB is the OCCT-converted one — never an EDA's native export.+3. STEP is exported on the design machine so custom 3D models survive.+4. Every stage verifies before the next starts; a failed gate stops the run.+5. Import reuses the published model — nothing is regenerated.++## Related pages -| User intent | Route |-|---|---|-| "publish/export this molecule" + source is **KiCad** | `kicad-export-molecule` → hands off to `molecule-publish` |-| ... source is **Fusion 360** | `fusion-export-molecule` → `molecule-publish` |-| ... source is **Altium** | `altium-export-molecule` (direct-path redesign in progress — owner Barrett) |-| "I already have the files" (STEP + schematic + board) | straight to `molecule-publish` |+- [`kicad-export-molecule`](https://wiki.adom.inc/adom/kicad-export-molecule) · [`fusion-export-molecule`](https://wiki.adom.inc/adom/fusion-export-molecule) · [`altium-export-molecule`](https://wiki.adom.inc/adom/altium-export-molecule)+- [`molecule-publish`](https://wiki.adom.inc/adom/molecule-publish) — the convert/package/publish middle+- [`adom-molecule`](https://wiki.adom.inc/adom/adom-molecule) — the CLI + import skill+- [`adom-step2glb`](https://wiki.adom.inc/adom/adom-step2glb) — the OCCT conversion service/CLI+- [`kicad-to-molecule`](https://wiki.adom.inc/adom/kicad-to-molecule) — make a plain PCB molecule-ready first
package.json+21−9@@ -1,6 +1,6 @@ { "slug": "molecule-pipeline",- "version": "1.0.0",+ "version": "1.0.1", "type": "skill", "description": "Top-level router for moving molecules between EDA tools, the wiki, and Hydrogen: one entry point that routes publish/import intents to the right skill chain and enforces the pipeline invariants.", "tags": [@@ -24,22 +24,34 @@ "screenshot": "docs/shot.png" }, "discovery_triggers": [+ "move molecule from EDA to the wiki",+ "move molecule from my computer to the wiki",+ "move molecule from wiki to my hydrogen account",+ "get molecule into my hydrogen account",+ "move a molecule into our system",+ "get my board into the adom ecosystem",+ "upload my board to the wiki", "publish my molecule",+ "import that molecule to hydrogen", "ship this board as a molecule",- "get molecule into hydrogen",- "move a molecule", "molecule pipeline",- "import that molecule to hydrogen"+ "work with my board in adom",+ "kicad fusion altium molecule",+ "move molecules" ],- "discovery_pitch": "Top-level router for moving molecules between EDA tools, the wiki, and Hydrogen: one entry point that routes publish/import intents to the right skill chain and enforces the pipeline invariants.",+ "discovery_pitch": "THE single entry point for moving molecules through the Adom ecosystem: EDA (KiCad/Fusion/Altium) to the wiki, and wiki to a Hydrogen account. One page, the whole process, every dependency - drop-dead-simple prompts in, consistent verified results out.", "sample_prompts": [ {- "label": "Full trip",- "prompt": "Publish my KiCad molecule ABC and import it into my Hydrogen account"+ "label": "EDA to wiki",+ "prompt": "Move molecule ABC from KiCad on my computer up to the wiki"+ },+ {+ "label": "Wiki to Hydrogen",+ "prompt": "Get molecule ABC into my Hydrogen account" }, {- "label": "Import only",- "prompt": "Go get the piprobe molecule from the wiki and import it to Hydrogen"+ "label": "Full trip",+ "prompt": "Publish my molecule ABC and import it into my Hydrogen account" } ] }
page.json+21−9@@ -1,6 +1,6 @@ { "slug": "molecule-pipeline",- "version": "1.0.0",+ "version": "1.0.1", "type": "skill", "description": "Top-level router for moving molecules between EDA tools, the wiki, and Hydrogen: one entry point that routes publish/import intents to the right skill chain and enforces the pipeline invariants.", "tags": [@@ -25,22 +25,34 @@ "screenshot": "docs/shot.png" }, "discovery_triggers": [+ "move molecule from EDA to the wiki",+ "move molecule from my computer to the wiki",+ "move molecule from wiki to my hydrogen account",+ "get molecule into my hydrogen account",+ "move a molecule into our system",+ "get my board into the adom ecosystem",+ "upload my board to the wiki", "publish my molecule",+ "import that molecule to hydrogen", "ship this board as a molecule",- "get molecule into hydrogen",- "move a molecule", "molecule pipeline",- "import that molecule to hydrogen"+ "work with my board in adom",+ "kicad fusion altium molecule",+ "move molecules" ],- "discovery_pitch": "Top-level router for moving molecules between EDA tools, the wiki, and Hydrogen: one entry point that routes publish/import intents to the right skill chain and enforces the pipeline invariants.",+ "discovery_pitch": "THE single entry point for moving molecules through the Adom ecosystem: EDA (KiCad/Fusion/Altium) to the wiki, and wiki to a Hydrogen account. One page, the whole process, every dependency - drop-dead-simple prompts in, consistent verified results out.", "sample_prompts": [ {- "label": "Full trip",- "prompt": "Publish my KiCad molecule ABC and import it into my Hydrogen account"+ "label": "EDA to wiki",+ "prompt": "Move molecule ABC from KiCad on my computer up to the wiki"+ },+ {+ "label": "Wiki to Hydrogen",+ "prompt": "Get molecule ABC into my Hydrogen account" }, {- "label": "Import only",- "prompt": "Go get the piprobe molecule from the wiki and import it to Hydrogen"+ "label": "Full trip",+ "prompt": "Publish my molecule ABC and import it into my Hydrogen account" } ], "org": "adom",