context-mate

# Context Mate

A toolkit that works with Claude Code's natural flow. Use what helps, ignore what doesn't.

---

## When This Skill Activates

When context-mate is invoked, **analyze the project first** before recommending tools.

### Step 1: Quick Project Scan

Check for these files (use Glob, don't read contents yet):

| File/Pattern | Indicates |
|--------------|-----------|
| `SESSION.md` | Session tracking active |
| `IMPLEMENTATION_PHASES.md` | Phased planning in use |
| `PROJECT_BRIEF.md` | Project explored/planned |
| `CLAUDE.md` or `.claude/` | AI context exists |
| `.claude/rules/` | Correction rules present |
| `package.json` or `requirements.txt` | Has dependencies |
| `tests/` or `*.test.*` | Has test infrastructure |

### Step 2: Git State (if git repo)

```bash
git status --short            # Uncommitted changes?
git log --oneline -3          # Recent commit messages?
```

### Step 3: Assess Stage and Recommend

**Project Stages:**

| Stage | Signs | Recommend |
|-------|-------|-----------|
| **New Project** | No CLAUDE.md, no phases | `/explore-idea` or `/plan-project` |
| **Active Development** | SESSION.md or phases exist | `/continue-session`, developer agents |
| **Maintenance Mode** | Docs exist, no SESSION.md | `/plan-feature` for new work, `project-health` for audits |
| **Mid-Session** | Uncommitted changes + SESSION.md | Continue current work, `/wrap-session` when done |

### Step 4: Brief Output

Tell the user:
1. **What's already set up** (e.g., "You have SESSION.md and phases - mid-project")
2. **What would help now** (e.g., "Run `/continue-session` to resume")
3. **What's available but not in use** (e.g., "No tests yet - `test-runner` available")

**Example:**

> **Project Analysis**
>
> ✓ `CLAUDE.md` - AI context configured
> ✓ `SESSION.md` - Session tracking active (Phase 2 in progress)
> ✓ `.claude/rules/` - 3 correction rules
> ○ No test files detected
>
> **Recommendations:**
> - Run `/continue-session` to resume Phase 2 work
> - U