---
name: code-query
description: Search the codebase and Obsidian vault together for relevant implementation and project context. Use when the user asks how something works, where it is implemented, or wants related notes alongside code results.
---

# Code Query

Answer a "how does X work / where is X" question from **both** the code and the vault. The
vault half is the point — code search alone misses the decisions, tickets and topic notes
that explain why the code is the way it is.

## Usage

```
/code-query <search-term>
```

`$ARGUMENTS` is the search term or question.

## Actions

1. Search the codebase. For Unison projects use the `unison` MCP server; otherwise locate
   first (`rg -l`, narrow globs) and read only the slice needed.
2. Search the vault for related context — task notes, Topics, Events — via the `vault` skill.
3. Return consolidated results:
   - code locations as `file:line`
   - related vault notes as wikilinks
   - a short summary tying the two together

## Examples

```
/code-query authentication flow
/code-query how errors are handled
/code-query database connection
```