docs: add fork maintenance guide and sync script

- Add sync-upstream.sh script to automate synchronization
- Add FORK_GUIDE.md with complete workflow documentation
- Includes best practices, commands, and troubleshooting

Author: cocosar

FORK_GUIDE.md

@@ -0,0 +1,127 @@
+# Guía de Uso del Fork Local
+
+## 🔄 Sincronización Regular
+
+Para mantener tu fork actualizado con el repo original de BrowserStack:
+
+```bash
+# Opción 1: Usar el script
+./sync-upstream.sh
+
+# Opción 2: Manualmente
+git checkout main
+git fetch upstream
+git merge upstream/main
+git push origin main
+```
+
+**Cuándo sincronizar:**
+- Antes de empezar a trabajar en nuevos cambios
+- Cuando sepas que BrowserStack hizo actualizaciones
+- Antes de crear un nuevo PR
+
+## 🌿 Flujo de Trabajo para Nuevos Cambios
+
+### 1. Siempre trabaja en ramas (nunca en main)
+```bash
+# Crear rama para nueva feature
+git checkout -b feature/nueva-funcionalidad
+
+# Hacer tus cambios...
+# Editar archivos
+
+# Commit y push
+git add .
+git commit -m "feat: descripción del cambio"
+git push origin feature/nueva-funcionalidad
+
+# Crear PR en GitHub desde tu rama al main del upstream
+```
+
+### 2. Mantener tu rama actualizada
+```bash
+# Si estás trabajando en una rama larga
+git checkout main
+git pull upstream main
+git checkout tu-rama
+git rebase main
+```
+
+## 📁 Estructura de Remotes
+
+Tu fork tiene configurado:
+- `origin` → https://github.com/cocosar/mcp-server.git (tu fork)
+- `upstream` → https://github.com/browserstack/mcp-server.git (original)
+
+Verificar con:
+```bash
+git remote -v
+```
+
+## ⚠️ Reglas Importantes
+
+1. **NO hagas push a main directamente** - Usa ramas
+2. **Sincroniza antes de cada sesión de trabajo** - Evita conflictos
+3. **Una rama = Una feature** - Mantén los PRs enfocados
+4. **Revisa el estado antes de commitear** - Usa `git status`
+
+## 🔧 Comandos Útiles
+
+```bash
+# Ver estado
+git status
+
+# Ver historial
+git log --oneline --graph
+
+# Ver qué cambió
+git diff
+
+# Cambiar de rama
+git checkout nombre-rama
+
+# Listar ramas
+git branch -a
+
+# Eliminar rama local
+git branch -d nombre-rama
+
+# Forzar actualización desde upstream (cuidado!)
+git reset --hard upstream/main
+```
+
+## 📌 Checklist antes de crear PR
+
+- [ ] Sincronicé con upstream (`git fetch upstream`)
+- [ ] Creé rama nueva desde main actualizado
+- [ ] Hice los cambios necesarios
+- [ ] Probé que funciona (`npm run build`)
+- [ ] Commitee con mensaje descriptivo
+- [ ] Push a mi fork
+- [ ] Creé PR desde GitHub (desde mi rama al main de browserstack/mcp-server)
+
+## 🆘 Solución de Problemas
+
+### Si hay conflictos al mergear:
+```bash
+git status  # Ver archivos en conflicto
+# Editar archivos para resolver
+git add .
+git commit -m "resolve: conflictos de merge"
+```
+
+### Si necesitas descartar cambios:
+```bash
+git checkout -- .  # Descarta cambios no commiteados
+git reset --hard HEAD  # Vuelve al último commit
+```
+
+### Si tu rama está desactualizada:
+```bash
+git checkout main
+git pull upstream main
+git checkout tu-rama
+git rebase main
+# Si hay conflictos, resolverlos y luego:
+git rebase --continue
+```

sync-upstream.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# sync-upstream.sh - Sincroniza tu fork con el repo original de BrowserStack
+
+echo "🔄 Sincronizando fork con upstream..."
+
+# Guardar cambios locales si hay
+echo "💾 Guardando cambios locales..."
+git stash
+
+# Cambiar a main
+git checkout main
+
+# Obtener cambios del upstream (repo original)
+echo "⬇️  Obteniendo cambios de browserstack/mcp-server..."
+git fetch upstream
+
+# Merge de upstream/main a tu main local
+echo "🔀 Mergeando cambios..."
+git merge upstream/main
+
+# Push a tu fork en GitHub
+echo "⬆️  Subiendo a tu fork..."
+git push origin main
+
+# Restaurar cambios locales si había
+echo "📤 Restaurando cambios locales..."
+git stash pop
+
+echo "✅ Sincronización completada!"
+echo ""
+echo "Tu fork ahora está actualizado con el repo original."