claude-code-mastery

# Claude Code Mastery

Complete skill for setting up, optimizing, and mastering Claude Code with a full development team of subagents.

**Official Docs:** https://code.claude.com/docs

---

## ⚡ Quick Check: Is Setup Complete?

**Run this first:**
```bash
command -v claude >/dev/null && echo "✅ Claude Code installed - SKIP to 'Daily Use' section" || echo "❌ Not installed - follow 'First-Time Setup' below"
```

If Claude Code is already installed, **skip directly to the "Daily Use" section below.**

---

# 🔧 FIRST-TIME SETUP (Skip if already installed)

> **Note to bot:** Only follow this section if Claude Code is NOT installed. Check with the command above. Once setup is complete, this section can be ignored on future invocations.

## Setup Scripts

Run these in order:

```bash
cd ~/clawd/skills/claude-code-mastery/scripts

# 1. Check dependencies
./01-check-dependencies.sh

# 2. Install Claude Code
./02-install-claude-code.sh

# 3. Authenticate
./03-first-time-auth.sh

# 4. Install dev team subagents
./04-install-subagents.sh              # Starter pack (3 agents) - recommended
./04-install-subagents.sh --full-team  # All 11 agents

# 5. (Optional) Persistent memory - prompts y/N, default No
./05-setup-claude-mem.sh               # Interactive prompt
./05-setup-claude-mem.sh --skip        # Skip entirely
./05-setup-claude-mem.sh --yes         # Install without prompting
```

## Configuration

Edit `config.sh` to customize:
- `VALID_MODELS` — Add models as Anthropic releases them
- `HEARTBEAT_DIAGNOSTICS` — Enable/disable in heartbeat (default: false)
- `INSTALL_MODE` — Default to "starter" or "full"

## Setup Gotchas

| Issue | Solution |
|-------|----------|
| "Command not found" | Add `~/.local/bin` to PATH |
| Auth errors | Run `./03-first-time-auth.sh` |
| Slow startup | First run indexes codebase |
| Subagents not showing | Run `./04-install-subagents.sh` |

## Post-Setup: Add Heartbeat Task

After setup, add the maintenance task to your HEARTBEAT.md (see...

# Claude Code Mastery 🧑‍💻

A comprehensive skill for mastering Claude Code with setup scripts, dev team subagents, and automated maintenance.

## Why This Skill?

Claude Code is powerful on its own. This skill adds:
- **Specialized subagents** — Route tasks to experts (frontend, backend, PM, etc.)
- **Structured setup** — Scripts that handle installation correctly
- **Self-improvement** — Heartbeat tasks that keep you learning
- **Best practices** — Docs on context management, workflows, pro tips

## Quick Install

```bash
cd ~/clawd/skills/claude-code-mastery/scripts

# Run setup scripts in order
./01-check-dependencies.sh
./02-install-claude-code.sh
./03-first-time-auth.sh
./04-install-subagents.sh           # Starter pack (3 agents) - recommended
./04-install-subagents.sh --full-team  # All 11 agents
./05-setup-claude-mem.sh            # Optional - prompts y/N (default: No)
```

## What's Included

### 🤖 Dev Team Subagents

**Starter Pack (default):**
| Agent | Purpose |
|-------|---------|
| senior-dev | Architecture, complex code, code review |
| project-manager | Task breakdown, timelines, dependencies |
| junior-dev | Quick fixes, simple tasks (fast & cheap) |

**Full Team (`--full-team`):**
| Agent | Purpose |
|-------|---------|
| frontend-dev | React, UI, CSS, client-side |
| backend-dev | APIs, databases, server-side |
| ai-engineer | LLM apps, RAG, prompts, agents |
| ml-engineer | ML models, training, MLOps |
| data-scientist | SQL, analysis, statistics |
| data-engineer | Pipelines, ETL, data infrastructure |
| product-manager | Requirements, user stories, prioritization |
| devops | CI/CD, Docker, K8s, infrastructure, automation |

Each agent includes a **"Learn More"** section with curated links to official docs, tutorials, and best practices.

### 📜 Scripts

| Script | Purpose |
|--------|---------|
| `01-check-dependencies.sh` | Verify system requirements |
| `02-install-claude-code.sh` | Install Claude Code CLI |
| `03-first-time-auth.sh` | Au...