---

name: context-refresh description: Update and maintain project context.md with current state license: MIT compatibility: opencode metadata: workflow: context-management priority: high

Context Refresh

This skill helps maintain and update the project's context.md file.

What I Do

1. Read current context.md
2. Identify what's outdated or missing
3. Update with current project state
4. Add recent decisions and changes
5. Document pending work

When To Use Me

Use this skill when:

• Completing a significant task
• Before ending a session
• After major architectural changes
• When context.md is outdated
• Before compaction happens

Context.md Structure

Copy# Project Context

## Current State
- What's working
- What's in progress
- Known issues

## Recent Changes
- File: change description
- File: change description

## Key Decisions
- Decision 1: rationale
- Decision 2: rationale

## Pending Tasks
- [ ] Task 1
- [ ] Task 2

## Technical Notes
- Important implementation details
- Gotchas and workarounds

Steps

1. Analyze Current State

CopyRead all recent file changes
Check git log for context
Review current todos

2. Update Sections

CopyUpdate "Current State" with latest
Add new "Recent Changes"
Record any "Key Decisions"
Update "Pending Tasks"

3. Validate

CopyEnsure no stale information
Check for completeness
Verify accuracy

Tips

• Keep context.md concise but complete
• Focus on "what" and "why", not just "how"
• Include gotchas and edge cases
• Reference important files