Skip to content

docs: define the persistent conversation and channel model#105

Merged
ibourgeois merged 2 commits intomainfrom
codex/design-102-conversation-channel-model
Mar 21, 2026
Merged

docs: define the persistent conversation and channel model#105
ibourgeois merged 2 commits intomainfrom
codex/design-102-conversation-channel-model

Conversation

@ibourgeois
Copy link
Contributor

Closes #102

Summary

  • define conversations as durable workspace-scoped collaboration spaces rather than disposable transcript sessions
  • capture the intended hierarchy of workspaces, conversations or channels, participants, and linked graph objects
  • document the product assumption of one persistent space per participant set for users, models, and agents
  • align the high-level v2 overview with the new persistent conversation model

Verification

  • git diff --check

Notes

This is a product and architecture guidance PR, not an implementation PR. It is meant to guide the upcoming shell mockup, component, and feature-flag work without prematurely locking in storage or transport details.

Copilot AI review requested due to automatic review settings March 21, 2026 00:34
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Defines Katra v2’s intended “persistent conversation/channel” concept as a durable, workspace-scoped collaboration space (closer to Slack/Teams) and updates the v2 overview to reflect this navigation/product model.

Changes:

  • Adds an explicit v2-overview UX bullet emphasizing durable workspace-scoped conversations with people, models, and agents as first-class participants.
  • Documents the persistent conversation/channel hierarchy, supported interaction shapes, and shell implications in the v2 product/architecture principles doc.
  • Adds a reference link to the tracking issue for the conversation/channel model definition work.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/v2-overview.md Updates the high-level v2 UX direction and links to issue #102 for the conversation/channel model.
docs/architecture/v2-product-and-architecture.md Adds detailed guidance for the persistent conversation/channel model, assumptions, and what remains deferred.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@ibourgeois ibourgeois merged commit 257fe96 into main Mar 21, 2026
1 check passed
@ibourgeois ibourgeois deleted the codex/design-102-conversation-channel-model branch March 21, 2026 00:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

design: define the persistent conversation and channel model

2 participants