gh-taylorhuston-ai-toolkit-plugins-ai-toolkit/commands/refresh.md

tags, description, argument-hint, allowed-tools, model, references_guidelines

tags	description	argument-hint	allowed-tools	model	references_guidelines
context workflow optimization	Silently refresh AI context by reading project configuration, guidelines, and recent commits		Read Bash Grep Glob	claude-sonnet-4-5	docs/development/workflows/task-workflow.md

/refresh Command

WHAT: Silently reload project context by reading critical configuration files.

WHY: Use when starting a new conversation, after context loss, or before major tasks.

HOW: See workflow details in project guidelines (files are read, not explained).

Usage

/refresh    # Silent context reload

Execution Steps

1. Read Project Configuration

Read: CLAUDE.md

If missing: Error "CLAUDE.md not found - run /toolkit-init first"

2. Read All Guidelines

Glob: docs/development/{conventions,workflows,misc,templates}/*.md
# Then read each file found

If no guidelines found: Skip silently, continue.

3. Read Project Documentation

Read: docs/project/*.md

If files missing: Skip silently, continue.

4. Get Recent Work Context

Bash: git log -3 --format="%h - %s%n%b%n---"

If git unavailable: Skip silently, continue.

5. Output

✓ Context refreshed

Silent operation: Do NOT summarize files, list what was read, or explain context.

Error Handling

• CLAUDE.md missing: Fail with error message
• Other files missing: Skip silently
• Git unavailable: Skip git log, continue with files

Notes

• Read-only: Never modifies files
• Idempotent: Safe to run multiple times
• Focused: Only reads critical context files, not task-specific files (PLAN.md, WORKLOG.md)