A spec que o agente escreve, o gestor acompanha.
Quem programa com IA escreve a spec antes do código. Na Tasskee ela passa a ser um documento vivo do projeto: o seu agente lê e atualiza-a pelo MCP enquanto trabalha, e o estado, o progresso e as tarefas aparecem à equipa na hora.
A spec deixa de ser um ficheiro que só o agente lê
No repositório, a spec só fala com quem programa. Aqui fica na pasta do projeto, com número, estado e progresso, e o gestor vê o que o agente fez sem abrir o código.
O seu agente, pelo MCP
O Claude Code, o Cursor ou qualquer cliente MCP cria a spec, lê e escreve secção a secção, marca os critérios de aceitação e liga as tarefas, com token próprio.
Estado e progresso em direto
Por fazer, Em curso e Feito, mais a percentagem que o agente atualiza a cada avanço. É o número que o gestor acompanha.
Da spec às tarefas
Cada critério de aceitação em aberto pode passar a tarefa do projeto, e o "3/8 tarefas" conta sozinho quantas já fecharam.
Permissão por projeto
Cada perfil pode ver, editar, criar ou eliminar specs projeto a projeto, e o agente respeita as mesmas regras de quem o ligou.
O agente trabalha na spec. Você vê a acontecer.
A Tasskee é um servidor MCP com ferramentas próprias para specs. O agente consulta só a secção de que precisa, atualiza o que fez e regista o progresso — sem copiar e colar, e sem atropelar quem está a editar o mesmo texto.
- 1Ligue o agente Gere um token na Tasskee e cole-o no Claude Code, no Cursor ou no seu cliente MCP.
- 2Peça em português "Implemente a spec 01 da App Mobile". O agente lê a spec e passa o estado para Em curso.
- 3Acompanhe sem perguntar Critérios marcados, progresso e tarefas mudam na Tasskee enquanto ele programa, com histórico de versões.
Uma pasta por projeto, com o andamento de cada spec
O gestor abre a pasta do projeto e vê, numa lista, o que está por fazer, o que está em curso e o que já foi entregue — com o progresso e as tarefas de cada spec.
- Estados Por fazer, Em curso e Feito, com filtro
- Percentagem de progresso indicada pelo agente
- Tarefas fechadas sobre o total, contadas automaticamente
- Sub-specs numeradas (01.1) por baixo da spec-mãe
Quem abre a tarefa encontra a spec que a explica
A tarefa ganha o separador Specs, com as specs do mesmo projeto ligadas a ela, o estado e o progresso de cada uma. Quem pega na tarefa percebe o porquê sem andar à procura.
- Spec e tarefa só se ligam dentro do mesmo projeto
- Citar a tarefa com # no texto da spec já conta para o progresso
Isto vive junto com o resto da operação
Tarefa, cronograma, pedido, objetivo e conversa são a mesma base de dados. O que muda num sítio aparece no outro, sem exportar nada.
Como usar specs com um agente de IA na prática
Quem programa com um agente de IA sabe o que acontece sem especificação: o agente faz o que entendeu, e não o que você queria. A spec resolve isso, e na Tasskee permite ainda ao gestor acompanhar sem abrir o código. Veja o fluxo real, do token ao progresso.
Passo a passo
- Gere o token do MCP na Tasskee. Tem validade e âmbito, e pode revogá-lo quando quiser. O agente vê apenas o que a pessoa que o ligou vê.
- Cole o token no seu cliente. Funciona com qualquer cliente compatível com MCP, como Claude Code, Claude Desktop, Cursor e VS Code.
- Escolha onde a spec vive. Só na Tasskee, só no repositório (a Tasskee guarda um espelho) ou nos dois. Na primeira conversa, o agente pergunta o modo.
- Peça em português: "implementa a spec 01 do App Mobile". O agente consulta o mapa de secções, lê só a de que precisa e muda o estado para Em curso.
- Deixe-o marcar os critérios e ligar as tarefas. A cada avanço, ele atualiza a secção, liga a tarefa e indica a percentagem.
- Acompanhe pela pasta do projeto. A lista mostra A fazer, Em curso e Concluído, o progresso e as tarefas fechadas sobre o total.
Anatomia de uma boa spec
O agente segue o que está escrito, pelo que a qualidade da spec define a qualidade da entrega. Uma estrutura que funciona:
- Problema: o que dói hoje, em duas ou três frases.
- Proposta: o que vai ser feito.
- Fora do âmbito: o que não vai ser feito. É a secção que mais evita retrabalho.
- Decisões: escolhas já tomadas e porquê.
- Critérios de aceitação: uma lista de caixas verificáveis. "O webhook confirma o pagamento" é verificável. "Fica rápido" não é.
Cada critério em aberto pode transformar-se numa tarefa do projeto, e o contador de tarefas fechadas atualiza-se sozinho. A spec e a tarefa só se ligam dentro do mesmo projeto.
Exemplos por tipo de equipa
Software house em Florianópolis
A gestora de projetos cria a spec de um módulo de cobrança com oito critérios. O programador pede ao agente que a implemente. Na reunião de segunda-feira, a gestora abre a pasta, vê a spec em 65% e três tarefas fechadas, e não precisa de perguntar a ninguém. Para sprints, veja como usar sprints.
Startup de aplicações em São Paulo
Duas pessoas e um agente. A spec vive no repositório e a Tasskee guarda o espelho, para o sócio de negócio acompanhar sem entrar no Git. Sub-specs numeradas, como 01.1, separam as entregas menores debaixo da spec-mãe.
Equipa de TI de uma indústria em Joinville
O analista usa o agente para automatizar um relatório interno. A permissão por projeto garante que o agente só vê o que o analista vê. Se alguém abrir a mesma spec no editor, a escrita do agente é recusada, para ninguém substituir o trabalho de ninguém.
Boas práticas
- Uma spec, um resultado entregável. Uma spec que tenta cobrir tudo não tem um progresso que se acompanhe.
- Critérios verificáveis. Se não consegue marcar a caixa com um teste ou uma verificação, reescreva.
- Cite a tarefa com # no texto. Isso já conta para o progresso.
- Deixe o agente escrever por secção. Mudar um critério não mexe no resto do texto.
- O gestor lê o progresso, não o código. Combine isto logo no início.
Erros comuns
| Erro | Consequência |
|---|---|
| Spec sem "fora do âmbito" | O agente faz mais do que devia |
| Critério vago | O progresso não significa nada |
| Token partilhado entre pessoas | Perde-se a rastreabilidade de quem fez o pedido |
| Nunca rever o que o agente marcou | "Concluído" sem estar pronto |
Specs a partir do plano Start; o MCP no Pro
As specs existem a partir do plano Start. O agente ligado pelo MCP faz parte do Pro e do Max, e no teste de 15 dias vem tudo disponível. A IA usa a sua chave ou subscrição, sem créditos da Tasskee. Para perceber o porquê do desenho, leia MCP: a IA que trabalha no projeto.
As specs são irmãs dos documentos e dialogam com o assistente de IA. Para o conceito de backlog e sprint que alimenta tudo isto, há o modelo de backlog e sprint.
Perguntas sobre specs
O que é uma spec?
Que agentes funcionam?
E a spec que já está no meu repositório?
O agente pode substituir o que estou a editar?
Quem vê as specs?
Ligue o seu agente e acompanhe a spec a avançar
Crie a conta grátis, abra a pasta de specs do projeto e gere o token do MCP. Em cinco minutos o agente já está a atualizar o progresso.