Session Workflow

Best practices during capture:

• Use tags consistently (domain/scope format)
• Write wikilinks to connect new content to existing knowledge
• Set topic to match the session focus for better reweave scoring
• Check for existing content before creating duplicates (use search first)

3. Synthesize (before closing)

Review what was captured and create synthesis:

• Look for patterns across captured notes
• Create summary notes connecting related captures
• Run reweave to discover connections you missed
• Use graph tools (themes, gaps) to understand how new content fits

4. Close (session_close MCP tool)

Close the session with a summary. The close triggers an enrichment pipeline:

1. Cross-session reweave — reweaves all notes/references created in this session
2. Orphan sweep — finds notes with 0 outgoing links and attempts to connect them
3. Integrity check — scans for broken links, orphan edges, missing files
4. Graph materialization — persists PageRank, betweenness, cluster IDs

Always provide a summary when closing — it becomes part of the session record.

Pre-Close Checklist

Before closing a session, verify:

1. Knowledge extraction — Were insights captured as notes?
2. Resource capture — Were external sources saved as references?
3. Decision recording — Were choices documented (decision subtype)?
4. Task tracking — Were follow-ups captured as tasks?
5. Connections made — Were new items linked to existing knowledge?

See references/session-checklist.md for the full checklist. See references/enrichment.md for details on the enrichment pipeline.