mc-memory-search

Solid

Search this Clayrune project's accumulated memory — prior decisions, conventions, gotchas, and past session outcomes — that are NOT in the auto-loaded MEMORY.md index. TRIGGER when you hit an unknown about this project's history ("have we done X before?", "why is Y this way?", "what was decided about Z?"), when you're about to touch a subsystem and want prior art, or when the user references earlier work you have no context on. Use this BEFORE guessing or re-deriving something that may already be solved.

AI & Automation 9 stars 1 forks Updated today MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
33
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Project Memory Search The auto-loaded `MEMORY.md` is only a curated pointer index — the detail (topic files, the session log, the archive) is NOT in your context. This skill does a ranked search over that full corpus and is the reliable way to recover prior project knowledge mid-task. Relevant memory for your current task is also auto-surfaced in your system context under **"RELEVANT MEMORY"** — check there first. Use this skill when that's absent or insufficient, or when you need to dig into a *different* topic than the task started on. ## How to call it You know your Clayrune project id and port from the SYSTEM block (the same id used by the backlog/process curls). Then: ``` curl -s "http://localhost:5199/api/project/<PROJECT_ID>/memory/search?q=<QUERY>&k=5" ``` - `q` — space-separated keywords (URL-encode spaces as `%20` or `+`). Use the concrete nouns of what you're unsure about: subsystem name, file, feature, decision topic. Terms shorter than 3 chars are ignored. - `k` — max results (default 3; use 5–8 when exploring). Returns a JSON array, ranked best-first: ```json [{"file": "arch_sse_slot_management.md", "score": 7, "snippet": "Chromium caps 6 connections per origin; close SSE on …"}] ``` ## How to use the results 1. The `snippet` is a preview, not the whole story. If a hit looks relevant, **open the referenced file** for full detail: - `<file>.md` → a topic file in the project's memory dir — Read it. - `MEMORY.md#managed` → a session-log e...

Details

Author
ronle
Repository
ronle/clayrune
Created
5 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

memory-search

Searches the project's recorded memory (core-memory-kit) — decisions, conventions, architecture, the reasoning behind choices, and where things live — and returns a curated, cited summary. Fire whenever the answer might be something the project already established in past work, HOWEVER the question is phrased — any prior decision, convention, rationale, or "how/where/why is it this way" question, including oblique or roundabout asks ("why is everything so spread out?", "remind me what we settled on for X", "how come these files are tiny?"). Also fire when a "[core-memory-kit] Memory available" hint appears on the prompt. The examples are illustrative, not a checklist — prefer recalling over re-deriving an answer from the code. The session-start snapshot is a bounded index; this skill reaches the rest. Skip only when the question is purely about uncommitted or just-edited live code that memory cannot know, concerns this conversation only, or the user asked to ignore memory.

6 Updated today
LH8PPL
AI & Automation Listed

memory-query

Search project memory files for a specific topic, decision, or constraint and return matching entries with citations. Use when you need to find what was decided about X, why Y was chosen, or whether Z is a known issue. Trigger this when someone says: what do we know about X, was there a decision about Y, check memory for Z, find the memory entry for X, what did we decide about Y, look up memory for X. Do NOT use for a full memory hygiene pass — use /memory-audit instead.

6 Updated 2 weeks ago
chuckplayer
AI & Automation Listed

mem-search

Search persistent project memory across sessions — decisions, bugs, features, discoveries

3 Updated today
djnsty23