memory-search

# Memory Search ## Purpose / When to Activate Activate when an agent needs to **find** relevant memory but does not know the exact file path, domain, or DEC ID. This skill **locates** memory — it does not **load** it. After results are returned, the agent invokes `memory-retrieve` to load the specific files. Use cases: - "Which decisions relate to database connection pooling?" → Mode A (frontmatter: domain=infrastructure, tags contains database) - "Where did we discuss pool exhaustion?" → Mode B (full-text keyword: "pool exhaustion") - "What decisions are related to DEC-42?" → Mode C (cross-reference: DEC-42 → related_to + mentions) --- ## Process ### Mode A — Frontmatter Search Search YAML frontmatter fields across `decisions/DEC-*.md` files. 1. Accept query as field-value pairs: `{domain: "infrastructure", level: "operational"}` and/or `{tags: ["connection-pooling"]}` and/or `{related_to: ["<DEC-id>"]}` and/or `{status: "active"}` 2. Grep frontmatter blocks (between `---` delimiters) of all `decisions/DEC-*.md` files 3. Match files where ALL specified fields match (AND logic) 4. Extract `id`, `title`, and matched field values from each hit 5. Rank by: exact tag match > domain match > level match 6. Return top 10 results ### Mode B — Content Search Full-text keyword search across ALL memory files. 1. Accept query as 1-3 keywords (e.g., `"pool exhaustion"`, `"scoring formula"`) 2. Grep all files under `contexts/memory/` for keyword matches 3. For each hit, extract...