Skip to Content
Início RápidoPrimeira Especificação

Primeira Especificação

Crie uma especificação, veja o SpecForge decompô-la em épicos e tickets, e prepare-se para a implementação.

Uma especificação é a unidade de trabalho de mais alto nível no SpecForge. Você descreve o que quer construir em linguagem natural. O SpecForge analisa, decompõe em épicos (agrupamentos lógicos) e tickets (tarefas atômicas de implementação), e constrói um grafo de dependência para que o trabalho execute na ordem correta.

Você escreve a intenção. O SpecForge produz o plano.

Criar uma Especificação pelo Painel

  1. Abra seu projeto no painel do SpecForge
  2. Clique em New Specification
  3. Insira um título — um nome conciso para a feature ou sistema que você está construindo
  4. Escreva uma descrição — quanto mais detalhes você fornecer, melhor a decomposição

Por exemplo:

  • Título: User Authentication System
  • Descrição: Implement email/password authentication with JWT tokens, refresh token rotation, password reset via email, rate limiting on login attempts, and account lockout after 5 failed attempts. Use bcrypt for hashing. Include middleware for protected routes.

Clique em Create e o SpecForge começa o planejamento.

Criar uma Especificação pela CLI

Se você já está no terminal com seu agente de código, não precisa trocar para o navegador. Diga ao seu agente:

Create a new SpecForge specification titled "User Authentication System"
with the following description: Implement email/password authentication
with JWT tokens, refresh token rotation, password reset via email, rate
limiting on login attempts, and account lockout after 5 failed attempts.

O agente chama a ferramenta MCP create_specification e retorna o ID da nova especificação. Tudo que você pode fazer na webapp, pode fazer pelo terminal.

Como a Decomposição Funciona

Após criar uma especificação, a fase de planejamento executa através do seu agente de código via ferramentas MCP:

  1. Análise — Sua descrição é analisada em busca de features, restrições e requisitos técnicos
  2. Geração de épicos — Agrupamentos lógicos emergem (ex.: “Core Auth”, “Password Reset”, “Rate Limiting”)
  3. Criação de tickets — Cada épico é dividido em tickets atômicos e implementáveis
  4. Mapeamento de dependências — Tickets são vinculados pelo que deve ser concluído antes que outra coisa possa começar

Isso não é uma lista plana de tarefas. É um grafo acíclico direcionado onde cada ticket conhece seus pré-requisitos.

💡 A qualidade da decomposição escala com a qualidade da sua descrição. Inclua restrições técnicas, preferências de bibliotecas e casos extremos. O SpecForge usa tudo que você fornecer. Uma descrição vaga produz um plano vago — qualidade entra, qualidade sai.

Como é uma Especificação Planejada

Quando o planejamento termina, sua especificação contém uma decomposição detalhada. Veja o que o exemplo acima poderia produzir:

Épicos

#ÉpicoTickets
1Core Authentication4
2Token Management3
3Password Reset Flow3
4Rate Limiting & Lockout3

Tickets de Exemplo (Core Authentication)

TicketDepende DeStatus
Set up User model and database schema—ready
Implement password hashing with bcryptUser modelready
Build registration endpointPassword hashingpending
Build login endpointPassword hashingpending

Tickets com status ready não têm dependências pendentes — podem ser trabalhados imediatamente. Tickets com status pending estão aguardando trabalho upstream.

Refinando Sua Especificação

Antes da implementação, você pode refinar pela webapp (edição visual) ou através do seu agente de código (ferramentas MCP):

  • Editar tickets — Ajustar escopo, adicionar critérios de aceite ou esclarecer requisitos
  • Adicionar dependências — Vincular tickets que precisam de ordenação com add_dependency
  • Verificar ciclos — O SpecForge previne dependências circulares automaticamente, mas você pode verificar com check_circular_dependencies
  • Revisar o caminho crítico — Veja qual cadeia de tickets determina o cronograma geral com get_critical_path

A webapp oferece edição visual com drag-and-drop. As ferramentas MCP oferecem o mesmo poder pelo terminal. Use o que melhor se encaixar no seu contexto.

✅ Use a ferramenta review_planning para obter uma avaliação por IA da completude da sua especificação antes de passar para a implementação.

O Que Acontece a Seguir

Com uma especificação totalmente planejada e tickets em status ready, você tem dois caminhos:

  1. Implementação manual — Pegue tickets você mesmo, use ferramentas MCP para acompanhar o progresso, vincule commits e PRs
  2. Implementação autônoma — Deixe seu agente de código implementar a especificação inteira com execução paralela orquestrada

A maioria das equipes começa manual para ganhar confiança, depois parte para o autônomo em especificações maiores.

Próximo: Instalar CLI →

Criar ContaInstalar CLI