help

## Quick Example

```bash
/track:help
# Displays comprehensive hooks-based tracking documentation
# Commands, file formats, verbosity settings, and workflow examples
```

# help - Hooks-Based Tracking System Help

Comprehensive help for the Track Plugin v2.0 hooks-based automatic tracking system.

## Overview

The Track Plugin v2.0 uses Claude Code hooks for **fully automatic** reference and prompt tracking for academic work and project documentation.

**Two tracking files:**
- `claude_usage/sources.md` - Research sources (WebSearch, WebFetch, documentation)
- `claude_usage/prompts.md` - Major prompts and outcomes

**Key features:**
- **Automatic tracking via hooks** (PostToolUse, UserPromptSubmit, SessionEnd)
- **No skill activation needed** - hooks run automatically
- **Per-project activation** - only tracks when enabled
- **Configurable verbosity** - control what gets tracked
- **Export support** - generate bibliographies and methodology sections
- **Attribution system** - tracks [User] vs [Claude] initiated sources

## v2.0 Architecture

**Hooks-based tracking** (NEW):
- **PostToolUse hook** → Automatically tracks WebSearch/WebFetch/Read/Grep to `claude_usage/sources.md`
- **UserPromptSubmit hook** → Captures user prompts to temporary storage
- **SessionEnd hook** → Pairs prompts with outcomes, writes to `claude_usage/prompts.md`

**Fully automatic** - no manual intervention:
- Hooks check for `.claude/.ref-autotrack` marker
- If present, hooks track automatically
- No skill activation needed (unlike v1.x)

## Commands (Skills)

### `/track:init` - Initialize tracking
Set up hooks-based tracking files and configuration for the current project.

Creates:
- `claude_usage/sources.md` (with preamble)
- `claude_usage/prompts.md` (with preamble)
- `.claude/.ref-autotrack` (enables hooks)
- `.claude/.ref-config` (verbosity settings)

**Run this first** before using other tracking commands.

---

### `/track:auto` - Toggle hooks-based tracking
Enable or disable automati