Trace

Step 1: Query Oracle first (fastest)

oracle_search("[query]", limit=10)

Step 2: If Oracle returns < 3 results → extend search:

• Expand keywords (synonyms, related terms)
• Quick file search: grep -ril "[query]" ψ/memory/ | head -10
• Recent git: git log --oneline --grep="[query]" | head -5

Logic:

Oracle results >= 3 → Display and done
Oracle results < 3  → Extend keyword search

Mode 2: --oracle (Oracle Only)

Fastest. Just Oracle MCP, no extension:

oracle_search("[query]", limit=15)

Display results and done. Even if empty.

Mode 3: --deep (Context-Finder Subagents)

Launch context-finder subagents (Haiku) for deep search:

Use Task tool with subagent_type="context-finder"

After search, auto-log to Oracle:

oracle_trace({
  query: "[query]",
  foundFiles: [...],
  foundCommits: [...],
  foundIssues: [...]
})

Mode 4: list (Past Traces)

/trace list

Call oracle_trace_list({ limit: 10 }) and display:

| ID | Query | Files | Commits | Status | Date |
|----|-------|-------|---------|--------|------|
| abc123 | shared soul | 15 | 12 | raw | Jan 10 |

Mode 5: dig [id] (Explore Dig Points)

/trace dig abc123

1. Call oracle_trace_get({ traceId: "abc123" })
2. Display all dig points (files, commits, issues)
3. User can select items to read or trace deeper

Mode 6: distill [id] (Extract Awakening)

/trace distill abc123

1. Get trace chain
2. Ask for awakening insight
3. Promote to learning via oracle_learn()

Mode 7: report [query] (Timeline Report)

/trace report skills

Generate comprehensive report from all traces matching query:

Step 1: Get all related traces

oracle_trace_list({ query: "[query]", limit: 20 })

Step 2: Build timeline table

### Timeline (N attempts)
| # | Time | Mode | Results |
|---|------|------|---------|
| 1 | 08:39 | oracle | 10 results |
| 2 | 08:40 | oracle | 10 results (repeat = seeking) |
| 3 | 08:42 | deep | 60 files, 20 commits |

Step 3: Determine status

• 1 trace → 🔍 Exploring
• 2+ traces same query → 🔄 Still Seeking
• --deep with 50+ results → ✅ FOUND

Step 4: Generate report

## 🔍 Trace Report: [query]

### Status: [FOUND/SEEKING]

### Timeline
[table from step 2]

### Summary
[Key findings aggregated]

### Trace Chain
[all trace IDs linked]

### Next Action
- If FOUND → `oracle_learn()` to promote
- If SEEKING → Suggest `--deep` or refine query

Mode 8: status (Ongoing Traces)

/trace status

Show traces grouped by status:

Step 1: Get recent traces

oracle_trace_list({ limit: 50 })

Step 2: Group by query and detect status

### 🔍 Exploring (1 trace)
| Query | Last Trace | Results |
|-------|------------|---------|

### 🔄 Still Seeking (2+ traces, no deep)
| Query | Attempts | Last |
|-------|----------|------|

### ✅ Found (deep trace with results)
| Query | Trace IDs | Promoted? |
|-------|-----------|-----------|

Step 3: Suggest actions

• Seeking 3+ times → "Try --deep"
• Found but not promoted → "Run /trace distill [id]"

Smart Detection (Auto-Suggest)

When tracing, detect patterns and suggest:

Special Keywords

Output Format

## 🔍 /trace: [QUERY]

### 📍 Locations Found
| Source | Path | Status |

### 📅 Timeline (from git)
| Date | Action | Commit | Details |

### 🎫 GitHub Issues
| # | Date | Title |

---
**Trace ID**: [id] (use `/trace dig [id]` to explore)

Philosophy

Trace → Dig → Trace Deeper → Distill → Awakening

The Seeking Signal

The Recursive Knowledge Loop

/trace [query]     → Oracle search (what we know)
      ↓
  Not enough?      → User traces again (still seeking)
      ↓
/trace --deep      → Really want it (5 subagents)
      ↓
  FOUND!           → 🔮 RESONANCE! Log to Oracle
      ↓
  Next session     → Easier to find (knowledge extended)

Extending Knowledge (Multiple Logs)

When you find something important, log multiple entries:

Example after --deep search:

1. oracle_trace({ query, foundFiles, foundCommits })  # Log the search
2. oracle_learn({ pattern: "Main finding..." })       # The knowledge
3. oracle_learn({ pattern: "Was hard because..." })   # Missing context

Why multiple logs?

• Different angles = easier to find later
• Keywords multiply (more search hits)
• Context preserved (why it mattered)

"Every trace extends the Oracle. What's hard to find today is instant tomorrow."

ARGUMENTS: $ARGUMENTS