create_unit
Create a unit at path from the brain's template for type. type is free (studente, paziente, classe, cliente, progetto…): the template is _templates/<type>/ in the brain; if missing it is seeded the first time from the preset of that name (cliente, progetto) or, for any other type, from the generic template (_about.md with frontmatter status/context, _ai.md, decisions.md; placeholder {{name}}) — then shape _templates/<type>/ with the user so the next units of that type are born complete (see start_project). These names and keys are English in every brain, Italian ones included. On an existing folder it only adds the missing files (never overwrites) — use it to mark an imported folder as a unit. Then start_session and fill the sections following the for the AI comments in each section. In a Cobrain brain where you can write only a branch (shared with you by its owner) and not the root, the unit is still created from the default template.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| type | Yes | ||
| fields | No | ||
| workspace | No | Brain to act on: its id, «mio» (yours), or the owner's name/email as shown by search. Usually OMIT it: a path that already lives in one brain is found there, for reads and writes alike. Pass it only when the tool tells you to (a NEW branch, or one that exists in several brains) — with the brain the user named; when they were not explicit ASK THEM. A brain where the branch does not exist is refused even if you name it. |