---
name: debug
description: Debug and troubleshoot Claude Code configuration
aliases: [diag, diagnose]
invokes: skill:debug
---

# Debug Command

Generate a debug report for troubleshooting.

## Usage

```
/debug                  # Full debug report
/debug --paths          # Show configuration paths
/debug --json           # Output as JSON
```

## Implementation

Run the debug script:

```bash
~/.claude/automation/debug.sh [options]
```

## Report Sections

| Section | Contents |
|---------|----------|
| Version | Current configuration version |
| Core Files | Status of essential files |
| State Files | PA preferences, session context, autonomy |
| Memory Files | Preferences, decisions, projects, facts |
| Key Scripts | Executable status of automation scripts |
| Skills | List of available skills |
| Commands | Count of slash commands |
| Agents | Count of agent files |
| Environment | Shell, Python, kubectl status |
| Disk Usage | Space used by each directory |

## JSON Output

Use `--json` for machine-readable output, useful for:
- Automated health checks
- Monitoring integration
- Scripting