Note
Capture a half-baked thought for the active actor. Private notes are local draft
state, not canonical organizational truth, and are never committed, indexed,
published, shared, or notified automatically.
When to invoke
Use when the user says 'jot this down', 'note to self', 'just thinking out loud', or 'park this thought' — saves an actor-owned private draft locally and promotes it to organizational knowledge only on an explicit request.
Commands
- No arguments: ask what to capture.
- Content: infer a short title and one of
thought, session,
retrospective, or journal; write the user's meaning without polishing it
into a decision.
list: call bash bin/knowledge.sh note-list and format the returned notes.
share <title> or promote <title>: select the actor's note, preview it,
choose decision, finding, or pattern, and explicitly confirm promotion.
Capture
Render only the note body to a temporary file under tmp/, then call with {note-file}
for that file, {title} for the title inferred from the user's words, and {note-type}
for the inferred thought, session, retrospective, or journal type:
bash bin/knowledge.sh note-create \
--title '{title}' \
--type '{note-type}' \
--input '{note-file}'
The Runtime adapter resolves ActorContext and authorizes the actor before local
private persistence. The resulting envelope carries stable actor identity and
a private policy hint. The hint describes posture; authorization remains the
Runtime policy decision.
Promotion
Open the selected note through bash bin/knowledge.sh note-open "{path}".
After the user explicitly approves organizational promotion, call:
bash bin/knowledge.sh note-promote \
--path "{path}" \
--type "{decision|finding|pattern}" \
--title "{title}" \
--topic "{topic}" \
--workstream "{workstream}"
Promotion uses CanonicalArtifactWriteback: authorize, assign stable typed
identity and source provenance, persist Markdown, record Git provenance, update
retrieval, start background embedding, then emit content-free telemetry. The
private copy remains and records the canonical target.
Boundaries
- Do not access another actor's note or treat policy hints as authorization.
- Do not call Git, QMD, graph, telemetry, publishing, sharing, notification, or
control-plane mechanics directly.
share means promotion into authorized organizational Markdown, not external
publication. External sharing and notification require separate permission
and exact consent.
Confirm private capture with its local path. Confirm promotion with the new
canonical path and writeback status.