homelab-docs/README.md

Fred's Projects - Source of Truth

This is the master directory for all active projects. It serves as the "source of truth" for Claude Code sessions.

---

Quick Start with VS Code Insiders

Open the workspace:

Double-click: fred-workspace.code-workspace

Or from VS Code: File → Open Workspace → fred-workspace.code-workspace

Start Claude Code:

cd C:\Users\Fred\projects
claude

Tell Claude to load context:

"Read .claude-context.md to understand my project structure"

---

Projects Overview

🎯 claude-workflows

ADHD-friendly productivity tools for Claude Code

• Slash commands (/push, /eod)
• ADHD assistant with sidequest detection
• Auto-discovery for cross-project setup

Start here when: Working on Claude Code tooling, productivity features

---

🏥 VA-Strategy

VA disability claims management system

• Goal: 100% VA rating via TDIU
• Current: 60% combined (30% highest single)
• Tracking, evidence, statements, forms

Start here when: Working on VA claims, medical documentation

Quick commands:

cd VA-Strategy
git status                    # Check what's changed
cat tracking/master-tracking.md  # See current status

---

🏠 infrastructure

Home network, Home Assistant, smart home

• Home Assistant configuration
• ESPHome devices (garage controller, furnace)
• Voice assistant system (GPU-accelerated, local)
• Network infrastructure (MQTT, DNS-over-TLS)

Start here when: Working on home automation, voice assistant, ESPHome

Active subprojects:

• Voice Assistant: Gaming PC + Surface Go
• Furnace Control: ESP32 planning phase
• Home Assistant: Main config

---

⚙️ config

Shared configuration files

Minimal/placeholder for cross-project configs.

---

📚 claude-code-history

Background: Claude Code session history

Session transcripts, state files, stats. Mostly hidden from searches.

---

Key Files

File	Purpose
.claude-context.md	Master context file - tells Claude about all projects
fred-workspace.code-workspace	VS Code multi-root workspace
VSCODE-SETUP.md	Detailed setup guide for VS Code + Claude
README.md	This file - quick reference

---

ADHD-Friendly Workflow

How Sidequest Detection Works

1. You're working in one project (e.g., VA-Strategy)
2. You start exploring something related to another project (e.g., ESP32 for infrastructure)
3. Claude detects the context shift
4. Claude offers to:
   • Track it as a side quest
   • Switch projects formally
   • Create a new project
   • Return to original work

Example

You: [Working in VA-Strategy on headache log]
You: "I wonder if I could automate headache tracking with Home Assistant"

Claude: 🤔 Side quest detected!

   Current: VA-Strategy (headache log)
   New idea: HA automation (infrastructure)

   Options:
   1. Continue exploring (I'll track it)
   2. Switch to infrastructure project
   3. Create new "health-automation" project
   4. Return to headache log

---

Common Workflows

Start Working on a Project

cd C:\Users\Fred\projects\VA-Strategy
claude
# Tell Claude what you want to work on

Switch Projects Mid-Session

Just tell Claude:

"I want to switch to working on infrastructure now"

Claude will track the context switch.

Explore a Side Quest

"This is a side quest - I want to explore X for 20 minutes"

Claude will set a timer and check in.

End of Day

/eod

Claude will:

• Commit your changes
• Show what you accomplished
• Prepare for tomorrow

---

Setup Checklist

• .claude-context.md created
• Workspace file created
• Open workspace in VS Code Insiders
• Create ADHD assistant state directory:

  New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude-assistant" -Force
  Copy-Item "claude-workflows\.assistant\state.json.template" "$env:USERPROFILE\.claude-assistant\state.json"
  

• Start Claude Code session
• Test sidequest detection

---

Files You Should Know About

Global Context

• .claude-context.md - Tells Claude about all your projects
• fred-workspace.code-workspace - Multi-root workspace for VS Code
• VSCODE-SETUP.md - Detailed setup instructions

ADHD Assistant

• claude-workflows/.assistant/personality.md - How Claude should behave
• claude-workflows/.assistant/state.json.template - Session state template
• ~/.claude-assistant/state.json - Your active state file (to be created)

Project-Specific

• VA-Strategy/CLAUDE.md - VA project context
• VA-Strategy/README.md - VA project overview
• infrastructure/README.md - Infrastructure overview
• claude-workflows/README.md - Workflows overview

---

Customization

Adjust ADHD Assistant Behavior

Edit: ~/.claude-assistant/state.json

{
  "user": {
    "preferences": {
      "intervention_style": "gentle",    // gentle | assertive | minimal
      "stuck_threshold": 3,              // How many times before intervention
      "sidequest_time_limit_minutes": 30, // Check-in time
      "celebrates_completions": true     // Celebrate wins
    }
  }
}

Add More Projects

Edit: fred-workspace.code-workspace

Add new folder:

{
  "path": "new-project",
  "name": "📦 New Project"
}

---

Getting Help

Claude Code

• /help - Claude Code help
• Ask Claude: "How does sidequest detection work?"

Project-Specific

• Each project has a README.md
• VA-Strategy and infrastructure have CLAUDE.md files

Issues

Report at: https://github.com/anthropics/claude-code/issues

---

Philosophy

This setup is designed to work with ADHD, not against it:

✓ Side quests are valid exploration ✓ Context switching is supported ✓ Progress is celebrated ✓ No judgment on workflow ✓ Gentle nudging, not rigid control

Claude is here to help you stay aware of what you're working on, not to police your focus.

---

Ready? Open fred-workspace.code-workspace and start a Claude session!