Specification · section 11
Authoring descriptors
Two paths, same output, a device package (§4):
- By hand. Copy the package template, fill in the frontmatter and limits, write the operating procedure in DEVICE.md.
- By interview. The agent asks the owner a short set of questions and writes the package: What is it and when should an agent pick it? Where does it sit? What is heavy, hot, sharp or fragile about it? How do you run it, step by step? What must be true before it runs? What values would you never set? What should always need a human? The first answer becomes
description, the procedure becomes the DEVICE.md body, and the rest becomenotes,interlocks,limitsandapprovallevels in descriptor.yaml. Existing SOPs and manual excerpts go underreferences/. The owner reviews the package before it is served.
Packages are versioned folders checked into the lab's repository. Changing a limit is a code review, not a runtime action.