Converted from
aiConnected OS - 3. Live document feature.md.Live document feature
User: Oxford PierpontCreated: 12/10/2025 6:30:41
Updated: 12/10/2025 6:47:50
Exported: 2/11/2026 7:07:16
Link: https://chatgpt.com/g/g-p-69395d9991108191841f1dac1fd8d1a1-oxpi-aiconnected-ui-features/c/693959e0-f8fc-8326-8650-bb6e718d9239
Prompt:
I’d like to create another feature for instances called live documents. So a live document is basically if I have, let’s say I’m putting together an idea for a particular feature, and along the way I’m pinning various things, but I don’t want to push those things to the whiteboard, and I want something that’s more linear, like a live document. So what I can basically do is I can take any message and I can add it to the live document, I can take several messages, and I can always open the current live document, kind of like in a canvas or an artifact or something, within any individual chat. And what this allows me to do is basically take the content that I’m currently creating within individual chats and edit it, but I can edit the same document across multiple chats. That’s the difference here, because what that ends up giving me is a more comprehensive, let’s say a PRD, a very complicated document. Well, I can have one conversation about feature A, another conversation about feature B, and another conversation about feature C, and I can open each of those individual chats, I can open the live document in each of those individual chats, and I can update that same document, but with these different features, right? Or I can just go straight to the instance dashboard and just open the document itself, and I can even talk to the document and I can say like, hey, can you edit this part? Can you add this part? Can you do whatever? And it’s going to essentially work the document. And then when it’s all finished, I can export it to either another program, like let’s say Google Docs, or I can download it as a PDF, I can add images to it, so maybe I want to add a header, I want to add my logo, I want to do any number of things, I can add a table, right? So this live document essentially allows me to not just organize my ideas, but also formalize them into a format that is going to be something I can send to other people or have as official documentation. And document doesn’t necessarily just have to mean like Word document, right? It could also mean presentation style document. So that’s what live documents means to me.Response:
Live documents in your instance ecosystem are basically shared, always-on, cross-chat artifacts that sit inside an instance and grow over time as you talk. Let me lay this out as if we’re speccing the feature for dev.1. What a “Live Document” is in this system
Definition (behavioral, not just UI): A Live Document is a persistent document object that belongs to an instance, not to a single chat. Any chat under that instance can:- Open the same document
- Append or edit content
- Pull in messages or summaries from that chat
- Ask the AI to edit or restructure the document
- Linear (like a PRD, spec, or written plan)
- Editable across multiple chats
- Exportable (Google Docs, PDF, maybe Slides)
- AI-aware (you can “talk to” the doc: “add this feature,” “rewrite that section,” etc.)
- Pins → quick references to messages
- Whiteboard → nonlinear, spatial, brainstorm canvas
- Tasks → action items
- Folders → organizational structure of chats/instances
2. Core principles & constraints
To keep this useful and sane:- Instance-scoped, chat-agnostic
- Every live document is tied to an instance.
- Any chat in the instance can open/edit the same doc.
- Message → Document, not Document → Message
- You don’t edit messages by changing the doc.
- You pull from messages into the doc, and then the doc becomes its own, editable artifact.
- AI-editable, but human-readable
- Under the hood, store it as structured markdown (or a block model).
- The UI shows a clean editor.
- The AI gets the structured version so it can target specific sections.
- Versioned, not fragile
- Every AI or human edit updates the doc version.
- You can revert or at least see history.
- Supports multiple “output types”
- Default: document mode (PRD, spec, brief).
- Secondary: presentation mode (slide outline based on headings).
- Same underlying object, different export views.
3. Data model (conceptual)
At a high level:3.1 LiveDocument
idinstance_idtitle– e.g., “Cognigraph PRD v1”type–text_document,presentation_outline, etc.status–draft,in_progress,review,finalcreated_by_user_idcreated_at,updated_at
3.2 LiveDocumentContent
Two ways you could implement, depending on how ambitious you want to be. Option A — Simple (MVP):document_idcontent_markdown– full markdown blobversion_numberupdated_byupdated_at
blocks[]:idtype–paragraph,heading,list,quote,code,image,tablecontent– markdown/structured textorigin–{conversation_id, message_id}(optional)order_index
3.3 DocumentMessageLink (traceability)
Even if you copy text into the doc, you’ll want to remember where it came from:document_idblock_id(or text span if doing ranges)conversation_idmessage_id
- Jump back from the doc to the original chat message.
- Later add things like “show me all doc contributions from this chat.”
4. Interaction inside a chat
Imagine you’re inside a chat under an instance.4.1 Opening the Live Document
From the chat UI:- A “Live Docs” icon or button in the right sidebar/top bar.
- Clicking it opens:
- A list of live docs for this instance, or
- Directly the “primary” document if you’ve pinned one as default for the instance.
- Opens in a side panel or full-page, with a toggle:
- Chat view on the left
- Live Document editor on the right (like an artifact/canvas)
4.2 Adding messages to the Live Document
On any message (user or AI), context menu has:- “Add to Live Document…”
- Choose:
- Which live doc (if multiple)
- How to add:
Append to bottomNew section titled: [auto-detected or user-entered]Summarize this message and addExtract bullet points and add
- Choose:
- Pulls the text (or a summary) into the doc.
- Creates a new block (or updates
content_markdown). - Creates a
DocumentMessageLinkwithconversation_id+message_id.
4.3 Editing the document while chatting
You have two parallel streams:- You typing directly in the editor
- Regular rich-text / markdown editing: headings, bullets, bold, links, etc.
- You asking the AI to manipulate the doc
- Example commands in the chat:
- “Update the Live Document: add a section called ‘Live Document – Editing Across Chats’ that summarizes what we just discussed.”
- “Rewrite the introduction to emphasize that live docs are cross-chat artifacts.”
- “Create a table in the doc comparing Whiteboard vs Live Document vs Tasks.”
- Example commands in the chat:
- Automatically has the current doc (or relevant sections) in context.
- Interprets “the document” as the currently open live doc.
- You either:
- Send the doc (or a slice) plus the instruction to the LLM.
- Let the LLM produce a patch or new content.
- Then update
content_markdownor specific blocks. - Save a new version.
5. Instance dashboard & document hub
From the Instance Dashboard, add a new tab:5.1 “Documents” tab for the instance
This shows:- A table/grid of all live docs:
- Title
- Type (PRD, Spec, Meeting Notes, Presentation Outline, etc.)
- Status
- Last edited (time + by whom)
- Linked chats count
- New Live Document
- Open
- Duplicate
- Archive
5.2 Opening from the dashboard
When you open a live doc here:- You get a full-page editor:
- Larger workspace than the in-chat panel
- Document outline sidebar (headings)
- Export options
- “Linked Conversations” section, listing chats that contributed to this doc
5.3 Talking directly to the document from the dashboard
You can also have a “Document Chat” mode here:- Small chat panel anchored to this document, where prompts are implicitly about “this doc.”
- “Tighten up the wording in section 3.2.”
- “Add an executive summary at the top.”
- “Generate slide titles from each H2 and add a ‘Presentation Outline’ section at the bottom.”
6. Export and formatting
You explicitly mentioned:“When it’s all finished, I can export it to either another program, like Google Docs, or I can download it as a PDF, I can add images to it, header, logo, tables…”So:
6.1 Export targets
- Google Docs
- Use the Docs API to:
- Create a new doc
- Push the structured content (headings, lists, tables)
- Optionally store the Google Doc URL back on the document.
- Use the Docs API to:
- PDF
- Render the markdown/blocks to HTML and then to PDF (server-side rendering).
- Presentation format (optional)
(PowerPoint / Google Slides)- Map each H1 or H2 heading → slide.
- Use the first paragraph/bullets under each heading as slide body.
- AI can propose slide notes or speaker notes.
6.2 Layout & branding
In the document settings:- Branding options:
- Header logo
- Company name
- Footer text (e.g., “Confidential – Oxford Pierpont / aiConnected”)
- Style presets:
- “Simple PRD”
- “Formal Spec”
- “Presentation Outline”
6.3 Rich content
Inside the editor, allow:- Tables
- Images
- Embed from upload or from generated diagrams (later).
- Code blocks
- Callout boxes (Notes, Risks, Decisions)
7. Relationship to other features
7.1 vs Whiteboard
- Whiteboard:
- Nonlinear
- Spatial layout of ideas
- Great for brainstorming, clustering, concept mapping
- Live Document:
- Linear narrative
- Organized spec, plan, or write-up
- Ready to send to others as “official” docs
- From whiteboard → “Generate Document from selected items.”
- From document → “Send this section to whiteboard as sticky notes.”
7.2 vs Tasks
- Tasks:
- “Do X later”
- Have due dates, statuses, etc.
- Live Document:
- The narrative and structure of what X is.
- Highlight text in doc → “Create task”
- Task stores a reference to
{document_id, block_id}.
- Task stores a reference to
7.3 Conversation referencing & linking
- When a chat heavily contributes to a live doc, you can:
- Show in the chat: “This conversation is linked to Documents: [Cognigraph PRD]”
- Show in the doc: “Linked Chats: [Cognigraph – Specializations chat], [Live Docs Feature Design chat]”
- Jump back and forth between conceptual discussion and “final” documentation.
8. Collaboration & multi-edit handling (even if it’s just you for now)
Even if it’s single-user at first, it’s worth thinking like it’s multi-user:- Locking (optional for MVP):
- Soft-lock: “Bob is editing this document” banner.
- Auto-save:
- Save every N seconds or on change.
- Version history:
- “Show previous versions”
- “Restore version”
9. MVP scope vs extended vision
MVP
- Per-instance Live Documents table.
- Basic text/markdown editor.
- In-chat:
- Open Live Document panel.
- “Add to Live Document…” on messages (append + optional summarize).
- AI:
- When Live Doc is open, allow “Update the live document…” commands that:
- Append new sections
- Rewrite specific sections by name.
- When Live Doc is open, allow “Update the live document…” commands that:
- Export:
- Markdown download
- PDF export
- Simple version history.
Extended
- Block-based model with precise AI edits.
- Slide/presentation export.
- Google Docs/Slides sync.
- Whiteboard ↔ Live Document bridges.
- Task creation from highlighted document content.
- Fine-grained permissions and multi-user editing.
If you’d like, next step I can turn this into an actual PRD section for “Live Documents” that matches the structure we’ve been using for Cognigraph / aiConnected—requirements, APIs, events, and UI wireframe notes—so you can drop it directly into your instance spec.
Powered by ChatGPT Exporter