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.
- Definição e execuçãoO agente consulta a definição aprovada para implementar a mudança.
- Uma spec por mudançaO plano e as tarefas ficam junto dos requisitos.
- Acompanhamento no ClickUpA spec pode ser vinculada à tarefa do projeto.
- 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.
- DefiniçãoVocê e o agente descrevem a mudança e os exemplos do comportamento esperado.
- Plano e testesO agente relaciona as tarefas aos requisitos e prepara os testes na stack do app.
- ImplementaçãoO código é alterado e os resultados são reunidos para comparar o app com a especificação.
- RevisãoVocê confere a implementação e as comprovações registradas antes do aceite final.
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.
- Guia da licença
- O que a licença permite, o que proíbe e exemplos de uso
Acompanhe a mudança pela spec
Entenda como registrar o comportamento esperado, relacionar o plano aos requisitos e conferir os testes da implementação.
- O que é o SpecsfyO comportamento aprovado preservado junto do código para o agente consultar durante a mudança.
- Para que serveA referência SPECSFY nos testes liga a implementação aos requisitos e aos cenários de aceite da spec.
- Fluxo de especificaçãoA ideia na Inbox, o refinamento no backlog e as etapas de definição, plano e execução da spec.
- Requisitos, plano e tarefasO plano e as tarefas no mesmo documento dos requisitos, com referências para conferir os testes.
- Specsfy e ClickUpO vínculo opcional da spec com uma tarefa e a sincronização conduzida pelas skills ClickUpfy.
- Versões e changelogO executável, as skills instaladas e as notas de versão que explicam o que muda no projeto.
Últimas versões do Specsfy
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.
