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.
Índice
- ¿Qué es pstack?
- Instalación
- Primeros pasos (2 pasos)
- El núcleo: /poteto-mode
- Los 23 playbooks
- Lista completa de skills
- Subagentes
- Los 24 principios
- Personalízalo a tu estilo
- Preguntas frecuentes
¿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 —
pstackreú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.
/add-plugin pstackPrimeros pasos (2 pasos)
- 1Configura modelos y presupuesto de razonamiento
/setup-pstackElige tu presupuesto de razonamiento (reasoning budget) y qué modelo usar para cada rol (código, criterio y panel de revisión).
- 2Ejecuta tu primera tarea guiada
/poteto-modeSi 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
- Selecciona
/poteto-modeen el menú/y escribe tu tarea a continuación. - El modo detecta el playbook adecuado y construye una lista de tareas con los pasos a seguir.
- Enruta hacia otros skills cuando hace falta y devuelve respuestas limpias y fáciles de leer.
/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./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
- 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
autonomous runUn 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-fullVeredictos 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)
orchestrateDirige 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.
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
| Subagente | Descripció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-protocolCorePriorizar el cambio mínimo y la eliminación de código.
foundational-thinkingCoreDiseñar tipos y estructuras de datos antes que la lógica.
redesign-from-first-principlesCoreRediseñar como si el requisito existiera desde el día 1, sin parches.
attack-the-premiseCoreSi dos arreglos bajo la misma premisa fallan en el mismo punto, cuestiona la premisa.
subtract-before-you-addCoreEliminar código muerto y duplicidad antes de construir encima.
minimize-reader-loadCoreReducir capas entre pregunta y respuesta y estado oculto para quien lee.
outcome-oriented-executionCoreConverger hacia la arquitectura objetivo en migraciones y reescrituras.
experience-firstCoreElegir el disfrute del usuario sobre la comodidad de implementación.
exhaust-the-design-spaceCoreComparar 2–3 prototipos rivales antes de decidir.
build-the-leverCoreCrear scripts o herramientas reutilizables en lugar de repetir trabajo manual.
model-the-domainArquitecturaCodificar el dominio en la estructura en vez de dispersar condicionales.
boundary-disciplineArquitecturaValidar en los bordes del sistema y mantener la lógica interna como funciones puras.
type-system-disciplineArquitecturaHacer irrepresentables los estados imposibles y parsear entradas externas en el borde.
make-operations-idempotentArquitecturaConverger al mismo estado final sin importar ejecuciones parciales previas.
migrate-callers-then-delete-legacy-apisArquitecturaMigrar los llamadores y borrar la API antigua en la misma oleada.
separate-before-serializing-shared-stateArquitecturaEliminar estado compartido primero; serializar solo si un único escritor es invariante.
prove-it-worksVerificaciónDemostrar con resultados reales, no solo con 'compila'.
fix-root-causesVerificaciónRastrear el fallo hasta el primer punto erróneo del sistema y corregirlo allí.
sequence-verifiable-unitsVerificaciónDividir en unidades pequeñas verificables e ir validando en orden.
test-behavior-not-implementationVerificaciónAsertar lo que el usuario observa, no detalles internos.
explain-the-numberVerificaciónIdentificar factores limitantes y descartar mediciones erróneas antes de reportar cifras.
guard-the-context-windowDelegación y metaDelegar trabajo pesado a subagentes y conservar solo resúmenes en el hilo principal.
never-block-on-the-humanDelegación y metaAvanzar, mostrar resultados y pedir confirmación solo ante acciones irreversibles.
encode-lessons-in-structureDelegación y metaConvertir 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-moderefleja el estilo del autor,/automate-meanaliza tus transcripciones recientes y genera un borrador<tu-nombre>-modeadaptado a tu forma real de trabajar.
Preguntas frecuentes
P1. ¿Qué queda fuera de pstack?
P2. ¿Por qué no hay un skill dedicado de planificación?
P3. ¿Funciona con Cursor automations?
P4. ¿Puedo modificarlo o extenderlo?
P5. No sé por dónde empezar.
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.