---
name: mine
description: >-
  Explores a knowledge vault with a single thematic lens, synthesises up to 9
  candidate insights, and shows the top 3 by priority (gaps, contradictions,
  opportunities, stale notes). Read-only by default. Use when the user says
  mine, /mine, vault insights, or find gaps.
---

# Mine

Reflective vault exploration: find actionable or clarifying insights, not summaries. Read-only by default: propose changes; edit only when the user asks to act.

## Step 0: Pick the lens (required, state upfront)

Before searching, choose **one** focus:

| Source | Examples |
|--------|----------|
| User names it | "retention", "capacity", "partner risk" |
| Active project | highest-priority active effort |
| Reference notes | methodology, operating principles |
| Session context | open task tracker item, at-risk weekly budget |

If the user gives no lens, propose one from vault state and state it in the output header.

**Lens (one line)**: always the first line of the report.

## Search strategy

Search broadly; read narrowly.

1. Hub / map-of-content notes first.
2. Lens-targeted reads: project parent, decisions, recent weekly notes.
3. Keyword or semantic search across reference, projects, and calendar layers.
4. Optional: a vault index for stale projects, open-task drift, and hygiene flags when the lens fits.
5. Task tracker signals when the lens touches execution: active, overdue, waiting.

Read titles, frontmatter, decisions, and gaps: not every note verbatim.

## Insight types

Tag every insight with exactly one:

| Tag | Meaning |
|-----|---------|
| `observation` | Pattern or fact worth naming |
| `gap` | Missing doc, decision, link, or owner |
| `opportunity` | Positive change: experiment, link, distill, quest |
| `contradiction` | Two notes conflict; needs resolution |
| `stale` | Outdated vs newer source; refresh or archive candidate |

Insights must be specific: cite evidence, not generic advice.

## Priority filter (default: show top 3)

Synthesise up to **9** candidates, then rank and output only the **top 3** unless the user asks for more.

Rank by leverage on the stated lens: highest first:

1. Blocks active execution
2. Contradiction or gap on the critical path
3. Opportunity with a real time box
4. Stale note the lens actually depends on
5. Observation with no immediate action
6. Parked work only if nothing sharper exists

## Output format

```markdown
**Lens:** [one line]

1. **[type]**: [insight in one or two sentences]
   - **Evidence:** [paths or links]
   - **Action:** [optional one line (propose only)]

2. **[type]**: …

3. **[type]**: …

**If you act on one thing:** [single highest-leverage recommendation]
```

## Quality bar

**Good:** a concrete mismatch between a stated weekly win and a playbook last updated before a known change.

**Bad:** "You have a lot of notes about this topic."

## Do not

- Exceed 9 candidates in synthesis (or show more than 3 in default mode without a deep request)
- Run without stating the lens
- Output generic summaries
- Edit the vault unless the user asks to act on an insight