Skip to content

Commit 54dfef4

Browse files
altrasclaude
andcommitted
docs: add positioning, scenario, and open-infra sections to README
Adds "Why Knowledge Plane?", "How It Works", and "Open Infrastructure" sections for the Mozilla newsletter audience. Updates Contributing sections in both README and CONTRIBUTING.md with specific help areas. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent d009b33 commit 54dfef4

2 files changed

Lines changed: 31 additions & 1 deletion

File tree

CONTRIBUTING.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22

33
Thank you for your interest in contributing to KnowledgePlane! We welcome contributions from everyone, whether it is a bug report, feature request, documentation improvement, or code change.
44

5+
## Areas We Need Help
6+
7+
We're a small team and appreciate contributions in these areas:
8+
9+
- **MCP tools** -- New tools for the MCP server, improved search/retrieval, better tool descriptions
10+
- **Web dashboard** -- UI improvements, new views (graph visualization, timeline), accessibility
11+
- **Documentation** -- Tutorials, integration guides, architecture deep-dives
12+
- **Testing** -- Integration tests, edge case coverage, benchmark improvements
13+
- **Integrations** -- Adapters for other AI tools and platforms beyond Claude Desktop
14+
515
## How to Contribute
616

717
### Development Setup

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,20 @@
1919

2020
Knowledge Plane is an MCP server that gives AI agents and teams persistent, shared memory. It stores facts as a knowledge graph with vector embeddings, automatically consolidates related facts into knowledge cards, and provides hybrid search (vector + graph traversal). Native MCP protocol support means any MCP-compatible AI tool (Claude, Cursor, etc.) can read and write shared knowledge.
2121

22+
## Why Knowledge Plane?
23+
24+
Memory layers for AI exist (Mem0, Zep, Letta), but they're built around flat vector stores -- good for retrieval, less good for understanding how things relate. Knowledge Plane stores facts as a graph with typed relations, so "Alice manages Bob" is a first-class edge you can traverse, not a blob of text you hope cosine similarity resurfaces. Background workers continuously consolidate related facts into knowledge cards, building institutional knowledge instead of just accumulating embeddings. And it's designed for teams from the start: multi-workspace, multi-agent, multi-tool -- shared memory across your entire AI stack, not just one chatbot.
25+
26+
## How It Works
27+
28+
Your team runs AI agents across different tools -- a dev agent in the IDE, a PM agent in the browser, a support agent in Slack. On Monday, the dev agent learns that the payments API was refactored. On Wednesday, the PM agent is planning a sprint and needs that context. Without shared memory, it doesn't have it. With Knowledge Plane, the dev agent wrote that fact once, the consolidation worker linked it to the payments service card, and now any agent in any tool can find it through search or graph traversal.
29+
30+
## Open Infrastructure
31+
32+
Built on [MCP](https://modelcontextprotocol.io) (Model Context Protocol), the emerging open standard for AI tool integration. Fully self-hostable -- your knowledge stays on your infrastructure. Apache-2.0 licensed, no telemetry, no vendor lock-in. Your data, your rules.
33+
34+
Built by [Camplight](https://camplight.net), a cooperative of AI-native teams across Europe. Used internally to power knowledge sharing across [Juma.ai](https://juma.ai) and Slack-integrated marketing agents.
35+
2236
## Features
2337

2438
- **Persistent agent memory** -- Facts stored in ArangoDB knowledge graph with vector embeddings
@@ -125,7 +139,13 @@ knowledgeplane/
125139

126140
## Contributing
127141

128-
We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
142+
We're actively looking for help with:
143+
- **MCP tool coverage** -- adding new tools and improving existing ones
144+
- **Dashboard UI** -- the web interface needs polish and new views
145+
- **Documentation** -- guides, tutorials, and API docs
146+
- **Testing** -- integration tests, edge cases, benchmark coverage
147+
148+
See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions and guidelines.
129149

130150
## License
131151

0 commit comments

Comments
 (0)