Ir para o conteúdo
Promovaweb
Documentação do Specsfy

Specsfy O agente segue o que você aprovou por escrito.

O Specsfy é um método com CLI e skills para agentes de IA que guarda numa spec os requisitos, o plano e as tarefas de cada mudança. Na sessão seguinte, o agente lê a spec e continua de onde parou, sem você repetir a explicação.

Código aberto sob AGPL 3.0, mantido pela Promovaweb, com o repositório público no GitHub. Assuntos conferidos na versão 0.29.1.

Escolha uma etapa do método para ver como a spec acompanha o agente.
  1. Definição e execuçãoO agente consulta a definição aprovada para implementar a mudança.
  2. Uma spec por mudançaO plano e as tarefas ficam junto dos requisitos.
  3. Acompanhamento no ClickUpA spec pode ser vinculada à tarefa do projeto.
  4. CLI e skillsVocê distingue a atualização do programa da atualização do projeto.

O registro escrito de cada mudança feita com agentes

Um método com CLI e skills para relacionar o comportamento esperado do app ao plano, às tarefas e aos testes.

A sessão seguinte do agente começa pela spec

Uma conversa longa com um agente pode terminar sem registrar o comportamento que você aprovou. O Specsfy reúne essa definição numa spec dentro do repositório. O mesmo documento guarda os requisitos, o plano técnico e as tarefas da mudança, com referências aos testes.

A CLI instala o framework e oferece verificações sobre as especificações. As skills orientam o agente durante a definição, o planejamento e a implementação. Você continua participando das escolhas do produto e consegue comparar o resultado com o que ficou escrito.

Sem a spec, cada sessão recomeça a explicação do zero

  • Repetir a definição para outra sessão. A spec preserva o comportamento confirmado para o agente consultar ao retomar a mudança.
  • Encontrar um plano distante do requisito. O plano e as tarefas ficam no mesmo documento que descreve a função esperada do app.
  • Revisar uma alteração só pelo status. Os resultados dos testes são relacionados aos comportamentos da spec para apoiar a revisão.
  • Misturar uma ideia com trabalho autorizado. A Inbox preserva ideias. O backlog permite refiná-las antes de você escolher uma mudança para desenvolvimento.

Da definição à revisão, a mudança passa por quatro etapas

A spec acompanha o trabalho até a revisão, com verificações de cada etapa e retorno às definições quando o comportamento muda.

  1. DefiniçãoVocê e o agente descrevem a mudança e os exemplos do comportamento esperado.
  2. Plano e testesO agente relaciona as tarefas aos requisitos e prepara os testes na stack do app.
  3. ImplementaçãoO código é alterado e os resultados são reunidos para comparar o app com a especificação.
  4. RevisãoVocê confere a implementação e as comprovações registradas antes do aceite final.
Os gates verificam a preparação de cada etapa. Um checklist marcado não substitui o teste do comportamento descrito.
Entenda o fluxo de especificação

Funções desenvolvidas com agentes são o melhor uso da spec

  • Uma função desenvolvida com agentes. A definição escrita permite conferir se a alteração atende ao comportamento que você escolheu.
  • Uma mudança retomada em outra sessão. O documento preserva o plano e o estado do trabalho junto do código.

Quando você ainda quer apenas guardar a ideia

  • Uma observação sem implementação escolhida. A Inbox registra a observação sem exigir que ela vire uma spec ou autorizar alterações no app.

Lacunas de comportamento voltam para você responder

  • Escolhas sobre o produto. Uma lacuna de comportamento precisa da sua participação. O agente não deve tratar uma suposição como requisito confirmado.
  • Os testes do seu projeto. O Specsfy relaciona os resultados à spec. A execução usa as ferramentas de teste da stack e precisa demonstrar o comportamento real.
Licença
AGPL 3.0
Mantenedor
Promovaweb
Versão de referência
v0.29.1, a mesma usada nos assuntos deste portal.

Acompanhe a mudança pela spec

Entenda como registrar o comportamento esperado, relacionar o plano aos requisitos e conferir os testes da implementação.

Changelog

Últimas versões do Specsfy

Ver o changelog completo
  1. Specsfy 0.29.2StableLer as notas
  2. Specsfy 0.29.1StableLer as notas
  3. Specsfy 0.28.1StableLer as notas
  4. Specsfy 0.28.0Breaking changeLer as notas

Portais relacionados

Sistemas ligados a este nas stacks e nos projetos, cada um com o próprio portal.

Converse na comunidade

Leve ao Discord da Promovaweb o comportamento que você quer descrever e a dúvida sobre o teste correspondente. A comunidade pode discutir essa relação antes da implementação.

Desenvolva com IA

A documentação explica os comandos do Specsfy. A Formação Vibe Coding acompanha o aprendizado de desenvolvimento com IA.

Para organizar o escopo e a arquitetura do seu app, conheça o Diagnóstico de Produto e Arquitetura da Dev Side Studio.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.