ref-tracker

## ⚠️ DEPRECATED IN v2.0

**This skill is no longer needed in Track Plugin v2.0.**

**Why deprecated:**
- v1.x used skill-based tracking (Claude invoked this skill to track)
- v2.0 uses hooks-based tracking (hooks run automatically)
- Hooks are more reliable and require no skill activation

**Migration:**
- Remove any manual invocations of this skill
- Use `/track:init` to enable hooks-based tracking
- Hooks track automatically - no skill needed

**See:** `/track:help` for v2.0 documentation

---

## Quick Example (v1.x behavior - deprecated)

After auto-tracking is enabled, when you search for PostgreSQL documentation:
```
WebSearch("PostgreSQL JSON query functions") triggered
→ skill detects .ref-autotrack exists
→ appends to CLAUDE_SOURCES.md:
   [Claude] WebSearch("PostgreSQL JSON query functions"): https://postgresql.org/docs/current/functions-json.html
```

# Reference Tracker Skill

Automatically track research sources and major prompts for academic and project documentation.

## When to Activate

This skill activates automatically when:
1. User runs `/track:init` command
2. You notice `CLAUDE_SOURCES.md` or `CLAUDE_PROMPTS.md` files in the project

Claude autonomously decides when to use this skill based on the description and context.

Once activated, check `./.claude/.ref-autotrack` to determine if auto-tracking is enabled.

## Activation Check

**Before any tracking operation:**

1. Check if `./.claude/.ref-autotrack` exists
   - If exists → auto-tracking enabled, proceed with tracking
   - If missing → auto-tracking disabled, skip tracking

2. Read `./.claude/.ref-config` for verbosity settings:
   ```
   PROMPTS_VERBOSITY=major|all|minimal|off
   SOURCES_VERBOSITY=all|off
   ```

## About the .ref-autotrack File

**Location:** `./.claude/.ref-autotrack`

**Purpose:** Marker file that enables/disables automatic tracking

**Contents:** Contains explanatory comments for other Claude sessions:
```
# Auto-tracking marker for ref-tracker plugin
# Presence = e