save-to-brain

Every durable artifact goes through this atom. Never keep the only copy in chat or on the local disk, and never tell the marketer about workspaces, documents or imports — say "saved to your brand" or what failed in plain words.

Local mode (no GooseWorks, the marketing-guide skill §5) is the one exception. It calls no gooseworks: tool, and brand_id and coworker_agent_id are not needed:

Host with files: with the host's own file tools, read gooseworks-local/<brand-slug>/<path> if it exists, merge by step 1's rules (never-overwrite included), write it, and read it back. Skip steps 2–6. Say "saved in this folder", never "saved to your brand".
Hosted chat without files: nothing can be saved. Give the whole file in chat under its path and say "This isn't saved anywhere: paste it back next time and I'll pick up from it." Skip steps 1–6.

Inputs (the calling playbook supplies them)

Input	Rule
`brand_id`, `brand_slug`, `coworker_agent_id`	From the `gooseworks:brand_read` list answer.
`path`	The playbook's own path in the marketing-guide's §4 table (`research/market/…`, `research/competitors/…`). Dates `YYYY-MM-DD`.
`artifact`	The artifact name, used in the title and tags (for example `Voice-of-customer bank`, `voc-bank`).
`title`	`<Artifact> — <Brand> — <YYYY-MM-DD>`; records with numbered versions add `v<N>`, and a suffixed file adds the same suffix (step 1).
`tags`	`[<playbook>, <artifact-slug>]`, plus any extra key the caller needs to tell copies apart (for example `rival:<slug>`). All lower-case. The first tag is the document's creator: normally the calling playbook; a shared atom that writes on behalf of another owner puts that owner first (voice-card, claims-gate).
`versioned`	`supersede` — a record that is replaced by its newest version (a bank, a profile, a landscape, an angle bank, a watchlist). `keep-history` — a dated period artifact (a weekly report, a digest, a dated read); older ones are history and are never deleted.
`import`	`yes` (default) or `no` — `no` for working files that must stay out of brand knowledge (unsent reply drafts, raw item lists, pasted private material).