v0.2

2026-06-07 22:41:19 -05:00
parent 392ae7bbe3
commit 8bf9871dbe
10 changed files with 1055 additions and 0 deletions
@@ -0,0 +1,110 @@
+# 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 may exist; do not rename them, 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-07-1430-goldbrain-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
+
+```markdown
+---
+type: session-log
+status: complete
+created: 2026-06-07T14:30
+updated: 2026-06-07T14:30
+tags: [agent, session]
+agent_written: true
+source_notes: []
+session_date: 2026-06-07
+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
+
+```markdown
+---
+type: session-log
+status: complete
+created: 2026-06-07T14:30
+updated: 2026-06-07T14:30
+tags: [agent, session, plugin]
+agent_written: true
+source_notes: ["resources/references/obsidian-local-rest-api.md"]
+session_date: 2026-06-07
+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 (no `Projects/agents/` prefix) — 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]]`.