CommunityPesquisa e Análise de Dadosgithub.com

pax-k/build-right

Habilidades independentes de agente que transformam uma ideia vaga de aplicativo em execução de IA baseada em evidências.

O que é build-right?

Este conjunto de habilidades auxilia agentes de IA a transformar ideias abstratas de aplicativos em tarefas acionáveis com validação rigorosa baseada em evidências. Ao contrário de fluxos de trabalho puramente generativos, o Build Right impõe um ciclo disciplinado de execução: uma tarefa por vez, verificação do estado atual, alterações mínimas, verificação em camadas e atualização do rastreador. Ele é agnóstico em relação ao agente (funciona com Claude Code, Cursor, Codex e outros) e se baseia em um conjunto de documentos de referência (workflow, gates, evidências, princípios de engenharia) para garantir que cada decisão seja apoiada por fatos. Os principais mecanismos incluem um resolvedor de estado somente leitura, um auxiliar de execução, contratos de evidências e regras de portão que impedem que o agente prossiga para a próxima tarefa a menos que todos os pré-requisitos (fundador, estado externo, verificação) sejam atendidos. O resultado é um caminho de desenvolvimento previsível e auditável, adequado para sprints de produto reais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add pax-k/build-right

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Build Right Execução

Use esta habilidade após o trabalho de pré-execução ter produzido verdade do produto, escopo MVP, regras de operação e uma fila de tarefas executável.

Regra central:

Faça uma tarefa.
Comprove o estado atual.
Altere de forma restrita.
Verifique com a evidência correta.
Atualize o rastreador.
Então passe para a próxima tarefa.

Leitura Obrigatória

  • Sempre leia references/workflow.md antes de agir.
  • Leia references/gates.md antes da seleção de tarefa, após a entrada da tarefa e antes de avançar para outra tarefa.
  • Leia references/review-and-delegation.md apenas quando os gatilhos de revisão se aplicarem, a revisão por subagente for útil ou alterações amplas de evidências/rastreador forem tocadas.
  • Leia references/evidence-contract.md antes de concluir ou atualizar uma tarefa.
  • Leia ../build-right-engineering-principles/references/principles.md antes da implementação ou revisão quando uma tarefa tocar em limites de arquitetura, APIs públicas, propriedade de pacotes, adaptadores de provedor, código gerado, semântica de erros, testes, observabilidade, segurança ou políticas aplicáveis.
  • Use assets/templates/task-template.md ao criar uma tarefa ausente ou dividir uma tarefa muito ampla.
  • Use scripts auxiliares empacotados apenas através da forma completa do comando Bun mostrada abaixo. Não dependa de aliases de PATH nem invoque nomes curtos como continue-check como comandos de shell.
  • Use o resolvedor de estado antes de selecionar uma tarefa ou avançar por uma fila. Relate e reconcilie sua decisão antes de continuar.
  • Use o auxiliar de execução para sinais determinísticos de tarefa, contrato e portões. Trate a saída do script como entrada para julgamento, não como autoridade.

Modo de Operação

  1. Execute o resolvedor de estado somente leitura quando disponível:

    bun <skill-path>/scripts/continue-check.ts --cwd <project> --format markdown --strict
    
  2. Relate as descobertas do resolvedor antes de selecionar trabalho:

    Decisão do resolvedor: <decisão>
    Confiança: <confiança>
    Próxima ação: <próxima ação>
    Próxima tarefa: <tarefa ou nenhuma>
    Portões bloqueadores: <portões ou nenhum>
    Acompanhamentos externos: <acompanhamentos ou nenhum>
    
  3. Siga a decisão do resolvedor antes de selecionar trabalho:

    • ask-founder: pergunte ou relate o portão de propriedade do fundador; não continue.
    • wait-external: relate o portão de estado externo; não continue.
    • create-blocker: crie ou proponha o menor bloqueador de propriedade da IA.
    • no-ready-task: pare e relate que nenhuma tarefa de propriedade da IA está pronta.
    • invalid-state: pare e reconcilie estado contraditório do rastreador/portão.
    • continue-active-task ou execute-task: selecione exatamente essa tarefa.
  4. Execute o auxiliar de execução somente leitura quando disponível:

    bun <skill-path>/scripts/execution-check.ts --cwd <project> --mode next-task --format markdown
    
  5. Leia a tarefa, rastreador de sprint/milestone, documentos de autoridade e instruções locais do agente.

  6. Imprima a entrada da tarefa:

    Tarefa ativa: <id ou caminho da tarefa>
    Pronto significa: <critérios de conclusão observáveis>
    Não-objetivos: <exclusões explícitas>
    Base de suposição: <reivindicado-pelo-fundador | inferido-pela-IA | suposição-de-prototipo | apoiado-por-evidencia-de-repositorio | apoiado-por-evidencia-publica | apoiado-por-evidencia-de-cliente>
    Reversibilidade: <fácil | moderada | difícil>
    Gancho de aprendizado: <como esta tarefa produzirá evidências>
    Fonte sob teste: <caminho local do repositório | caminho instalado | fonte do GitHub | tag de release | n/a>
    Evidência de base: <artefato ou comando>
    Escada de verificação: <verificações focadas -> mais amplas>
    Destino da evidência: <arquivo de tarefa ou arquivo de evidência>
    
  7. Execute o auxiliar de execução no modo task-contract ou all quando um caminho de tarefa existir, então reconcilie quaisquer campos ausentes antes de editar.

  8. Inspecione o estado atual do workspace antes de editar.

  9. Capture evidência de base.

  10. Implemente a menor alteração que satisfaça a tarefa.

  11. Verifique em camadas.

  12. Execute revisão por subagente quando um gatilho de revisão obrigatório se aplicar e ferramentas de subagente estiverem disponíveis. Se estiverem indisponíveis ou proibidas, registre a revisão ignorada e substitua a verificação antes de fechar.

  13. Registre evidências antes de marcar a tarefa como concluída.

  14. Atualize apenas o rastreador/documentos relevantes.

  15. Execute o comando completo do resolvedor de estado Bun e o auxiliar de execução no modo stop-gates antes de selecionar outra tarefa.

  16. Relate as descobertas do resolvedor novamente antes de decidir se outra tarefa é segura para selecionar.

  17. Pare em qualquer portão de fundador, estado externo, verificação falhada, tarefa desatualizada, incompatibilidade de fonte, conflito aberto, proprietário não-IA ou reivindicação de release. Não avance para a próxima tarefa até que o portão seja resolvido ou explicitamente convertido em uma tarefa pronta de propriedade da IA.

  18. Faça commit ou transferência de acordo com o workflow do projeto.

Regra de Não-Pronto

Se documentos de autoridade, escopo MVP, regras de execução ou arquivos de tarefa estiverem ausentes, não finja que a execução está pronta. Direcione o usuário para /build-right-preflight ou crie o menor bloqueador Sprint 0 necessário para estabelecer a superfície de execução ausente.

Tarefas de protótipo podem ser executadas a partir de prototype-assumption apenas quando reversibilidade, gancho de aprendizado e validação necessária antes da verdade do produto forem explícitos.

Para releases de habilidades/testes manuais, registre a fonte exata sob teste. Se a habilidade instalada ou invocada estiver desatualizada em relação à fonte da habilidade local do repositório, marque o teste como partial-needs-rerun e não avance os portões de release para pronto.

Regra de Escopo

Não amplie o escopo silenciosamente. Se a tarefa revelar trabalho não relacionado, crie um issue de acompanhamento e continue apenas dentro do limite da tarefa selecionada.

Portão de Parada/Pergunta

Após cada tarefa, verifique se o próximo passo é verdadeiramente de propriedade da IA e está pronto. Pare e pergunte ou relate o bloqueador quando o próximo passo exigir:

  • decisões de produto, posicionamento, comprador/usuário ou MVP de propriedade do fundador
  • propriedade de tarefa pronta ou ativa que não é IA
  • conflitos abertos em docs/conflicts.md
  • descoberta externa, indexação de busca, publicação, segredos, serviços pagos ou acesso de produção
  • verificação falhada, estado de tarefa desatualizado, incompatibilidade de fonte ou evidência ambígua
  • revisão por subagente obrigatória que foi ignorada sem um substituto equivalente

Continuar por uma fila preparada é permitido apenas enquanto cada próxima tarefa estiver pronta, for de propriedade da IA, apoiada por evidências e não bloqueada por um desses portões.

Selo de Status Visível ao Usuário

Termine cada resposta final com exatamente um bloco de selo de status:

✅ [DONE] Status: DONE
Decisão: <decisão/resultado>
Próxima ação: <próxima ação ou nenhuma>
Precisa de entrada do usuário: <nenhuma | pergunta concisa>
Bloqueado por: <nenhum | bloqueador>

Use este mapa de status:

  • ✅ [DONE] Status: DONE para uma tarefa concluída com evidências, verificação e atualizações do rastreador.
  • 🟢 [GREEN] Status: ALL GREEN para execute-task ou continue-active-task antes do início da implementação.
  • 🟡 [YELLOW] Status: NEEDS INPUT para ask-founder.
  • 🟠 [ORANGE] Status: NEEDS WORK para trabalho de acompanhamento de propriedade da IA que ainda não é uma tarefa de execução pronta.
  • 🔵 [BLUE] Status: WAITING EXTERNAL para wait-external, publicação, indexação, credenciais, serviços pagos, acesso de produção ou estado de terceiros.
  • 🔴 [RED] Status: BLOCKED para create-blocker, no-ready-task, invalid-state, conflitos abertos, verificação falhada, fonte desatualizada/incompatível, propriedade de tarefa não-IA ou revisão obrigatória ignorada sem substituto.

Habilidades Relacionadas