# Fred's Projects - Claude Code Context
**Source of Truth**: `C:\Users\Fred\projects`

This file provides context to Claude Code about all of Fred's active projects. When Fred starts a Claude Code session in VS Code Insiders, Claude should be aware of this ecosystem.

---

## Active Projects

### 1. claude-workflows
**Path**: `C:\Users\Fred\projects\claude-workflows`
**Purpose**: Shared slash commands and ADHD-friendly productivity tools for Claude Code
**Status**: Active development
**Key Features**:
- `/push` - Quick commit and push
- `/eod` - End of day workflow
- ADHD assistant system with proactive interventions
- Auto-discovery scripts for cross-project setup
- Personality-driven assistant behavior (`personality.md`)

**Context Files**:
- `.assistant/personality.md` - Defines ADHD-friendly behavior rules
- `.assistant/state.json.template` - Session state tracking template

---

### 2. VA-Strategy
**Path**: `C:\Users\Fred\projects\VA-Strategy`
**Purpose**: Personal VA disability claims management system
**Status**: Active - in progress
**Goal**: 100% VA disability rating via TDIU
**Current Rating**: 60% combined, 30% highest single (PTSD)

**Context Files**:
- `CLAUDE.md` - Project-specific guidance for Claude Code
- `Gemini.md` - Master strategic roadmap
- `tracking/master-tracking.md` - Claim status tracker
- `tracking/immediate-action-checklist.md` - Priority to-do list

**Key Workflows**:
- Headache tracking for migraine claim (50% target)
- PTSD statement preparation (70% target)
- Sleep apnea evidence collection (50% target)
- Git-based document versioning

---

### 3. infrastructure
**Path**: `C:\Users\Fred\projects\infrastructure`
**Purpose**: Home network, Home Assistant, smart home automation
**Status**: Active maintenance + active projects

**Active Subprojects**:
- **Voice Assistant**: Local GPU-accelerated voice system (Gaming PC + Surface Go)
- **Furnace Control**: ESP32-based smart furnace controller (planning phase)
- **Home Assistant**: Main HA configuration
- **ESPHome**: Device configurations (garage controller, planned furnace)

**Context Files**:
- `README.md` - Infrastructure overview
- `docs/FURNACE-PROJECT.md` - ESP32 furnace project
- `voice-assistant/CLAUDE.md` - Voice system context

**Tech Stack**: Home Assistant, ESPHome, MQTT, Docker, Ollama, Whisper, Piper TTS

---

### 4. claude-code-history
**Path**: `C:\Users\Fred\projects\claude-code-history`
**Purpose**: Session history and state persistence for Claude Code
**Status**: Background system

Contains:
- Session transcripts
- State files
- Project history
- Stats cache

---

### 5. config
**Path**: `C:\Users\Fred\projects\config`
**Purpose**: Shared configuration files
**Status**: Minimal/placeholder

---

## ADHD Assistant Behavior

Claude Code should operate with ADHD-friendly principles when working with Fred:

### Core Principles
1. **Proactive, Not Reactive** - Notice patterns and intervene
2. **Gentle Nudging** - Suggest, don't command
3. **Celebrate Wins** - Acknowledge all completions
4. **Context Preservation** - Remember across sessions
5. **No Judgment** - Side quests are valid exploration

### Side Quest Detection
**When Fred starts working on something unrelated to the current project**, Claude should:

```
🤔 I notice we've shifted focus:

   Current project: [X]
   New work: [Y]

   This looks like a side quest. Would you like to:
   1. Continue (I'll track it)
   2. Switch to the [Y] project
   3. Make this a new project
   4. Park it and return to [X]
```

### Project-Specific Context Loading
When Fred opens a project in VS Code, Claude should:
1. Check for project-specific `CLAUDE.md` file
2. Load project context and current status
3. Greet with relevant session info
4. Track scope drift across project boundaries

---

## Shared Resources

### Claude Shared Directory
**Path**: `C:\Users\Fred\claude-shared\` (symlinked from claude-workflows)
**Contains**:
- Shared slash commands
- ADHD assistant state file (`~/.claude-assistant/state.json`)
- Setup scripts for auto-discovery

### Slash Commands (Available Everywhere)
- `/push` - Auto-commit and push
- `/eod` - End of day workflow
- `/focus` - Check current goals *(in development)*
- `/sidequest` - Log tangents *(in development)*
- `/stuck` - Get unstuck *(in development)*
- `/reflect` - Session review *(in development)*

---

## Cross-Project Workflows

### When Fred Starts a Side Quest
Example: Working on VA-Strategy, starts researching ESPHome for furnace

**Claude should**:
1. Detect context shift (VA → infrastructure)
2. Offer to switch projects
3. If continuing, track as side quest in state file
4. Set timer for check-in (30 min default)
5. Preserve VA-Strategy context for return

### When Fred Opens VS Code in a Project
**Claude should**:
1. Read `.claude-context.md` (this file) for ecosystem awareness
2. Read project-specific `CLAUDE.md` if exists
3. Check state file for active session
4. Greet with context:
   ```
   📋 Welcome back, Fred!

   Project: [name]
   Last session: [time ago]
   Status: [brief summary]

   Ready to continue?
   ```

---

## State Management

### Session State File
**Location**: `~/.claude-assistant/state.json` (Windows: `C:\Users\Fred\.claude-assistant\state.json`)

**Tracks**:
- Current project and goal
- Active side quests
- Stuck signals
- Session history
- Cross-project context

### State File Schema
```json
{
  "current_session": {
    "project": "VA-Strategy",
    "started_at": "2025-12-13T10:00:00Z",
    "primary_goal": "Complete headache log entries",
    "side_quests": [
      {
        "topic": "Research ESP32 temperature sensors",
        "original_project": "VA-Strategy",
        "target_project": "infrastructure",
        "started_at": "2025-12-13T10:30:00Z",
        "status": "in_progress"
      }
    ]
  }
}
```

---

## VS Code Insiders Setup

### Recommended Settings
To enable full context awareness in VS Code Insiders:

1. **Multi-root Workspace** - Open all projects simultaneously
2. **Workspace-Specific Settings** - Per-project `.vscode/settings.json`
3. **Claude Context Files** - This file + project-specific `CLAUDE.md` files

### Creating Multi-Root Workspace
```json
{
  "folders": [
    {
      "path": "C:\\Users\\Fred\\projects\\claude-workflows",
      "name": "🎯 Claude Workflows"
    },
    {
      "path": "C:\\Users\\Fred\\projects\\VA-Strategy",
      "name": "🏥 VA Strategy"
    },
    {
      "path": "C:\\Users\\Fred\\projects\\infrastructure",
      "name": "🏠 Infrastructure"
    }
  ],
  "settings": {
    "claude.contextFiles": [
      "C:\\Users\\Fred\\projects\\.claude-context.md"
    ]
  }
}
```

Save as: `C:\Users\Fred\projects\fred-workspace.code-workspace`

---

## Quick Reference

### Project Quick IDs
- **claude-workflows**: Productivity tools, ADHD assistant
- **VA-Strategy**: VA claims, documentation, tracking
- **infrastructure**: Home automation, voice assistant, ESPHome
- **claude-code-history**: Session history (background)
- **config**: Shared configs (minimal)

### When to Switch Projects
| You're Talking About... | Project | Action |
|------------------------|---------|--------|
| Slash commands, ADHD features | claude-workflows | Switch or side quest |
| VA claims, medical evidence | VA-Strategy | Switch or side quest |
| Home Assistant, ESP32, voice assistant | infrastructure | Switch or side quest |
| New idea unrelated to current work | TBD | Offer to create new project |

---

## For Claude Code: Session Start Checklist

When Fred starts VS Code Insiders:

- [ ] Read `.claude-context.md` (this file)
- [ ] Identify current project from workspace/folder
- [ ] Read project-specific `CLAUDE.md` if exists
- [ ] Check `~/.claude-assistant/state.json` for active session
- [ ] Greet with relevant context
- [ ] Be ready to detect and manage side quests
- [ ] Apply ADHD-friendly behavior from `personality.md`

---

**Last Updated**: 2025-12-13
**Maintained By**: Fred with Claude Code assistance
**Purpose**: Provide ecosystem-level context for intelligent, ADHD-friendly Claude Code sessions