context-read

# Read Project Context

This skill guides you through reading and understanding all project context stored in [CONTEXT] commits.

## When to Use

Use this skill when:
- Starting a new Claude session with a project
- User requests to "show context" or "review project docs"
- Need to refresh understanding of project requirements
- Verifying context setup is working correctly
- Onboarding to an unfamiliar project

## Context Reading Workflow

### 1. Read CLAUDE.md

Start by reading the context index:

```bash
cat CLAUDE.md
```

This shows you:
- List of context commit references
- Session initialization instructions
- Any project-specific guidance

### 2. Extract Context References

Parse CLAUDE.md to identify:
- Commit hashes that need to be read
- Branch names (like context-progress)
- Number and description of each context entry

Example CLAUDE.md format:
```
READ THESE COMMIT MESSAGES FOR CONTEXT:
 1. [abc1234] Project requirements
 2. [def5678] TDD workflow
 3. [context-progress] Current progress
```

### 3. Read Each Context Commit

For each referenced commit, retrieve the full message:

```bash
# For commit hash references
git log [commit-hash] -1 --format=%B

# For branch references (like context-progress)
git log [branch-name] -1 --format=%B

# Example
git log abc1234 -1 --format=%B
git log context-progress -1 --format=%B
```

### 4. Organize and Summarize

After reading all context, provide a summary organized by type:

- **Requirements**: What the project needs to accomplish
- **Technical Specs**: Technologies, platforms, versions
- **Workflows**: Development processes, TDD, review practices
- **Architecture**: Design decisions, patterns, trade-offs
- **Progress**: Current status, completed work, next tasks

### 5. Acknowledge Understanding

Confirm you've read and understood the context:

"I've read all context commits and understand:
- Project goals and requirements
- Development workflow and TDD practices
- Current progress and next tasks
- [Any other key