📖 Claude Code Workspace Glossary

Examples:

User: "Create a daily plan for today"
→ Triggers /daily-planning command

User: "I need to schedule Lucas's dentist appointment"
→ task-manager skill auto-detects and adds to active-tasks.md

User: "/dashboard lucas"
→ Executes dashboard generation command

Characteristics:

• ✅ Most flexible and natural
• ✅ Supports natural language understanding
• ✅ Can invoke commands explicitly or implicitly
• ✅ Interactive - Claude can ask clarifying questions
• ⚠️ Requires user to be present and engaged

Examples:

Example 1: Direct Task Entry
→ User opens: Personal-Productivity/daily/active-tasks.md
→ User manually adds: "| Review Dylan's homework | 2025-11-21 | 30min | Not Started |"
→ Saves file
→ Task now visible to Claude and dashboard systems

Example 2: Manual Log Entry
→ User opens: Homeschool/learning-log.md
→ User types: "**Nov 20, 2025** | Lucas solved fraction problem independently"
→ Saves file
→ Entry available for weekly review generation

Best Practices:

• Follow existing file format/structure
• Use consistent date formats (YYYY-MM-DD)
• Maintain markdown table alignment
• Add timestamps to log entries
• Save changes frequently

Types of Automation:

1. Time-Based Triggers:
   - Daily planning reminder (6 AM)
   - Weekly review reminder (Sunday 6 PM)
   - End-of-month goal review

2. Event-Based Triggers:
   - Task completion detection
   - File modification triggers
   - Threshold alerts (e.g., goal milestone reached)

3. Integration-Based:
   - MCP server data imports
   - External tool synchronization
   - API data feeds

4. Skill-Based Automation:
   - task-manager auto-detection
   - practice-logger automatic routing
   - progress-tracker calculations

Examples:

Global Skills Location: e:\Lucas\skills/
- task-manager/ - Works across all 7 projects
- data-visualizer/ - Generates dashboards for any project
- practice-logger/ - Logs athletic activities
- meal-planner/ - Plans meals for Seth and Maria
→ These skills can be invoked from any project context

Examples:

Project-Specific Commands:

Location: Homeschool/.claude/commands/
- daily-planning.md → Creates lesson plans (Homeschool-specific)
- quick-note.md → Logs learning observations
→ These commands only work within Homeschool context

Location: Personal-Productivity/.claude/commands/
- daily-planning.md → Creates daily task plans (different from Homeschool!)
- quick-capture.md → Captures tasks/ideas
→ Same command name, different implementation per project

Agent Capabilities:

• File operations: Read, write, edit any workspace file
• Tool usage: Bash commands, glob patterns, grep searches
• Skill invocation: Activate task-manager, data-visualizer, etc.
• Command execution: Run /daily-planning, /dashboard, etc.
• Sub-agent spawning: Delegate complex tasks to specialized sub-agents
• Context management: Remember conversation history and user preferences

Sub-Agent Types:

| Type           | Purpose                  | Use Case                    |
|----------------|--------------------------|------------------------------|
| Explore        | Fast codebase exploration| Finding files, searching     |
| Plan           | Task planning            | Breaking down complex tasks  |
| General-Purpose| Multi-step tasks         | Complex workflows, research  |
| Custom         | Specific domains         | Dashboard gen, data analysis |

Your Available Commands:

Productivity (3):
- /daily-planning - Generate today's plan with context
- /weekly-review - Comprehensive weekly review
- /quick-capture - Fast task/idea capture

Homeschool (5):
- /daily-planning - Create lesson plan (Homeschool context)
- /weekly-review - Homeschool accomplishment summary
- /quick-note - Log learning observations
- /log-activity - Internal activity logging
- /log-summary - Generate activity summary

Dashboard (1 command, 7 variants):
- /dashboard [person] - Generate dashboards
  (/dashboard lucas, dylan, maxi, seth, maria, family, productivity)

Potential Future Uses:

• Fitness tracker integration: Auto-import workout data for Seth/Maria
• School portal sync: Pull Dylan's grades automatically
• Weather service: Check conditions for outdoor practices
• Shopping API: Track prices for baseball equipment
• Calendar sync: Integrate with Google Calendar for family events

Current Status:

⚠️ Not configured in workspace (all data currently file-based)

Your Available Skills:

Global Skills (8):
1. task-manager - Auto-detects and manages tasks
2. data-visualizer - Generates charts and dashboards
3. progress-tracker - Tracks goals and milestones
4. practice-logger - Logs athletic practices
5. meal-planner - Plans meals for Seth and Maria
6. weekly-family-report - Compiles family-wide summaries
7. meeting-notes - Structures meeting documentation
8. email-responder - Drafts email responses

Homeschool Skills (1):
1. update-calendar - Manages homeschool calendar

Key Difference from Commands:

Skills activate automatically based on context; commands require explicit /command invocation.

Hierarchy Principles:

• Global > Project: Global settings apply everywhere unless overridden
• Specificity wins: Project-level command takes precedence over global
• Inheritance: Projects inherit global skills, can add project-specific skills
• Scope boundaries: Project commands only work within that project

Types of Logging:

• Activity Logs: Track actions and events as they occur
• Productivity Logs: Track tasks, focus, energy, and time
• Performance Logs: Track metrics and progress over time
• Learning Logs: Capture observations and insights

Best Practices:

• Timestamps: Always include date and time
• Categorization: Tag entries for filtering
• Context: Include relevant details
• Consistency: Follow format conventions
• Automation: Automate when possible

Components of Context:

• Conversation History: Previous messages in current chat session
• File Contents: Files Claude has read in this session
• Project State: Current working directory and project context
• Workspace Structure: Knowledge of file locations and organization
• Active Skills and Commands: Available capabilities in current context

Maintaining Good Context:

• Start new chats for new topics
• Refresh context when needed ("Re-read Lucas's profile")
• Be specific about project
• Reference previous context explicitly

Agentic Characteristics:

• Autonomy: Agents make decisions without constant human input
• Perception: Agents sense their environment (read files, detect patterns)
• Action: Agents take actions to achieve goals
• Goal-Oriented: Agents work toward defined objectives
• Learning/Adaptation: System improves through patterns and feedback

Your Workspace as Agentic System:

USER (provides goals)
    ↓
MAIN AGENT (Claude - orchestrates)
    ↓
    ├→ SKILLS (auto-activate capabilities)
    ├→ COMMANDS (execute workflows)
    ├→ SUB-AGENTS (handle complex tasks)
    └→ FILE SYSTEM (reads/writes data)

User Input:

"I need to plan next week's lessons for Lucas, schedule his baseball practice,
and create meal plans for Seth and Maria"

System Behavior:

Main Agent processes message
    ↓
task-manager skill auto-activates (detects "I need to")
    ↓
Parses 3 distinct tasks:
    │
    ├─ Task 1: "Plan next week's lessons for Lucas"
    │  Keywords: "lessons", "Lucas" → Homeschool context
    │  Routes to: Homeschool tasks
    │
    ├─ Task 2: "Schedule his baseball practice"
    │  Keywords: "baseball", "practice" → Athletics context
    │  Routes to: Lucas-Athletics tasks + calendar
    │
    └─ Task 3: "Create meal plans for Seth and Maria"
       Keywords: "meal plans", "Seth and Maria" → Health context
       Routes to: Health-Seth and Health-Maria tasks

✓ Single input → 3 tasks → Routed to 3 different projects automatically!

User Input:

"Lucas had practice today: 80 swings, 72% contact rate, worked on follow-through"

System Behavior:

practice-logger skill auto-activates
    ↓
Creates practice log → practice-logs/2025-11-20-practice.md
    ↓
Updates batting stats → metrics/batting-stats.md (new row: 72%)
    ↓
Triggers progress-tracker → Recalculates progress (65% → 72% = 90% to goal!)
    ↓
Triggers data-visualizer → Regenerates lucas-dashboard.html
    ↓
Updates calendar → 2025-11-baseball-schedule.md (✓ completed)
    ↓
Confirms to user:
    "✓ Practice logged for Lucas
     📊 72% contact rate - New personal best! (+7% improvement)
     🎯 90% of way to 80% goal
     📈 Dashboard updated with latest data"

✓ One practice entry → 5 files updated → Dashboard regenerated → Insights calculated!