Desenvolvimento orientado por especificações
Transforme requisitos em especificações, planos, código e registos de alterações rastreáveis.
Dê a pessoas e Coding Agents um contrato partilhado antes de começar a implementação. O FiboCode e Fibo Skills transformam um pedido inicial em critérios de aceitação explícitos, um design ligado, um plano ordenado, código revisto e um registo de alterações que permanece no repositório.
Código rápido não é o mesmo que código alinhado.
Um Coding Agent pode passar rapidamente de um pedido breve para a implementação, mas as suposições em falta surgem muitas vezes apenas depois de os ficheiros mudarem. Se o requisito, o limite e a prova de conclusão permanecerem implícitos, os revisores têm de reconstruir o comportamento pretendido enquanto avaliam o código.
O desenvolvimento orientado por especificações cria um percurso explícito antes da execução. O requisito torna-se critérios de aceitação testáveis; as decisões de design indicam como serão cumpridos; o plano identifica tarefas, ficheiros e verificações pela ordem certa. A implementação ganha um contrato visível e o registo final do diff explica o que realmente mudou.
Veja o fluxo permanecer ligado ao trabalho real.
Estas demonstrações mostram registos rastreáveis a crescer com o código, enquanto o Agent CLI permanece no fluxo de terminal existente.
Veja a cadeia de documentos que liga um requisito inicial a decisões, tarefas, provas de implementação e compreensão posterior.
Mantenha o Agent CLI no terminal enquanto lhe fornece ficheiros, símbolos, capturas de ecrã e caminhos de saída navegáveis.
Passe da intenção às provas em quatro etapas.
Cada etapa tem um objetivo distinto, para que as questões sejam resolvidas antes de se tornarem escolhas de implementação escondidas.
Clarifique o requisito e os critérios de aceitação.
Transforme o pedido inicial em resultados explícitos e testáveis e defina o que fica fora da alteração. O programador aprova o contrato antes de começar o código de produção.
Desenhe a abordagem a partir dos critérios.
Descreva como o sistema irá satisfazer cada critério, incluindo limites, interfaces e compromissos importantes. As ligações mantêm as decisões rastreáveis ao comportamento que servem.
Crie e execute um plano ordenado.
Divida o design em tarefas delimitadas, com ficheiros envolvidos e métodos de aceitação. O Coding Agent percorre a sequência com o contexto acordado disponível.
Reveja o código e registe a alteração real.
Inspecione o diff resultante, verifique os critérios de aceitação e conserve uma explicação centrada nos hunks sobre o que mudou e porquê.
Um contrato rastreável em torno da execução pelo Agent.
Critérios de aceitação antes da implementação.
Uma especificação transforma uma intenção vaga em resultados observáveis e dá ao programador e ao Agent uma definição partilhada de conclusão.
Decisões de design ligadas ao comportamento.
O design explica como a alteração deve funcionar e mantém cada decisão importante ligada ao critério que a exige.
Execução delimitada e ordenada.
Os planos identificam tarefas, ficheiros envolvidos e métodos de verificação, para que a implementação avance em unidades que podem ser revistas e não num salto opaco.
Histórico de alterações assente no diff.
Depois da execução, um registo baseado no diff real explica os hunks da implementação e liga-os à lógica envolvente e à intenção do projeto.
Caso de utilização: alterar comportamento em vários módulos.
Um pedido parece simples, mas afeta routing, estado, UI e validação. O programador começa por acordar resultados observáveis e exclusões. O design associa esses resultados aos limites afetados e o plano separa o trabalho em tarefas por ficheiro, cada uma com um método de verificação.
O Agent CLI executa depois com menos escolhas escondidas. Os revisores podem comparar o resultado com os critérios aprovados, inspecionar as alterações reais e conservar um registo do diff que explica como a implementação se liga ao requisito original.
Uma camada de fluxo, não um substituto do seu Agent nem dos testes.
Fibo Skills orienta as etapas de clarificação, especificação, design, planeamento, execução e registo de alterações. O Agent CLI escolhido continua a realizar a programação e os testes e métodos de aceitação reais do projeto continuam a determinar se o resultado está correto.
O valor está no alinhamento partilhado e na rastreabilidade. Um fluxo centrado no prompt pode começar a programar com a intenção por resolver; o percurso orientado por especificações torna essa intenção passível de revisão antes da alteração e mantém as provas disponíveis depois.
Perguntas sobre o desenvolvimento orientado por especificações
Preciso de uma especificação para cada pequena alteração?
Utilize o fluxo quando o comportamento, os limites ou a aceitação precisarem de alinhamento. Uma pequena alteração mecânica pode não exigir a mesma profundidade que uma funcionalidade que abrange vários módulos.
O que são Fibo Skills?
Fibo Skills são instruções de fluxo utilizadas com ambientes Agent CLI compatíveis para orientar clarificação, especificação, design, planeamento, execução e registo de alterações.
O Agent pode começar a programar antes da aprovação?
O fluxo previsto pede ao programador que aprove primeiro a especificação, para que o código de produção assente num contrato comportamental explícito e não em suposições por resolver.
Como se mantêm rastreáveis o design e o plano?
As decisões de design remetem para os critérios de aceitação, enquanto as tarefas do plano identificam os critérios, ficheiros e métodos de aceitação envolvidos.
O que acontece depois da implementação?
O resultado é revisto face à especificação e ao diff real. Um registo de alterações pode então explicar os hunks da implementação e conservar o motivo por que existem.