| name | registry-search |
| description | Use during board work to find and evaluate existing registry modules, reference designs, or component packages before authoring anything new. |
Registry Search
Find prepared registry content before designing a circuit or choosing a new part by hand.
Use this when working on a board, subsystem, or spec and you need a reusable schematic module, reference design, primitive component package, concrete MPN, symbol, footprint, datasheet, or sourcing signal.
Search Modes
registry:modules — reusable Zener packages and .zen entrypoints. This is the primary search mode for schematic reuse.registry:components — registry symbols/parts with MPN, manufacturer, footprint, datasheet, availability, and moduleUrl. Use this for concrete part discovery and to find the package behind a symbol.
Do not create, import, or patch component packages in this workflow. If the registry does not contain a suitable result, or the closest result needs even a small package/API/circuit tweak, produce a librarian request.
Search Workflow
Start with reusable schematic content:
pcb search -m registry:modules <query> -f json
Use functional queries when the board need is functional: "usb c source", "3.3v ldo", "128mb spi flash", "automotive high side switch".
Search symbols/parts when you need a concrete MPN, footprint, availability, or the package behind a primitive:
pcb search -m registry:components <query> -f json
Use MPN/manufacturer queries when the user named a part: TPS70933, Texas Instruments TPSM336, USB4105.
Then inspect the candidate API before instantiating it:
pcb doc --package <module-url>@<version>
If docs are incomplete or fail, use the source path or file tree from pcb doc to inspect the package source instead of guessing the IO/config interface.
Choosing Results
Prefer the most reusable correct abstraction:
- A higher-level module or reference design that already implements the needed schematic circuit.
- A component package with included support circuitry when that is exactly the intended use.
- A primitive component package when the board genuinely needs only the raw part.
Use registry:components results to compare physical package, pinout, MPN, stock, price, datasheet, and moduleUrl. Use registry:modules results to compare entrypoints, dependencies, dependents, and package descriptions.
Ask only when tradeoffs are real: package size, cost, stock, electrical margin, automotive/industrial grade, interface differences, or user-visible feature choices.
Using Results In A Board
Instantiate the .zen entrypoint from the chosen registry:modules result directly in the consuming .zen file.
PartModule = Module("code.diode.computer/diode/registry/components/<Manufacturer>/<NAME>/<NAME>.zen")
Do not manually edit pcb.toml to add the dependency; follow the dependency workflow in zener-language.
Use pcb doc --package and its reported source path for exact IO and configs. Do not infer pin names from search snippets.
After adding the package to a board or module, finish the consuming .zen change according to zener-language.
Librarian Requests
When no suitable registry content exists, or a close match needs to be changed before it is safe to use, stop the registry search workflow. Do not author or patch reusable packages inline.
If you are inside a registry checkout or explicit registry-authoring task, use librarian. Otherwise use librarian-dispatch.
