Troubleshooting

Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file

// WRONG
{
  "name": "everything-claude-code",
  "hooks": ["hooks/hooks.json"]  // ❌ Remove this
}

// CORRECT
{
  "name": "everything-claude-code"
  // ✅ No hooks field needed
}

# Check installed plugins
/plugin list

# If not listed, install:
/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code

# Validate JSON syntax
node -e "JSON.parse(require('fs').readFileSync('hooks/hooks.json', 'utf8'))"

# Check Node.js
node --version
# Should be v16+ for best compatibility

~/.claude/skills/
  ├── tdd-workflow/
  │   └── SKILL.md
  ├── frontend-patterns/
  │   └── SKILL.md

~/.claude/skills/
  ├── tdd-workflow.md  ❌ (should be in subdirectory)
  ├── SKILL.md         ❌ (no parent directory)

# Check each skill has SKILL.md
find ~/.claude/skills -name "SKILL.md"

---
name: skill-name
description: Brief description
origin: ECC
---

# Skill Content

~/.claude/rules/
  ├── coding-style.md
  ├── git-workflow.md
  ├── testing.md

~/.claude/rules/
  ├── common/
  │   ├── coding-style.md  ❌ (should be flat)

cp -r rules/common/* ~/.claude/rules/
cp -r rules/typescript/* ~/.claude/rules/

# User-level rules (all projects)
ls ~/.claude/rules/

# Project-level rules (current project only)
ls .claude/rules/

# Exit Claude Code session
# Start new session

{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}

{
  "env": {
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
  }
}

[Hook] ERROR: pnpm command not found

# Option 1: Install the package manager
npm install -g pnpm

# Option 2: Change to installed package manager
/setup-pm
# Select npm or yarn

# Add to ~/.bashrc or ~/.zshrc
export CLAUDE_PACKAGE_MANAGER=pnpm

node scripts/setup-package-manager.js --project pnpm

# User-level install (default)
ls ~/.claude/skills/

# If empty, re-run installer
./install.sh typescript

/configure-ecc

# Check if tmux detected
echo $TMUX
# Should output tmux session if inside tmux

# Check Prettier
npx prettier --version

# Install if missing
npm install -D prettier

{
  "semi": true,
  "singleQuote": true,
  "trailingComma": "es5"
}

[Hook] TypeScript check failed: 5 errors

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [],
        "description": "Disable TypeScript check"
      }
    ]
  }
}

# Check agents directory
ls ~/.claude/agents/

# If empty, install plugin or copy manually
cp agents/*.md ~/.claude/agents/

/plan "Add user authentication"
/tdd
/code-review

MCP server 'github' failed to connect

{
  "mcpServers": {
    "github": {
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT_HERE"  // ❌
      }
    }
  }
}

npm list -g @modelcontextprotocol/server-github
# If not found:
npm install -g @modelcontextprotocol/server-github

# Test connectivity
curl https://mcp.vercel.com

rm -rf ~/.claude/skills/django-*  # If not using Django
rm -rf ~/.claude/skills/golang-*  # If not using Go

/model sonnet

/compact

## Environment
- ECC Version: [check plugin list or git tag]
- Claude Code Version: [run `claude --version`]
- OS: [macOS / Windows / Linux]
- Node.js Version: [run `node --version`]

## Issue
[Describe what's happening]

## Expected Behavior
[Describe what should happen]

## Steps to Reproduce
1. ...
2. ...

## Logs/Errors
[Paste any error messages]