Memory layer setup: claude-flow MCP + Phase 3 design handoff#2
Open
aryansingh-rgb wants to merge 1 commit into
Open
Memory layer setup: claude-flow MCP + Phase 3 design handoff#2aryansingh-rgb wants to merge 1 commit into
aryansingh-rgb wants to merge 1 commit into
Conversation
Adds project-scope claude-flow MCP server config and a detailed session-bridging handoff document. No production Go code yet -- implementation is the next teammate task per HANDOFF.md sections 6/7. What is included: - .mcp.json: project-scope claude-flow@alpha MCP server (memory_store, memory_retrieve, memory_search exposed; HNSW + sql.js backend with 768-dim mpnet embeddings). - HANDOFF.md: 600+ line bridging doc with locked design (short-circuit only memory pattern, threshold in config, resolver-side firing), live-probed real MCP tool surface (replaces earlier guesses), Phase 3 Go implementation plan with full code shape, threshold calibration battery (section 13.1) the next session must run before locking the value. - .gitignore: ignore .swarm/ (claude-flow runtime SQLite state). Key probe finding: near-paraphrase scored 0.6366 against this embedding model -- the placeholder 0.95 short-circuit threshold would never fire. Calibration deferred to teammate per section 13.1. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No production Go code in this PR. Implementation lands in a follow-up branch per HANDOFF.md §6/§7.
Why design-only
A live MCP probe this session revealed the tool surface differs materially from earlier handoff guesses (
memory_retrievenotmemory_get,similaritynotscore, 768-dim not 384-dim, search returns truncatedvalue). Capturing real shapes before writing Go bindings saves the next dev meaningful debug time. The probe also showed our placeholder threshold (0.95) is far too high — a near-paraphrase scored only0.6366— so calibration is parked in §13.1 and runs alongside Phase 3 implementation rather than blocking this PR.Test plan
claude mcp listshowsclaude-flow ✓ Connected