p9

Visão geral da skill p9

Para que serve a p9

A p9 é uma skill de Orquestração de Agentes com postura de tech lead. Em vez de escrever código diretamente, a skill p9 transforma um objetivo de projeto em prompts de execução para outros agentes, especialmente uma equipe P8. O trabalho central dela é delegar: esclarecer escopo, dividir o trabalho, atribuir responsabilidades e conduzir a entrega por meio de prompts, não da implementação em si.

Quem deve usar a p9

Use a p9 se você estiver coordenando múltiplos agentes, conduzindo uma feature maior ou precisar de uma decomposição limpa das tarefas antes da execução começar. Ela faz mais sentido para quem quer uma camada de planejamento e orquestração acima dos agentes de código, e não para quem busca um gerador de código.

O trabalho real que ela resolve

Na prática, o valor da p9 está em reduzir o caos quando uma tarefa é grande demais para um único prompt ou um único agente. Se você precisa quebrar uma solicitação em frentes paralelas, definir handoffs ou manter uma equipe alinhada quanto ao formato de saída e às restrições, a p9 oferece uma estrutura inicial mais forte do que um prompt genérico do tipo “planeje este projeto”.

O que diferencia a p9

O diferencial é a disciplina de papel. A skill p9 permanece explicitamente em modo gestor: ela escreve prompts de tarefa e coordena agentes P8, mas não atua como agente de implementação. Essa fronteira importa porque mantém o planejamento mais limpo e facilita a auditoria da delegação nas etapas seguintes.

O que saber antes de instalar

Essa skill é leve dentro do repositório. O SKILL.md visível aponta para documentos de protocolo adicionais, como references/p9-protocol.md e references/agent-team.md, mas esses arquivos não aparecem na árvore fornecida. Isso significa que a p9 é compreensível em alto nível, porém alguns detalhes de execução podem depender do sistema mais amplo tanweai/pua e da skill central /pua.

Como usar a skill p9

Contexto de instalação da p9

O comando-base de instalação usado por esta família de repositórios é:

npx skills add tanweai/pua --skill p9

Como a p9 parece depender de convenções compartilhadas de /pua, vale tratá-la como parte de um sistema de skills mais amplo, e não como um arquivo de prompt totalmente independente.

Leia este arquivo primeiro

Comece por:

• skills/p9/SKILL.md

Depois, verifique o repositório principal para entender comportamentos compartilhados e localizar arquivos de protocolo ausentes mencionados pela skill:

• instruções da skill central /pua
• references/p9-protocol.md
• references/agent-team.md

Se esses arquivos de apoio não estiverem disponíveis no seu contexto de instalação, espere reconstruir manualmente parte do fluxo de trabalho.

Que tipo de entrada a p9 precisa

A p9 funciona melhor quando você fornece insumos de nível de orquestração, não apenas um pedido de feature. Entradas úteis incluem:

• o objetivo do produto ou do repositório
• o estado atual do projeto
• os papéis da equipe ou dos agentes disponíveis
• restrições como prazo, stack, tolerância a risco e padrões de revisão
• o que deve rodar em paralelo e o que deve permanecer sequencial
• os entregáveis esperados

Sem esses detalhes, a p9 ainda consegue decompor o trabalho, mas os prompts de tarefa resultantes tendem a ficar genéricos.

Como transformar um objetivo vago em um pedido pronto para a p9

Entrada fraca:

Build user auth for my app.

Uso mais forte da p9:

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.

A segunda versão dá à p9 estrutura suficiente para distribuir o trabalho, em vez de apenas reformular a feature.

O que a p9 deve entregar

Uma boa saída da p9 deve incluir:

• um objetivo com escopo definido
• decomposição das tarefas
• atribuição de papel ou agente
• instruções prontas em formato de prompt para cada agente downstream
• restrições e critérios de qualidade
• checkpoints de integração

A fonte menciona explicitamente “Task Prompts” e “P8 team delivery”, então o critério de sucesso deve ser se a p9 cria prompts executáveis para outros agentes, e não se ela resolve a tarefa por conta própria.

Melhor fluxo de trabalho para usar a p9

Um fluxo prático é:

1. Passe para a p9 o objetivo do projeto e as restrições operacionais.
2. Peça que ela identifique frentes de trabalho e dependências.
3. Faça com que ela redija prompts de tarefa específicos por agente.
4. Revise em busca de critérios de aceite ausentes, lacunas de ownership ou riscos de integração.
5. Envie esses prompts para agentes de código, como executores no estilo P8.
6. Traga os resultados de volta para a p9 para conciliação, repriorização ou planejamento dos próximos passos.

É aqui que a p9 é mais forte do que um prompt genérico de planejamento: ela foi feita para ficar acima dos agentes de execução.

Quando acionar a p9 em vez de uma skill de código

Use a p9 quando:

• o trabalho abrange múltiplos arquivos ou sistemas
• você precisa de vários agentes em paralelo
• os handoffs importam
• o projeto exige sequenciamento e supervisão
• o problema principal é ambiguidade, coordenação ou desenho de prompts

Não use a p9 quando você só quer que um agente escreva rapidamente um patch pequeno.

Padrão de prompt prático para a skill p9

Um template confiável é:

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: ...

Esse prompt reforça o comportamento central documentado em SKILL.md: modo gestor, escrita de prompts e nada de codificação direta.

Limites que afetam a adoção da p9

A principal ressalva de adoção é a dependência de protocolos ocultos. O SKILL.md referencia documentos externos e um modelo de comportamento central de /pua, incluindo “three red lines” e um protocolo de narração, mas esses detalhes não estão expostos aqui. Se a sua plataforma importar apenas o arquivo da skill, talvez você precise definir suas próprias regras operacionais para qualidade de delegação, escalonamento e segurança.

O que verificar depois da primeira execução da p9

Depois que a p9 gerar um plano, confirme se:

• cada tarefa tem um responsável claro
• as dependências estão explícitas
• as restrições compartilhadas se repetem nos sub-prompts
• integração e testes não ficaram sem dono
• nenhuma tarefa pede acidentalmente para a p9 programar

Essas checagens melhoram materialmente a qualidade da saída, porque falhas de orquestração normalmente vêm de handoffs vagos, não de um planejamento ruim em alto nível.

FAQ da skill p9

A p9 é uma skill de código?

Não. A skill p9 é posicionada explicitamente como um modo de gestor ou tech lead. Ela escreve prompts e gerencia uma equipe P8, em vez de implementar código por conta própria.

A p9 é boa para iniciantes?

Sim, se o seu problema for coordenação e não sintaxe de código. Mas iniciantes precisam saber que a p9 não é um atalho para implementação. Você ainda vai precisar de agentes downstream ou de um fluxo próprio de execução.

Quando a p9 é melhor do que um prompt comum de planejamento?

A p9 é melhor quando você quer prompts de tarefa reutilizáveis, separação de papéis e coordenação entre múltiplos agentes. Um prompt comum pode até entregar um plano; a p9 foi pensada para produzir unidades de execução delegadas.

Quando eu não devo usar a p9?

Evite a p9 em tarefas pequenas e autocontidas, correções urgentes em um único arquivo ou situações em que um bom agente de código consiga concluir o trabalho mais rápido do que uma camada gerencial conseguiria organizá-lo.

A p9 funciona fora do ecossistema PUA?

Parcialmente. A ideia de orquestração em alto nível é portável, mas a skill parece ter sido desenhada em torno de agentes P8 e das regras centrais de /pua. Se você usa outra stack de agentes, espere fazer alguma adaptação.

O que “p9 for Agent Orchestration” realmente quer dizer?

Quer dizer que a p9 é mais útil como camada de coordenação acima dos agentes de execução. O valor dela não está em poder bruto de geração; está em criar prompts mais claros, uma divisão de trabalho mais limpa e uma entrega multiagente mais controlada.

Como melhorar a skill p9

Dê à p9 contexto em nível de decisão

A forma mais rápida de melhorar a saída da p9 é fornecer o contexto gerencial que um tech lead pediria: escopo, riscos, arquitetura, agentes disponíveis, prazos e restrições inegociáveis. A p9 fica mais forte à medida que o problema de coordenação se torna mais concreto.

Peça campos explícitos nos prompts de tarefa da p9

Se a primeira saída parecer solta, solicite um esquema fixo para cada tarefa delegada, como:

• objetivo
• responsável
• entradas
• arquivos necessários
• restrições de implementação
• entregável
• critérios de aceite
• notas de dependência

Isso transforma a p9 de “planejadora” em “empacotadora de prompts”.

Evite o principal modo de falha da p9

O modo de falha mais comum é a decomposição superficial: as tarefas parecem organizadas, mas não são executáveis. Para evitar isso, peça à p9 que torne cada tarefa acionável de forma independente por outro agente, sem precisar de esclarecimentos extras.

Melhore o uso da p9 com restrições melhores

Restrições úteis para acrescentar:

• versões da stack e dos frameworks
• arquivos ou diretórios dentro do escopo
• padrões de código
• expectativas de teste
• gates de revisão
• o que não pode mudar

Esses detalhes reduzem retrabalho quando agentes downstream interpretam os prompts de maneiras diferentes.

Itere na integração, não só na decomposição

Depois que a p9 criar os prompts de tarefa, faça uma pergunta de segunda passada:

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

Isso costuma melhorar mais a entrega real do que simplesmente pedir uma decomposição ainda mais fina.

Adapte a p9 se as referências de apoio estiverem ausentes

Se os arquivos de protocolo referenciados não estiverem disponíveis, defina suas próprias regras locais antes de usar a p9 em escala:

• a p9 nunca escreve código de produção
• toda tarefa delegada deve incluir critérios de aceite
• uma tarefa deve ser dona da integração
• uma tarefa deve ser dona da verificação
• dependências não resolvidas devem ser sinalizadas cedo

Essa adaptação torna a skill p9 mais utilizável mesmo sem o contexto completo do repositório.