Skip to content
This repository was archived by the owner on Sep 23, 2025. It is now read-only.

Commit 0cd70b9

Browse files
committed
Organize journal server project structure
- Move design docs from src/journal-server/ to src/journal-mcp-server/ for mdBook - Create implementation directory at journal-mcp-server/ with clean README - Update SUMMARY.md to include design document in mdBook structure - Create GitHub tracking issue #9 for implementation progress - Remove issue template in favor of live tracking issue Clean separation: mdBook for concept docs, journal-mcp-server/ for implementation, GitHub issue for project management. Ready for Phase 1.
1 parent 0f9f565 commit 0cd70b9

File tree

6 files changed

+59
-427
lines changed

6 files changed

+59
-427
lines changed

journal-mcp-server/README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Journal MCP Server
2+
3+
A memory system that emerges from collaborative understanding, reimagining AI memory as an organic, reflective practice rather than mechanical storage.
4+
5+
## Quick Start
6+
7+
*Implementation coming soon - currently in design phase*
8+
9+
## Documentation
10+
11+
For the full concept, design, and architecture details, see the [mdBook documentation](../src/journal-mcp-server/).
12+
13+
## Development Status
14+
15+
Track implementation progress in the [GitHub tracking issue](https://github.com/nikomat/socratic-shell/issues) - look for "Journal MCP Server Implementation".
16+
17+
## Core Concept
18+
19+
The journal server uses git as both storage engine and identifier system:
20+
- **File contents**: Current understanding (overview)
21+
- **Commit messages**: Incremental journey (journal entries)
22+
- **Git history**: Complete collaborative record
23+
24+
This creates a memory system that captures both our current understanding and the collaborative journey that led there, aligning with natural patterns of exploration → synthesis → new exploration.

src/SUMMARY.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,8 @@
2323
- [Design Foundation](./memory-bank/design-foundation.md)
2424
- [Current State](./memory-bank/current-state.md)
2525
- [Frequently asked questions](./memory-bank/faq.md)
26-
- [Journal Server Design](./journal-server/README.md)
27-
- [Design Document](./journal-server/design-doc.md)
28-
- [Implementation Plan](./journal-server/implementation-plan.md)
26+
- [Journal MCP Server](./journal-mcp-server/README.md)
27+
- [Design Document](./journal-mcp-server/design-doc.md)
2928

3029
# Dialectic
3130

src/journal-mcp-server/README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Journal MCP Server
2+
3+
The Journal MCP Server is our fourth memory experimentation approach, reimagining AI memory as an organic, reflective practice rather than mechanical storage.
4+
5+
## Key Concepts
6+
7+
**Hermeneutic Circle**: Captures how understanding deepens through the back-and-forth between parts and whole, between specific discoveries and evolving context.
8+
9+
**Tree Structure**: Organizes around overviews (current synthesis), entries (chronological journey), and subsections that emerge naturally from the work.
10+
11+
**Temporal Salience**: Recent entries are easily accessible, older entries require higher relevance to surface - creating natural rhythms of memory.
12+
13+
**Dual-Dimension Search**: Matches both work context and content to prevent false positives where content matches but context doesn't.
14+
15+
## Implementation
16+
17+
The actual implementation is located at `/journal-mcp-server/` in the repository root, including:
18+
19+
- **README.md** - Core design vision and architecture
20+
- **design-doc.md** - Technical implementation details
21+
- **implementation-plan.md** - Development roadmap and phases
22+
23+
The server uses a git-centric approach where journal sections are markdown files with current understanding as file contents and incremental entries stored as git commit messages.
24+
25+
## Integration with Collaboration Patterns
26+
27+
The journal server aligns with existing patterns:
28+
- `.ongoing` files that track evolving work
29+
- GitHub tracking issues that document understanding as it shifts
30+
- Consolidation moments ("Make it so") when insights crystallize
31+
- The natural rhythm of exploration → synthesis → new exploration
32+
33+
This creates a memory system that serves the deeper practice of collaborative understanding rather than just information management.
File renamed without changes.

src/journal-server/README.md

Lines changed: 0 additions & 136 deletions
This file was deleted.

0 commit comments

Comments
 (0)