Skip to content

Commit fd586a2

Browse files
Complete documentation refactoring: vertical slice architecture
Documentation Distribution: - Move algorithm docs to feature boundaries (ring-layout → liminal-web-layout, constellation → constellation-layout) - Move radicle-architecture.md → social-resonance-filter/docs/ - Move DreamNode-template → dreamnode feature slice - Delete redundant root docs/ files (patterns, specs, architecture details) - Simplify docs/index.md to point to source READMEs README Standardization: - Standardize closing sections to "Notes" across all features - Add Commands tables (dreamnode: 7 commands, dreamnode-editor: 6) - Add Ownership sections to layout and semantic-search features - Remove "Clean ✅" refactoring checkmarks from feature catalog CLAUDE.md Condensation: - Reduce from ~533 to ~188 lines - Keep: Feature overview, GitHub CLI commands, GraphQL queries - Remove: Epic progress details, outdated patterns Root README Updates: - Update Conversational Co-Pilot (remove TBD, reflect implementation) - Update Songlines (mark as Future, clarify foundation exists) - Add GitHub Publishing feature section Deprecations: - Mark creator mode as deprecated in dreamnode/README.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 2db9eca commit fd586a2

46 files changed

Lines changed: 284 additions & 3676 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CLAUDE.md

Lines changed: 114 additions & 458 deletions
Large diffs are not rendered by default.

README.md

Lines changed: 19 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -161,17 +161,21 @@ With ever more powerful, local, multi-modal models on the horizon and deeper int
161161

162162
![](media/AiderIntegration.gif)
163163

164-
### 💬 Conversational Co-Pilot (TBD)
164+
### 💬 Conversational Co-Pilot
165165

166-
Through realtime transcription of free flowing conversations (video call or in-person) combined with the existing semantic search functionality, the system will constantly filter for the most relevant DreamNodes, making them readily available for reference and sharing during the dialogue - all without interrupting the flow! Say goodbye to awkward interruptions due to not finding a reference!
167-
And the best part: referencing a DreamNode (implicitly or explicitly) automatically offers your peer to clone it. Which means sharing an idea and collaborating on it is the same thing in this system.
166+
An AI-powered conversation mode where you can invoke DreamNodes by name during natural dialogue. Type a message, and the copilot responds with context from your knowledge graph. Mention a DreamNode by name (e.g., "tell me about MyIdea") and it gets pulled into the conversation context.
167+
168+
The foundation for a future realtime transcription system that will filter relevant DreamNodes during live conversations - making knowledge readily available without interrupting the flow.
168169

169170
![](media/ConversationalCopilot.gif)
170171

171-
### 🎵 Songlines (TBD)
172+
### 🎵 Songlines (Future)
173+
174+
A vision for the future: every time an idea is shared during a conversation, the relevant audio clip is automatically added to the DreamNode. Each DreamNode remembers the path it travels in a unique set of conversation clips - its Songline.
175+
176+
Songlines would provide an organic, decentralized replacement for static definitions - community-generated data representing knowledge in the most effortless yet high-bandwidth way. With local multi-modal LLMs and infinite context windows, Songlines could become a game changer for leveraging collective wisdom.
172177

173-
Everytime an idea is shared during a conversation, and thus the corresponding DreamNode is cloned, the relevant clip of the conversation is automatically added to the DreamNode as yet another way of expressing the idea. This way every DreamNode remembers the path it travels in a unique set of conversation clips - its Songline!
174-
Not only do Songlines allow for an organic, decentralized and emergent replacement for static textbook definitions, they also constitute an invaluable source of community-generated and -owned data for representing knowledge in the most effortless yet high bandwidth way. In anticipation of local, multi-modal LLMs with effectively infinite context windows these Songlines may turn out to be a game changer in terms of leveraging collective knowledge and wisdom into actionable projects.
178+
*Foundation exists via realtime-transcription feature; full Songline capture is future work.*
175179

176180
![](media/SongLines.gif)
177181

@@ -181,6 +185,12 @@ Easily open any given DreamNode in your favorite git client of your choice.
181185

182186
![](media/GitClientIntegration.gif)
183187

188+
### 🌐 GitHub Publishing
189+
190+
Share your DreamNodes with the world via GitHub Pages. With one action, publish a DreamNode to GitHub - the system creates a repository, generates an interactive viewer bundle, and deploys it to GitHub Pages. Recipients can view the DreamTalk and DreamSong in their browser, and easily clone it into their own InterBrain.
191+
192+
*Complements the peer-to-peer Radicle sharing for cases where you want public, web-accessible sharing.*
193+
184194
### 📊 Organic Content Visualization
185195

186196
The content within a DreamNode is visually accessible on the backside using the beautiful circle packing algorithm of D3. Instantly access files and folders directly from the InterBrain.
@@ -281,10 +291,9 @@ InterBrain addresses the echo chamber problem through a unique **holographic app
281291

282292
Interested in contributing or understanding the technical architecture?
283293

284-
- **Architecture Overview**: See [docs/architecture-details.md](docs/architecture-details.md)
285-
- **Radicle Integration**: See [docs/radicle-architecture.md](docs/radicle-architecture.md)
286-
- **Development Guide**: See [docs/development/](docs/development/)
287-
- **Technical Patterns**: See [docs/technical-patterns.md](docs/technical-patterns.md)
294+
- **AI Development Guide**: See [CLAUDE.md](CLAUDE.md) for AI-first development patterns
295+
- **Core Architecture**: See [src/core/README.md](src/core/README.md) for infrastructure and services
296+
- **Feature Catalog**: See [src/features/README.md](src/features/README.md) for vertical slice architecture
288297
- **Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)
289298

290299
## License

0 commit comments

Comments
 (0)