Operação

Ciclo de desenvolvimento

Modelo —
1. Domínio & Escopo do Projeto

Selecione o domínio que melhor descreve o objetivo do seu projeto para receber diretrizes sob medida.

Engenharia de Software

APIs robustas, aplicações web, microsserviços, MVC e padrões clássicos de desenvolvimento de software.

Dados & Analytics

Pipelines de dados, dbt, Spark, ETL, bancos analíticos, data warehouses e modelagem dimensional.

Multi-Agentes & IA

Sistemas distribuídos orquestrados por múltiplos agentes de IA, RAG, bases de vetores e LLMs.

Web Simples / Landing Page

Websites estáticos, landing pages, HTML/CSS/JS e otimizações de SEO e carregamento rápido.

Infraestrutura / Cloud Ops

Provisionamento de recursos, redes complexas, segurança IAM, e automações IaC sem código de aplicação.

Outro / Customizado

2. Escopo de Atuação

Defina até onde os agentes atuam neste projeto.

Apenas Aplicação

Código de aplicação, testes e documentação. A infraestrutura é gerida fora do ciclo.

Aplicação + Infraestrutura (Full Stack Ops)

Os agentes também produzem e revisam declarações de infraestrutura junto do código.

Apenas Infraestrutura

Provisionamento, redes e políticas. Nenhum código de aplicação é alterado.

Outro / Customizado

3. Padrão Arquitetural

Selecione o estilo arquitetural e convenção de organização de pastas do seu projeto.

Hexagonal / Clean Architecture

Separação rígida de regras de negócio (core/domain) e adaptadores externos (ports & adapters).

Monolito Modular

Único deploy estruturado em módulos internos bem acoplados logicamente, mas isolados fisicamente.

Microsserviços

Distribuição de responsabilidade por limites de contexto (Bounded Contexts) e APIs desacopladas.

Serverless

Funções sob demanda e serviços gerenciados (FaaS), escalabilidade automática e baixo custo ocioso.

Pipeline / Data Analytics

Camadas bronze/silver/gold, modelos dimensionais Star Schema e orquestradores de fluxo.

Orquestração de Agentes

Fluxos baseados em grafos direcionados acíclicos (DAGs) ou loops de feedback de agentes autônomos.

Outra / Customizada

4. Nuvem & Infraestrutura

Selecione o provedor onde as cargas deste projeto serão executadas.

5. Infraestrutura como Código (IaC)

Selecione a ferramenta utilizada para declarar e provisionar seus recursos de infraestrutura.

6. Linguagem Principal

Selecione a linguagem de programação principal do projeto.

7. Testes & Ferramentas de Qualidade

Selecione as ferramentas e bibliotecas de testes sugeridas para a sua linguagem, ou adicione itens customizados.

Outras ferramentas de Teste / Linters (separados por vírgula)
Assistente concluído
Revise antes de salvar
8. Recomendações & TDD Combo
TDD Combo Padrão (Princípio Inegociável)

Todo teste de comportamento DEVE ser escrito antes do código de implementação (Fluxo Red-Green-Refactor).

Red: Crie um teste que falha antes de codificar a funcionalidade.
Green: Escreva o código mínimo necessário para fazer o teste passar.
Refactor: Limpe e melhore o design mantendo o teste passando.
Instruções customizadas e regras extras (opcional)
Visualização prévia da Foundation
Árvore de diretórios sugerida
Passo 1 de 8
Foundation ativa
Estado atual do projeto
.speccycle/knowledge/foundation.md
Respostas registradas
Instruções customizadas
TDD Combo Padrão (Princípio Inegociável)

Todo teste de comportamento DEVE ser escrito antes do código de implementação (Fluxo Red-Green-Refactor).

Red: Crie um teste que falha antes de codificar a funcionalidade.
Green: Escreva o código mínimo necessário para fazer o teste passar.
Refactor: Limpe e melhore o design mantendo o teste passando.
Árvore de diretórios
.speccycle/knowledge/foundation.md
Este é o conteúdo completo que será gravado. Suas respostas já estão mescladas nele.
Conexão perdida

Reconecte para continuar

A conexão com a plataforma caiu. Nenhum ciclo pode ser criado ou executado até que ela seja restabelecida — os agentes só rodam com escopo e teto de custo validados pela organização.
As fases enviam dados e metadados de execução (duração, tokens, modelo, artefatos, gates) que a plataforma usa nos relatórios; sem conexão não há onde registrá-los.
Ciclo
Artefatos gerados
Último mapeamento
Carregando…
/scycle:index —

Módulos indexados

Arquivos e dependências de saída por módulo, como os agentes enxergam o repositório.

Visualização do grafo
Artefato
Protótipos
Ajuda & Documentação — Spec-Cycle

Ambiente de execução

Verificando…

O Spec-Cycle precisa de um dos dois modos para rodar os agentes:

  • Claude Code instalado — sessões usam a mesma instância local. Nenhuma chave adicional necessária.
  • ANTHROPIC_API_KEY — defina essa variável de ambiente e as sessões chamam a API diretamente.

Configurar ANTHROPIC_API_KEY

Obtenha sua chave em console.anthropic.com/settings/api-keys e defina:

  • Windows (PowerShell): $env:ANTHROPIC_API_KEY = "sk-ant-..."
  • Windows (cmd): set ANTHROPIC_API_KEY=sk-ant-...
  • macOS / Linux: export ANTHROPIC_API_KEY=sk-ant-...

Reinicie o servidor (scycle start) após configurar.

As 8 fases do ciclo

#FaseComandoDescrição

Comandos CLI

  • scycle init --here — inicializa o Spec-Cycle no projeto atual
  • scycle new "Nome" — cria uma nova volta de feature
  • scycle start — inicia este cliente (padrão: porta 8473)
  • scycle doctor — verifica o ambiente e autenticação
  • scycle help — exibe documentação completa no terminal
  • scycle update-version — atualiza os arquivos do framework
  • scycle remove — remove o Spec-Cycle do repositório

Princípios do Spec-Cycle

  • A spec é a fonte de verdade — código que diverge da spec está errado, mesmo que funcione.
  • Nenhuma fase começa sem a anterior aprovada no checkpoint.
  • Todo critério de sucesso da Intent é coberto por pelo menos um cenário Gherkin na Behavior.
  • Build segue TDD: um increment só fecha quando seus cenários passam.
  • Learnings de cada volta são lidos na Discovery da volta seguinte.