A spec que o agente escreve, o gerente acompanha.
Quem programa com IA escreve a spec antes do código. Na Tasskee ela vira um documento vivo do projeto: o seu agente lê e atualiza pelo MCP enquanto trabalha, e o status, o progresso e as tarefas aparecem para o time na hora.
A spec deixa de ser um arquivo que só o agente lê
No repositório, a spec só conversa com quem programa. Aqui ela fica na pasta do projeto, com número, status e progresso, e o gerente vê o que o agente fez sem abrir o código.
Seu agente, pelo MCP
Claude Code, Cursor ou qualquer cliente MCP cria a spec, lê e escreve seção por seção, marca os critérios de aceite e liga as tarefas, com token próprio.
Status e progresso ao vivo
A fazer, Em andamento e Feito, mais o percentual que o agente atualiza a cada avanço. É o número que o gerente acompanha.
Da spec para as tarefas
Cada critério de aceite em aberto pode virar tarefa do projeto, e o "3/8 tarefas" conta sozinho quantas já fecharam.
Permissão por projeto
Cada perfil pode ver, editar, criar ou excluir specs projeto a projeto, e o agente respeita as mesmas regras de quem o conectou.
O agente trabalha na spec. Você vê acontecendo.
A Tasskee é um servidor MCP com ferramentas próprias para specs. O agente consulta só a seção que precisa, atualiza o que fez e registra o progresso — sem copiar e colar, e sem atropelar quem está editando o mesmo texto.
- 1Conecte o agente Gere um token na Tasskee e cole no Claude Code, no Cursor ou no seu cliente MCP.
- 2Peça em português "Implemente a spec 01 do App Mobile". O agente lê a spec e passa o status para Em andamento.
- 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 gerente abre a pasta do projeto e vê, numa lista, o que está a fazer, o que está andando e o que já foi entregue — com o progresso e as tarefas de cada spec.
- Status A fazer, Em andamento e Feito, com filtro
- Progresso percentual informado pelo agente
- Tarefas fechadas sobre o total, contadas sozinhas
- Sub-specs numeradas (01.1) debaixo da spec-mãe
Quem abre a tarefa encontra a spec que a explica
A tarefa ganha a aba Specs, com as specs do mesmo projeto ligadas a ela, o status e o progresso de cada uma. Quem pega a tarefa entende o porquê sem procurar.
- Spec e tarefa só se ligam dentro do mesmo projeto
- Citar a tarefa com # no texto da spec já conta no progresso
Isto vive junto com o resto da operação
Tarefa, cronograma, chamado, meta e conversa são a mesma base de dados. O que muda num lugar aparece no outro, sem exportar nada.
Como usar specs com 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, não o que você queria. A spec resolve isso, e na Tasskee ela ainda deixa o gerente acompanhar sem abrir o código. Veja o fluxo real, do token ao progresso.
Passo a passo
- Gere o token do MCP na Tasskee. Ele tem validade e escopo e você o revoga quando quiser. O agente enxerga só o que a pessoa que o conectou enxerga.
- 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 mora. 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: "implemente a spec 01 do App Mobile". O agente consulta o mapa de seções, lê só a que precisa e muda o status para Em andamento.
- Deixe-o marcar os critérios e ligar as tarefas. A cada avanço ele atualiza a seção, liga a tarefa e informa o percentual.
- Acompanhe pela pasta do projeto. A lista mostra A fazer, Em andamento e Feito, o progresso e as tarefas fechadas sobre o total.
Anatomia de uma boa spec
O agente segue o que está escrito, então 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 será feito.
- Fora do escopo: o que não será feito. É a seção que mais evita retrabalho.
- Decisões: escolhas já tomadas e o porquê.
- Critérios de aceite: uma lista de caixinhas verificáveis. "Webhook confirma o pagamento" é verificável. "Fica rápido" não é.
Cada critério em aberto pode virar tarefa do projeto, e o contador de tarefas fechadas se atualiza sozinho. Spec e tarefa só se ligam dentro do mesmo projeto.
Exemplos por tipo de equipe
Software house em Florianópolis
A gerente de projetos cria a spec de um módulo de cobrança com oito critérios. O desenvolvedor pede ao agente que a implemente. Na reunião de segunda, a gerente abre a pasta, vê a spec em 65% e três tarefas fechadas, e não precisa perguntar a ninguém. Para sprints, veja como usar sprints.
Startup de aplicativo em São Paulo
Duas pessoas e um agente. A spec mora 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.
Equipe 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 sobrescrever ninguém.
Boas práticas
- Uma spec, um resultado entregável. Spec que tenta cobrir tudo não tem progresso que se acompanhe.
- Critérios verificáveis. Se você não consegue marcar a caixinha com um teste ou uma checagem, reescreva.
- Cite a tarefa com # no texto. Isso já conta no progresso.
- Deixe o agente escrever por seção. Mudar um critério não mexe no resto do texto.
- O gerente lê o progresso, não o código. Combine isso no começo.
Erros comuns
| Erro | Consequência |
|---|---|
| Spec sem "fora do escopo" | O agente faz mais do que devia |
| Critério vago | O progresso não significa nada |
| Token compartilhado entre pessoas | Perde-se a rastreabilidade de quem pediu |
| Nunca revisar o que o agente marcou | "Feito" sem estar pronto |
Specs a partir do plano Start; o MCP no Pro
As specs existem a partir do plano Start. O agente conectado pelo MCP faz parte do Pro e do Max, e no teste de 15 dias tudo vem liberado. A IA usa a sua chave ou assinatura, sem créditos da Tasskee. Para entender o porquê do desenho, leia MCP: a IA que trabalha no projeto.
As specs são irmãs dos documentos e conversam com o assistente de IA. Para o conceito de backlog e sprint que alimenta tudo isso, há o modelo de backlog e sprint.
Perguntas sobre specs
O que é uma spec?
Quais agentes funcionam?
E a spec que já está no meu repositório?
O agente pode sobrescrever o que eu estou editando?
Quem vê as specs?
Conecte o seu agente e acompanhe a spec andar
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á atualizando o progresso.