/arrancar

/arrancar — Preparar todo para empezar a trabajar

This command helps a non-technical user sync their repo, set up local dev, and start working. Communicate ALWAYS in casual Colombian Spanish (use "parce", "listo", "dale", "tranqui" naturally). Keep messages short, friendly, and non-technical. NEVER show raw git/npm output — translate everything to simple language.

First: Create task list for progress tracking

ALWAYS create tasks using TaskCreate so the user sees progress in the status line. Create these tasks immediately:

1. "Revisar estado del repo" (activeForm: "Revisando el repo...")
2. "Sincronizar con la última versión" (activeForm: "Sincronizando...")
3. "Crear rama de trabajo" (activeForm: "Creando rama...")
4. "Preparar entorno local" (activeForm: "Preparando entorno...")

Mark each task in_progress BEFORE starting it, and completed when done.

Step 1: Check current state

Mark task 1 as in_progress.

Run git status --porcelain to check for uncommitted changes.

• If there are uncommitted changes: Use AskUserQuestion to ask:

  • question: "Encontré cambios sin guardar de la última vez. ¿Qué hacemos con ellos?"
  • header: "Cambios"
  • options:
    • "Guardarlos aparte" (description: "Los guardo en una rama temporal por si los necesitas después")
    • "Descartarlos" (description: "Los borro y empezamos limpio — no se pueden recuperar")
  • If save: stash with git stash push -m "cambios-guardados-$(date +%Y%m%d)" or commit to temp branch
  • If discard: git checkout -- . && git clean -fd

• If clean: Continue silently.

Also check current branch. If on a feature branch (not main), use AskUserQuestion:

• question: "Estás en la rama ''. ¿Quieres seguir trabajando aquí o empezar algo nuevo?"
• header: "Rama"
• options:
  • "Seguir aquí" (description: "Continúo donde quedé la última vez")
  • "Empezar algo nuevo" (description: "Me paso a main y creo una rama nueva")
• If "Seguir aquí": pull latest, skip branch creation, jump to Step 4.

Mark task 1 as completed.

Step 2: Sync with latest main

Mark task 2 as in_progress.

git checkout main
git pull --rebase origin main

If pull fails due to conflicts:

"Hay unos cambios que chocan. Voy a arreglarlo, tranqui."

Try git rebase --abort and then git pull origin main (merge fallback). If still fails, explain simply and use AskUserQuestion to offer options.

Also run npm install if package-lock.json changed (check with git diff HEAD@{1} --name-only | grep package-lock).

Mark task 2 as completed.

Step 3: Create feature branch

Mark task 3 as in_progress.

If $ARGUMENTS is provided, use that as the description. Otherwise use AskUserQuestion:

• question: "¿En qué vas a trabajar hoy?"
• header: "Tarea"
• options:
  • "Arreglar algo que está roto" (description: "Un bug o algo que no funciona bien")
  • "Agregar algo nuevo" (description: "Una función, sección o contenido nuevo")
  • "Actualizar contenido" (description: "Cambiar textos, fotos o datos existentes")
• The user can also select "Other" to type a custom description.

From the user's choice, generate a branch name:

• "Arreglar..." → fix/<short-kebab-case>
• "Agregar..." → feat/<short-kebab-case>
• "Actualizar..." / "Cambiar..." → chore/<short-kebab-case>
• Default to feat/ if unclear

If user typed a custom description, derive the branch name from it.

git checkout -b <type>/<short-kebab-case-description>

Mark task 3 as completed.

Step 4: Set up local dev environment

Mark task 4 as in_progress.

Check if dependencies are installed:

ls node_modules/.package-lock.json 2>/dev/null

If not installed, run npm install and tell the user:

"Instalando lo que necesita la app... un momentico."

Then use AskUserQuestion to ask what they want to do:

• question: "¿Quieres que te abra la app en tu computador para ir viendo los cambios?"
• header: "Dev local"
• options:
  • "Sí, ábrela (Recomendado)" (description: "Abro la app en tu navegador para que veas los cambios en vivo")
  • "No, después la abro" (description: "Sigo trabajando sin ver la app por ahora")

If yes, start the dev server:

npm run dev

Tell the user:

"La app está corriendo en tu computador. Abre el navegador en la dirección que aparece arriba para verla."

Explain briefly about environments:

"📝 Dato útil: Hay tres versiones de la app:" "- Tu computador — lo que ves ahorita, solo tú lo ves" "- Vista previa — cuando hagas /listo, Vercel crea una versión de prueba online" "- La oficial — cuando Jairo apruebe, se publica automáticamente en laolibero.com"

Mark task 4 as completed.

Step 5: Confirm ready

Print a friendly confirmation:

"¡Listo parce! 🚀 Ya estás en la rama <branch> con todo actualizado." "" "Trabaja tranqui y cuando termines, escribe /listo y yo me encargo del resto."

Do NOT show any git commands or technical details to the user.