hafuture

Guía de pstack: El plugin de Cursor para que la IA escriba código rápido y bien hecho

Guía completa del plugin pstack para Cursor y Claude Code: cómo instalarlo, usar /poteto-mode, elegir entre sus 23 playbooks, skills y los 24 principios de ingeniería.

CursorClaude CodeAIpstackDeveloper Tools

Índice


¿Qué es pstack?

  • Autor — poteto, ingeniero que ha trabajado con millones de líneas de código en Meta, Netflix y Cursor, y que actualmente desarrolla el React Compiler en el equipo central de React.
  • Por qué nació — Compartía la preocupación de que la IA genera demasiado código basura (slop), pero no quiso resignarse. Aumentar la velocidad sacrificando la calidad no es el objetivo.
  • La solución — pstack reúne y publica exactamente los skills que su autor utiliza a diario en Cursor. La meta no es generar más código, sino lo contrario: menos código, pero de mayor calidad.

Instalación

Selecciona tu entorno para copiar el comando de instalación.

bash
/add-plugin pstack
Una sola línea en el chat de Cursor y listo.

Primeros pasos (2 pasos)

  1. 1
    Configura modelos y presupuesto de razonamiento/setup-pstack

    Elige tu presupuesto de razonamiento (reasoning budget) y qué modelo usar para cada rol (código, criterio y panel de revisión).

  2. 2
    Ejecuta tu primera tarea guiada/poteto-mode

    Si es tu primera vez, la guía integrada te acompaña en una tarea real de principio a fin (instalación → prompt → verificación → ejecución nocturna). Si dudas qué skill usar, escribe /poteto-help.

Configuración de modelos por defecto

Las tareas de código (features, refactorización, bugs, rendimiento, hillclimb), redacción y criterio corren con Opus 5.5, mientras que los cambios más complejos los asume Fable 5.2. El panel de revisión por defecto combina Fable 5.2 / Opus 5.5 / Gemini 4 Carbon (todo configurable desde /setup-pstack).


El núcleo: /poteto-mode

/poteto-mode es la puerta de entrada principal de pstack.

Cómo se usa

  1. Selecciona /poteto-mode en el menú / y escribe tu tarea a continuación.
  2. El modo detecta el playbook adecuado y construye una lista de tareas con los pasos a seguir.
  3. Enruta hacia otros skills cuando hace falta y devuelve respuestas limpias y fáciles de leer.
Ejemplo 1 — Reproducir, corregir y verificar un bug
/poteto-mode Este PR tiene un bug sutil donde el scroll se desliza cada 750ms sin hacer nada.
Reprodúcelo primero, corrígelo y verifícalo.
Ejemplo 2 — Ejecución nocturna y merge de stack
/poteto-mode Me voy a dormir. Fusiona el stack aunque el CI parpadee. Quiero todo en main para mañana.

Los 23 playbooks

Si quieres anticipar qué playbook elegirá /poteto-mode, filtra por grupo o busca directamente por tu situación actual.

Explorador rápido de los 23 playbooks

Buscador de playbooks23
  • Hay un bug visible1.º· 1. Modificar código

    Reproduce el fallo, halla la causa raíz y corrige con evidencia en tiempo de ejecución. Si el síntoma está activo pero no se reproduce, pasa a runtime forensics.

    1.ª opción:bug fixAlternativa:runtime forensics
  • Hay que crear una función nueva1.º· 1. Modificar código

    Parte de estructuras de datos claras para crear o cambiar comportamiento. Si hay dudas de diseño, usa prototype primero.

    1.ª opción:featureAlternativa:prototype
  • Misma funcionalidad, mejor estructura1.º· 1. Modificar código

    Cambia la estructura interna manteniendo intacto el comportamiento observable.

    1.ª opción:refactoring
  • Va lento o con tirones2.º· 1. Modificar código

    Investiga lentitud medida y optimiza respecto a una línea base (baseline). Si ya tienes un archivo de perfilado, usa trace forensics.

    1.ª opción:perfAlternativa:trace forensics
  • Elevar una métrica concreta hacia un objetivo2.º· 1. Modificar código

    Itera con rigor científico: hipótesis → medición antes/después → 1 commit por mejora aprobada.

    1.ª opción:hillclimb
  • Resolver dudas de diseño a bajo costo3.º (condicional)· 1. Modificar código

    Bocetos desechables para experimentar antes de escribir el código definitivo.

    1.ª opción:prototype
  • Coincidencia visual píxel a píxel entre implementaciones3.º (condicional)· 1. Modificar código

    Solo cuando se exige paridad visual exacta en migraciones o revisiones de diseño.

    1.ª opción:visual parity
  • Síntoma activo en vivo difícil de reproducir1.º· 2. Diagnóstico

    Diagnostica fugas de memoria, CPU en reposo o glitches mediante instrumentación en vivo.

    1.ª opción:runtime forensics
  • Artefactos de perfilado ya capturados2.º· 2. Diagnóstico

    Analiza archivos cpuprofile, trace, spindump o heap snapshots ya recolectados.

    1.ª opción:trace forensics
  • Entender o revisar algo existenteÚnico· 3. Investigación

    Responde preguntas sin editar código ('¿Cómo funciona X?', '¿Por qué se diseñó así?'). Si se centra en el '¿por qué?', usa /why.

    1.ª opción:investigationAlternativa:/why
  • PR bloqueado por revisión, CI o conflictos1.º· 4. PRs y merges

    Lleva un PR o stack hasta estar listo para merge resolviendo conflictos, hilos y fallos de CI.

    1.ª opción:babysitAlternativa:shipping
  • Aterrizar un stack en verde de forma segura1.º· 4. PRs y merges

    Verifica un stack en verde de forma independiente y lo aterriza en orden en GitHub/origin.

    1.ª opción:shipping
  • Procesar muchos PRs independientes hasta merge2.º (alto volumen)· 4. PRs y merges

    Asigna un dueño por PR y un enjambre de verificación independiente hasta completar el merge.

    1.ª opción:autopilot-full
  • Apilar PRs verificados para revisión humana2.º (alto volumen)· 4. PRs y merges

    Como autopilot-full pero sin ejecutar el merge final; deja el stack verificado para revisión manual.

    1.ª opción:autopilot-stack
  • Abrir un PR limpio al terminar una tareaAutomático· 4. PRs y merges

    Crea PRs con commits pequeños ordenados, títulos convencionales y resumen claro.

    1.ª opción:opening a PR
  • Terminar un trabajo largo mientras no estás1.º· 5. Ejecución autónoma

    Completa una tarea larga de principio a fin sin detenerse. Si abarca varios días y múltiples PRs, usa orchestrate.

    1.ª opción:autonomous runAlternativa:orchestrate
  • Proyecto de varios días con stacks y subagentes2.º (gran escala)· 5. Ejecución autónoma

    Coordina múltiples áreas, stacks de PRs y subagentes desde un único chat coordinador.

    1.ª opción:orchestrate
  • Estructurar un trabajo complejo por fases3.º (diseño)· 5. Ejecución autónoma

    Planificación previa para dividir trabajos extensos en múltiples fases o PRs apilados.

    1.ª opción:multi-phase plan
  • Retomar el trabajo de ayer1.º· 6. Ciclo de vida

    Retoma y continúa el trabajo dejado por un agente anterior. Para pausar limpiamente antes, usa pause safely.

    1.ª opción:session pickupAlternativa:pause safely
  • Pausar un trabajo en curso sin perder contexto2.º· 6. Ciclo de vida

    Pausa de forma limpia una tarea en curso para reanudarla después (pareja de session pickup).

    1.ª opción:pause safely
  • Liberar disco de worktrees antiguos3.º (ocasional)· 6. Ciclo de vida

    Limpia worktrees fusionados/descartados y simuladores iOS antiguos para recuperar espacio.

    1.ª opción:worktree cleanup
  • Crear o modificar archivos SKILL.md1.º· 7. Meta-trabajo

    Diseña o actualiza definiciones de skills en formato SKILL.md.

    1.ª opción:authoring a skill
  • Medir el impacto de cambios en skills o prompts2.º· 7. Meta-trabajo

    Evalúa a ciegas cómo afectan los cambios de skills o prompts al comportamiento del agente.

    1.ª opción:eval

Comparativa rápida: autonomous run vs autopilot-full vs orchestrate

3 preguntas para decidir — haz clic en tu caso
autonomous run

Un objetivo y una condición de salida clara

“You own the exit condition”

Unidad de trabajo
1 objetivo + 1 condición de salida verificable
Ejecución
El mismo agente itera y edita directamente
Estructura PR
Sin restricción estructural
Verificación
Comprueba la condición en cada ciclo
Duración
Horas dentro de una sesión con /loop
autopilot-full

Veredictos del coordinador, PRs por dueño

“You own the verdicts, never the PRs”

Unidad de trabajo
Cola de PRs independientes ya definida
Ejecución
1 dueño por PR + enjambre verificador independiente
Estructura PR
Paralelos sobre trunk, nunca apilados
Verificación
Enjambre completo + verificación en vivo de la UI
Duración
Según tamaño de la cola (horas a 1 día)
orchestrate

Dirige el programa, no escribas el código

“You run the program, never the code”

Unidad de trabajo
Múltiples áreas y PRs apilados (incluye orden y dependencias)
Ejecución
Coordinador → subcoordinadores → workers (hasta 3 niveles)
Estructura PR
Permite stacks y gestión de dependencias
Verificación
Verificadores de distinta familia de modelos + lectura directa de diffs
Duración
Varios días, decenas o cientos de subagentes

Lista completa de skills

Haz clic en cualquier comando para copiarlo al portapapeles.

Haz clic en un comando para copiarlo

Ayuda e inicio

Comprensión

Diseño y paralelismo

Verificación y revisión

Crear skills de verificación

Redacción y mantenimiento

Otros


Subagentes

SubagenteDescripción
subagent_type: "poteto-agent"Wrapper interno usado por poteto-mode. Sustituirlo por un agente generalPurpose omite la lectura de reglas y reduce la calidad.
subagent_type: "comment-sicko"Revisor de comentarios en modo solo lectura. Normalmente se invoca a través de /no-comments.

Los 24 principios

/poteto-mode aplica estos 24 principios según la naturaleza de la tarea. Filtra por categoría o busca por nombre:

laziness-protocolCore

Priorizar el cambio mínimo y la eliminación de código.

foundational-thinkingCore

Diseñar tipos y estructuras de datos antes que la lógica.

redesign-from-first-principlesCore

Rediseñar como si el requisito existiera desde el día 1, sin parches.

attack-the-premiseCore

Si dos arreglos bajo la misma premisa fallan en el mismo punto, cuestiona la premisa.

subtract-before-you-addCore

Eliminar código muerto y duplicidad antes de construir encima.

minimize-reader-loadCore

Reducir capas entre pregunta y respuesta y estado oculto para quien lee.

outcome-oriented-executionCore

Converger hacia la arquitectura objetivo en migraciones y reescrituras.

experience-firstCore

Elegir el disfrute del usuario sobre la comodidad de implementación.

exhaust-the-design-spaceCore

Comparar 2–3 prototipos rivales antes de decidir.

build-the-leverCore

Crear scripts o herramientas reutilizables en lugar de repetir trabajo manual.

model-the-domainArquitectura

Codificar el dominio en la estructura en vez de dispersar condicionales.

boundary-disciplineArquitectura

Validar en los bordes del sistema y mantener la lógica interna como funciones puras.

type-system-disciplineArquitectura

Hacer irrepresentables los estados imposibles y parsear entradas externas en el borde.

make-operations-idempotentArquitectura

Converger al mismo estado final sin importar ejecuciones parciales previas.

migrate-callers-then-delete-legacy-apisArquitectura

Migrar los llamadores y borrar la API antigua en la misma oleada.

separate-before-serializing-shared-stateArquitectura

Eliminar estado compartido primero; serializar solo si un único escritor es invariante.

prove-it-worksVerificación

Demostrar con resultados reales, no solo con 'compila'.

fix-root-causesVerificación

Rastrear el fallo hasta el primer punto erróneo del sistema y corregirlo allí.

sequence-verifiable-unitsVerificación

Dividir en unidades pequeñas verificables e ir validando en orden.

test-behavior-not-implementationVerificación

Asertar lo que el usuario observa, no detalles internos.

explain-the-numberVerificación

Identificar factores limitantes y descartar mediciones erróneas antes de reportar cifras.

guard-the-context-windowDelegación y meta

Delegar trabajo pesado a subagentes y conservar solo resúmenes en el hilo principal.

never-block-on-the-humanDelegación y meta

Avanzar, mostrar resultados y pedir confirmación solo ante acciones irreversibles.

encode-lessons-in-structureDelegación y meta

Convertir lecciones en reglas de lint, checks o scripts, no solo texto.


Personalízalo a tu estilo

  • Cambiar modelos (/setup-pstack): Detecta los modelos disponibles y guarda el mapeo por rol.
  • Tu propio modo (/automate-me): Mientras /poteto-mode refleja el estilo del autor, /automate-me analiza tus transcripciones recientes y genera un borrador <tu-nombre>-mode adaptado a tu forma real de trabajar.

Preguntas frecuentes

P1. ¿Qué queda fuera de pstack?
/deslop, /autopilot, control-cli y control-ui forman parte de cursor-team-kit. Para /create-skill o el seguimiento de PRs, Cursor redirige al playbook babysit.
P2. ¿Por qué no hay un skill dedicado de planificación?
/poteto-mode planifica cuando es necesario, pero prioriza la validación rápida frente a la sobreplanificación. Si deseas planificar en detalle, combina pstack con el Plan Mode nativo de Cursor.
P3. ¿Funciona con Cursor automations?
Sí, copiando el pack en .cursor/automations/benny/ del repositorio destino para reproducir y corregir bugs con evidencia real de UI (exclusivo de Cursor; consulta FOR_AGENTS.md).
P4. ¿Puedo modificarlo o extenderlo?
Sí, tiene licencia MIT. Si editas la configuración para Claude Code, ejecuta node scripts/generate-pstack-harness-trees.mjs y haz commit de los archivos generados para que pase el CI.
P5. No sé por dónde empezar.
Usa /poteto-help para elegir herramienta o /sharpen si quieres refinar tu prompt.

Valida archivos JSON de configuración con Hafuture

Formatea y valida configuraciones JSON o prompts localmente en tu navegador, 100% privado y sin subir datos.

Abrir Formateador JSON