p9

Visión general de la skill p9

Para qué sirve p9

p9 es una skill con enfoque de tech lead para Agent Orchestration. En lugar de escribir código directamente, la skill p9 convierte un objetivo de proyecto en prompts de ejecución para otros agentes, especialmente un equipo P8. Su función principal es la delegación: aclarar el alcance, dividir el trabajo, asignar responsabilidades y empujar la entrega mediante prompts en vez de implementar por sí misma.

Quién debería usar p9

Usa p9 si estás coordinando varios agentes, gestionando una funcionalidad amplia o necesitas una descomposición clara de tareas antes de empezar la ejecución. Encaja con usuarios que buscan una capa de planificación y orquestación por encima de los agentes de código, no con quienes quieren un generador de código.

El trabajo real que resuelve

El valor práctico de p9 está en reducir el caos cuando una tarea es demasiado grande para un solo prompt o un solo agente. Si necesitas dividir una petición en frentes paralelos, definir handoffs o mantener a un equipo alineado en formato de salida y restricciones, p9 ofrece una estructura inicial más sólida que un prompt genérico del tipo “planifica este proyecto”.

Qué hace diferente a p9

Lo que distingue a p9 es la disciplina de rol. La skill p9 se mantiene explícitamente en modo manager: redacta prompts de tareas y coordina agentes P8, pero no actúa ella misma como agente de implementación. Ese límite importa porque mantiene la planificación más limpia y hace que la delegación posterior sea más fácil de auditar.

Qué conviene saber antes de instalar p9

Esta skill es ligera dentro del repositorio. El SKILL.md visible apunta a documentos de protocolo adicionales como references/p9-protocol.md y references/agent-team.md, pero esos archivos no aparecen en el árbol proporcionado. Eso significa que p9 se entiende bien a alto nivel, aunque algunos detalles de ejecución pueden depender del sistema más amplio tanweai/pua y de la skill base /pua.

Cómo usar la skill p9

Contexto de instalación de p9

El comando base de instalación usado en esta familia de repositorios es:

npx skills add tanweai/pua --skill p9

Como p9 parece apoyarse en convenciones compartidas de /pua, conviene tratarla como parte de un sistema de skills más amplio y no como un archivo de prompt totalmente autónomo.

Lee primero este archivo de p9

Empieza por:

• skills/p9/SKILL.md

Después revisa el repositorio principal para entender el comportamiento compartido y localizar los archivos de protocolo que la skill referencia y que aquí no aparecen:

• instrucciones de la skill base /pua
• references/p9-protocol.md
• references/agent-team.md

Si esos archivos de apoyo no están disponibles en tu contexto de instalación, asume que tendrás que reconstruir manualmente parte del flujo de trabajo.

Qué entrada necesita p9

p9 funciona mejor cuando le das entradas de nivel orquestación, no solo una petición de funcionalidad. Entre las entradas útiles están:

• el objetivo del producto o del repositorio
• el estado actual del proyecto
• los roles de equipo o agentes disponibles
• restricciones como deadline, stack, tolerancia al riesgo y estándares de revisión
• qué debe paralelizarse y qué debe mantenerse secuencial
• los entregables esperados

Sin esos detalles, p9 puede seguir descomponiendo el trabajo, pero los prompts de tareas resultantes serán más genéricos.

Convierte un objetivo difuso en una petición lista para p9

Entrada débil:

Build user auth for my app.

Uso de p9 más sólido:

Use p9 for Agent Orchestration. We need to add email/password auth to a Next.js app with Prisma and PostgreSQL. We have 3 implementation agents available. Split work into parallel tracks where safe, define dependencies, create task prompts for each agent, and include acceptance criteria, shared constraints, and integration checkpoints.

La segunda versión le da a p9 suficiente estructura para asignar trabajo en vez de limitarse a reformular la funcionalidad.

Qué debería producir p9

Una buena salida de p9 debería incluir:

• un objetivo bien acotado
• descomposición de tareas
• asignación de rol o agente
• instrucciones listas para usar como prompt para cada agente aguas abajo
• restricciones y umbrales de calidad
• checkpoints de integración

La fuente menciona explícitamente “Task Prompts” y “P8 team delivery”, así que el criterio de éxito no es si p9 resuelve la tarea por sí sola, sino si crea prompts ejecutables para otros.

Mejor flujo de trabajo para usar p9

Un flujo práctico es:

1. Dale a p9 el objetivo del proyecto y las restricciones operativas.
2. Pídele que identifique workstreams y dependencias.
3. Haz que redacte prompts de tarea específicos por agente.
4. Revisa si faltan criterios de aceptación, hay huecos de ownership o riesgos de integración.
5. Envía esos prompts a agentes de código como ejecutores de estilo P8.
6. Devuelve los resultados a p9 para reconciliación, repriorización o planificación del siguiente paso.

Aquí es donde p9 supera a un prompt genérico de planificación: está pensada para situarse por encima de los agentes de ejecución.

Cuándo invocar p9 en vez de una skill de código

Usa p9 cuando:

• el trabajo abarca varios archivos o sistemas
• necesitas varios agentes en paralelo
• los handoffs importan
• el proyecto requiere secuenciación y supervisión
• el problema principal es la ambigüedad, la coordinación o el diseño de prompts

No uses p9 cuando solo quieres que un agente escriba rápidamente un parche pequeño.

Patrón de prompt práctico para la skill p9

Una plantilla fiable es:

Use p9 skill as tech lead. Do not write code. Break this goal into agent-executable task prompts for a P8 team. Include scope, owner, inputs, outputs, constraints, dependencies, and acceptance criteria. Goal: ... Context: ... Available agents: ... Constraints: ... Done means: ...

Este prompt refuerza el comportamiento central documentado en SKILL.md: modo manager, redacción de prompts y nada de código directo.

Límites de p9 que afectan la adopción

La principal advertencia de adopción es la dependencia de protocolos no visibles. SKILL.md hace referencia a documentos externos y a un modelo de comportamiento base de /pua, incluidas “three red lines” y un protocolo de narración, pero esos detalles no están expuestos aquí. Si tu plataforma solo importa el archivo de la skill, quizá necesites definir tus propias reglas operativas para calidad de delegación, escalado y seguridad.

Qué comprobar tras la primera ejecución de p9

Después de que p9 genere un plan, verifica que:

• cada tarea tenga un owner claro
• las dependencias estén explícitas
• las restricciones compartidas se repitan en los sub-prompts
• la integración y las pruebas no queden huérfanas
• ninguna tarea le pida accidentalmente a p9 que programe

Estas comprobaciones mejoran de forma tangible la calidad de la salida porque los fallos de orquestación suelen venir de handoffs vagos, no de una mala planificación de alto nivel.

Preguntas frecuentes sobre la skill p9

¿p9 es una skill de código?

No. La skill p9 está planteada explícitamente como un modo manager o tech lead. Escribe prompts y coordina a un equipo P8 en lugar de implementar código por sí misma.

¿p9 va bien para principiantes?

Sí, si tu problema es de coordinación más que de sintaxis de código. Pero los principiantes deben tener claro que p9 no es un atajo para la implementación. Sigues necesitando agentes aguas abajo o tu propio flujo de ejecución.

¿Cuándo es mejor p9 que un prompt normal de planificación?

p9 es mejor cuando quieres prompts de tarea reutilizables, separación de roles y coordinación multiagente. Un prompt normal puede darte un plan; p9 está orientada a producir unidades de ejecución delegables.

¿Cuándo no debería usar p9?

Evita p9 para tareas pequeñas y autocontenidas, arreglos urgentes de un solo archivo o situaciones en las que un único agente de código potente pueda terminar el trabajo más rápido de lo que una capa de management puede organizarlo.

¿p9 funciona fuera del ecosistema PUA?

Parcialmente. La idea de orquestación de alto nivel es portable, pero la skill parece diseñada alrededor de agentes P8 y de las reglas base de /pua. Si usas otra pila de agentes, cuenta con hacer cierta adaptación.

¿Qué significa realmente “p9 for Agent Orchestration”?

Significa que p9 resulta más útil como capa de coordinación por encima de agentes de ejecución. Su valor no está en la generación en bruto; su valor está en crear prompts más claros, una división del trabajo más limpia y una entrega multiagente más controlada.

Cómo mejorar la skill p9

Dale a p9 contexto suficiente para decidir

La forma más rápida de mejorar la salida de p9 es aportar el contexto de gestión que pediría un tech lead: alcance, riesgos, arquitectura, agentes disponibles, deadlines y restricciones no negociables. p9 se vuelve más potente cuanto más concreto sea el problema de coordinación.

Pide campos explícitos en cada prompt de tarea de p9

Si la primera salida se siente poco estructurada, pide un esquema fijo para cada tarea delegada, por ejemplo:

• objetivo
• owner
• entradas
• archivos necesarios
• restricciones de implementación
• entregable
• criterios de aceptación
• notas de dependencias

Esto convierte a p9 de “planificador” en “empaquetador de prompts”.

Evita el principal modo de fallo de p9

El fallo más común es una descomposición superficial: las tareas suenan ordenadas, pero no son ejecutables. Para evitarlo, pídele a p9 que haga que cada tarea sea accionable de forma independiente por otro agente, sin necesidad de aclaraciones adicionales.

Mejora el uso de p9 con mejores restricciones

Restricciones útiles para añadir:

• versiones de stack y framework
• archivos o directorios dentro del alcance
• estándares de código
• expectativas de testing
• puertas de revisión
• qué no debe cambiar

Estos detalles reducen retrabajo cuando los agentes aguas abajo interpretan los prompts de manera distinta.

Itera sobre la integración de p9, no solo sobre la descomposición

Después de que p9 cree los prompts de tarea, haz una segunda pasada con esta petición:

Review this plan for integration risk, duplicated work, hidden dependencies, and missing validation steps.

A menudo esto mejora más la entrega real que pedir una descomposición todavía más fina.

Adapta p9 si faltan las referencias de soporte

Si los archivos de protocolo referenciados no están disponibles, define tus propias reglas locales antes de usar p9 a escala:

• p9 nunca escribe código de producción
• toda tarea delegada debe incluir criterios de aceptación
• una tarea debe ser responsable de la integración
• una tarea debe ser responsable de la verificación
• las dependencias no resueltas deben aflorarse pronto

Esa adaptación hace que la skill p9 sea más usable incluso sin el contexto completo del repositorio.