Files
gh-taylorhuston-ai-toolkit-…/commands/refresh.md
2025-11-30 09:00:21 +08:00

79 lines
1.8 KiB
Markdown

---
tags: ["context", "workflow", "optimization"]
description: "Silently refresh AI context by reading project configuration, guidelines, and recent commits"
argument-hint: ""
allowed-tools: ["Read", "Bash", "Grep", "Glob"]
model: claude-sonnet-4-5
references_guidelines:
- docs/development/workflows/task-workflow.md # Context refresh patterns in development workflow
---
# /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
```bash
/refresh # Silent context reload
```
## Execution Steps
### 1. Read Project Configuration
```bash
Read: CLAUDE.md
```
If missing: Error "CLAUDE.md not found - run /toolkit-init first"
### 2. Read All Guidelines
```bash
Glob: docs/development/{conventions,workflows,misc,templates}/*.md
# Then read each file found
```
If no guidelines found: Skip silently, continue.
### 3. Read Project Documentation
```bash
Read: docs/project/*.md
```
If files missing: Skip silently, continue.
### 4. Get Recent Work Context
```bash
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)