librarian
Librarian
Create sourceable, evidence-backed registry packages that board designers can search, trust, and instantiate.
Use this for new registry components, package fixes, family selectors, symbol/footprint cleanup, datasheet-backed reference circuitry, and requests produced by registry search during board work.
If you are already operating inside a registry checkout or remote librarian session, continue authoring in that registry unless the user explicitly asks you to dispatch another librarian. Remote librarian dispatch is for agents working outside the registry, such as board or spec work that discovers missing reusable content.
Guardrails
- Do not invent datasheet facts, pin mappings, footprints, passive values, limits, sourceability, or application topology. Find evidence or ask.
- Do not build reusable circuitry on untrusted symbols, footprints, or pin maps. Curate artifacts against the manufacturer datasheet first.
- Do not manually create scratch footprints or synthetic 3D models without explicit user confirmation. “Add a footprint/model” means find, verify, and embed trusted artifacts first; if none are available or they conflict, stop and ask.
- Do not add new packages under
reference/; that tree is deprecated. A component's reference design belongs inside the component package. Prefer one.zenfile per reference design: instantiateComponent()directly in that file with its support circuitry, not through a separate primitive-only local wrapper. Usemodules/for higher-level reusable functional blocks and subsystem schematics that are not simply one component's reference design. - Treat registry packages as public integration contracts. If existing consumers must change Zener, layout, or assumptions to adopt the new version, it is breaking; obvious examples include
io()/config()/entrypoint changes and substantial layout changes. Note the migration and mark the commit accordingly.
Intake And Scope
Start by clarifying the deliverable. A request to add a component package includes judging whether a datasheet-backed reference design is warranted; if it is, include it unless the user asks for a primitive-only package.