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
propsbag. Start shipping without schema churn. - Phase 1 adds
session_kind, purpose, artifacts, outcomes intoprops. - 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?”