Briefing

Process Notes Summary

Source: docs/briefings/process-summary.md · Back to index · Beta hub

Process Notes Summary

Living documents captured in /process — read these for context on how ideas evolved.

Sources

  • process/claude_thread.md — AI partner chats about “make it cool” architecture & magic moments.
  • process/grk.md — Core principles (session-as-container, grid composer, universal blocks, progressive disclosure).
  • process/Lisdat.md — Unified schema blueprint + terminology (Space/Group/Section/Session/CalendarEvent).
  • process/pre3.md — Session model proposal with phased enhancements.
  • process/pre3a.md — Deep dive into Collection vs Session vs Agenda vs Calendar confusion.

Highlights

claude_thread.md — Magic + AI framing

  • Start from the “wow moment” for each persona (mom’s voice button, agency drag/drop, learning community timeline).
  • AI-first architecture: every node can store AI-extracted summaries, links, action items; autopilot recipes come later.
  • Reinforces Assistant → Copilot → Autopilot ladder.

grk.md — Core principles

  • Sessions are universal work containers with focus modes (deep-work, exploration, collaboration, tidy-up).
  • Grid composer = structured canvas that mixes signals, workflows, AI cells. Keep it visual like Figma but executable.
  • Universal blocks with slash commands; blocks can reference other nodes (@, [[ ]]).
  • Node/edge model keeps relationships flexible; props remain JSON for future facets.

Lisdat.md — Schema blueprint & terminology

  • Final terms: Space ▸ Group ▸ Section ▸ Session. Section = data container with optional timeline/show_on_calendar; Session = action moment linked to Section; CalendarEvent handles the “when”.
  • Assignments live in Sections with Submissions; Signals record assigned_in_section_id + created_in_session_id.
  • Facet dictionary enumerates structural, temporal, compositional, informational, social, assessment, linking facets.
  • UI rules: Sidebar lists Spaces→Groups→Sections; Section page shows materials/discussions/sessions/assignments; Session page shows live notes, participants, session-created signals.

pre3.md — Session model strategy

  • MVP Session = minimal typed node with props bag. Start shipping without schema churn.
  • Phase 1 adds session_kind, purpose, artifacts, outcomes into props.
  • Allows incremental feature flags without breaking legacy data.

pre3a.md — Untangling collections vs sessions

  • Collection = syllabus bucket; Session = time-bound event; Agenda = ordered list inside Session; Calendar = only the views.
  • Everything can be “collected,” but we still keep distinct nouns (Assignment, Resource, Signal).
  • Reinforces mental model: data (Section) vs action (Session) vs when (CalendarEvent).

How to Use

  • Product/design: Reference these stories when writing copy or prioritizing features.
  • Engineering: Use session model guidance when adding session_kind, session memory, or event tracking.
  • Docs/PM: Link to this summary from Hub/Explainer when someone asks “Why grid composer?” or “What’s a Section vs Session?”