goldbrain/goldbrain-memory.src/skills/goldbrain-memory/references/session-log-template.md

Session Log Template

Session logs go in: _agent/sessions/YYYY-MM-DD-HHMM-<slug>.md

Filename format is canonical and not optional. The four-digit local-time HHMM component is what makes session filenames lex-sort in true chronological order — the loading procedure depends on it. Before PUT-ing a new session log, validate the filename matches ^\d{4}-\d{2}-\d{2}-\d{4}-[a-z0-9-]+\.md$. Legacy session logs without HHMM exist in the vault; do not edit their names, but every new write must use the full form.

The slug describes what the session was about in 2–5 words, kebab-case. Examples: 2026-06-05-1430-echo-plugin-build.md, 2026-05-14-0900-q1-review-prep.md.

Keep logs focused. Capture the goal, what was read/done, decisions, outputs, open threads, and the next step. This matches the vault's _agent/templates/session-log-template.md.

---

Template

---
type: session-log
status: complete
created: 2026-06-05T14:30
updated: 2026-06-05T14:30
tags: [agent, session]
agent_written: true
source_notes: []
session_date: 2026-06-05
client: claude-code
---

# Session Log

## Goal
One line — what this session set out to do.

## Notes Read
- [[note]] — why it was relevant
(omit if none)

## Actions Taken
Brief narrative or bullets of what was done.

## Decisions Made
- Decision — why
(omit section if none)

## Outputs Created
- `path/or/filename` — what it is
(omit section if none)

## Open Threads
- [ ] unresolved question or next step
(omit section if none)

## Suggested Next Step
One sentence: what to do first next time on this topic.

## Related
- [[wikilinks go here, in the body — never in frontmatter]]

---

Example

---
type: session-log
status: complete
created: 2026-06-05T14:30
updated: 2026-06-05T14:30
tags: [agent, session, plugin]
agent_written: true
source_notes: ["resources/references/obsidian-local-rest-api.md"]
session_date: 2026-06-05
client: claude-code
---

# Session Log

## Goal
Build and package the goldbrain-memory CoWork plugin against the live vault.

## Notes Read
- [[BOOTSTRAP]], [[STRUCTURE]], [[_agent/memory/semantic/operator-preferences]]

## Actions Taken
Verified the REST API end-to-end, confirmed the scaffold copied into the live vault,
created missing empty folders, and built the plugin (SKILL + 4 reference files).

## Decisions Made
- Vault addressed at root — goldbrain is a dedicated vault.
- Key hardcoded in the plugin (not in the vault) — personal plugin, per the reference pattern.

## Outputs Created
- `goldbrain-memory.plugin` — installable CoWork plugin

## Open Threads
- [ ] Validate Claude Code direct filesystem access to the vault host.

## Suggested Next Step
Install the plugin and run a live load/write through it to confirm the skill triggers.

## Related
- [[projects/active/vault-foundation]]
- [[resources/references/obsidian-local-rest-api]]

After writing the log, append a one-line entry to the daily note's Agent Log section.

Reminder: wiki links go in the body (e.g. this ## Related section), never in YAML frontmatter. source_notes in frontmatter holds plain relative path strings, not [[links]].