As skills base dividem o método por responsabilidade. Você pode chamar uma delas pelo nome ou explicar o resultado esperado. O agente lê o estado da spec, seleciona a etapa responsável e anuncia cada transição necessária.
Nomes exibidos
Os comandos técnicos continuam, por exemplo, como $specsfy-02-backlog. Na
interface, as sete etapas centrais aparecem como Specsfy - 01 - Inbox até
Specsfy - 07 - Implementar. As skills adicionais usam Specsfy - Nome, e
as técnicas usam Specsfy - Especialista - Nome.
Como responder às perguntas
Toda skill que precisa perguntar segue o mesmo formato desde a primeira rodada:
- apresenta uma pergunta com o rótulo
Pergunta 1e espera sua resposta, - oferece pelo menos três respostas sugeridas e numeradas abaixo dela,
- acrescenta
Escrever outra respostapara você informar seu próprio texto, - acrescenta
Gere outras opçõespara mostrar alternativas diferentes à mesma pergunta, - acrescenta
Avançarpara abrir a confirmação de encerramento da área, adiamento ou retomada imediata.
Você pode responder com combinações como 1.2 ou 1.4: meu texto. O número
da opção é convertido no texto completo antes de gerar qualquer contexto.
Ao escolher Avançar, a rodada seguinte pergunta se você quer encerrar
definitivamente as perguntas daquela área, responder depois ou voltar a
responder agora. Se encerrar, a skill registra sua escolha e não pergunta sobre
a área novamente, a menos que você a reabra. Se adiar, os pontos ficam
registrados para retomada. Nenhuma das escolhas inventa uma resposta ou aprova
uma etapa incompleta.
Inbox, progresso, auxiliares de stack e banco e documentador não conduzem entrevista. Essas skills registram ou projetam o que já existe e encaminham qualquer pergunta para uma etapa conversacional.
| Etapa | Skill | Resultado principal |
|---|---|---|
| capturar sem perguntas | specsfy-01-inbox |
arquivo em specs/inbox/ |
| refinar uma entrada e aprofundar definições | specsfy-02-backlog |
item em specs/backlog/ e brief na conversa |
| criar a fonte única | specsfy-03-specify |
spec.md |
| revisar definição | specsfy-04-validate |
Definition Gate confiável |
| decompor o plano | specsfy-05-tasks |
tarefas dentro da spec |
| preparar e executar testes | specsfy-06-tdd-bdd |
RED/GREEN rastreável |
| produzir a mudança | specsfy-07-implement |
código, testes e evidência |
| incorporar mudança posterior | specsfy-update-spec |
spec atualizada e gates reabertos |
| consultar o estado | specsfy-progress |
relatório somente leitura |
| conversar conforme a fase | specsfy-interviewer |
respostas confirmadas e Effort recalibrado |
| definir o MVP e seus marcos | specsfy-mvp-milestone-interviewer |
milestones aprováveis do MVP |
| descobrir o que o sistema precisa guardar | specsfy-data-discovery |
respostas confirmadas em DATABASE.md |
| planejar a evolução | specsfy-roadmap-milestone-interviewer |
milestones pós-MVP |
| manter a projeção | specsfy-milestone-governor |
specs.md e progresso derivado |
Encontre a skill pelo estado do trabalho
Uma anotação que precisa ser preservada vai para specsfy-01-inbox. Quando
você quiser comparar essa ideia com itens existentes e esclarecer o mínimo
necessário, specsfy-02-backlog cria ou atualiza o arquivo numerado e
aprofunda as definições que mudam o comportamento e
entrega um brief na conversa.
Com a intenção de criar uma entrega confirmada,
specsfy-03-specify monta a spec.md e specsfy-04-validate comprova o
Ato I. A skill specsfy-05-tasks organiza o plano, chama
specsfy-06-tdd-bdd para materializar os testes e só aprova o Plan Gate
depois de um RED válido. specsfy-07-implement executa as tarefas com
evidência e documentação atualizada.
Uma necessidade surgida depois da definição retorna à mesma spec por
specsfy-update-spec. Para apenas consultar gates, tarefas e o próximo
trabalho sem alterar arquivos, use specsfy-progress.
Quando uma lacuna puder alterar a próxima etapa, chame
specsfy-interviewer. Ele conversa com a spec sem substituir a skill que
valida, planeja, implementa ou conclui.
Para organizar um produto inteiro, comece pelo
specsfy-mvp-milestone-interviewer. Depois do aceite do MVP, use o
specsfy-roadmap-milestone-interviewer. O specsfy-milestone-governor mantém
o mapa derivado de specs e backlog. O guia Milestones
explica arquivos, relações e sincronização.
Quando uma conversa revelar informações que o sistema precisa lembrar, use
specsfy-data-discovery. A skill pergunta em linguagem simples e mantém o
registro em .specsfy/DATABASE.md antes de o backlog ou a spec avançar.
Volte ao guia completo ou leia como a metodologia funciona.