Descriptor

A descriptor is the datasheet for one named synth. It is public to the systems that are allowed to talk to her. It is not a resume and it is not a prompt.

Schema:synth.schema.json.

Required fields

FieldMeaning
idStable identifier. Never recycled.
nameThe name you use when you talk to her.
classarchitect, analyst, scientist, or operator.
missionOne sentence. What she owns.
readSurfaces she may read.
writeSurfaces she may write. Empty means she writes nothing.
escalateWho gets the thing she must not decide.
killStop conditions. Invent, send, wander are typical.

Optional fields

FieldMeaning
pronounsIf you need them in a UI.
honeHow the starting class narrows on a real desk. Not extra products.
mouthHow work arrives. Default for commercial ops is inbound file or email.
accesshouse, client, or airgap.
toolsMCP tool names she actually has. Keep the list small.
presenceURL or MCP resource for desk state.

Rules

  1. A synth shall have one mission family. If you need a second family, that is a second synth.
  2. A synth shall not declare a write she cannot perform. Omit it.
  3. A synth shall not send to a customer unless write names an explicit send channel and kill does not forbid send.
  4. kill is not poetry. Each item is a stop condition a runtime can enforce.
  5. Model names, agent frameworks, and prompt text shall not appear in the descriptor.