O plugin do Claude Code

Existe um plugin oficial para o Claude Code que conduz a modelagem por conversa: você descreve o sistema em português, e ele traduz isso em comandos do cfour, que escrevem no YAML.

Ele mora em github.com/evandrobreis/cfourdev-claude.

O que muda com ele

Sem o plugin, você aprende o formato e escreve — à mão ou por comando.

Com o plugin, o trabalho começa por uma conversa: ele pergunta o que o sistema faz, quem o usa, com o que ele integra; propõe como aquilo vira caixas e setas; e executa os comandos, mostrando o que mudou.

O que ele faz, em linhas gerais:

• prepara o repositório — confere se a ferramenta está instalada, se existe um cfour.yaml, se o modelo atual está válido, e explica o que falta;
• entende o software antes de desenhar — por rodadas curtas de perguntas e pela leitura das fontes que já existem no repositório;
• traduz pedido em comando — cria e altera elementos, relações, notas, diagramas, fluxos e projetos, valida com cfour check, abre o leitor e publica;
• descobre a ferramenta em vez de adivinhar — ele lê a árvore de comandos do próprio cfour instalado, então não inventa opção que não existe;
• retoma o trabalho — carrega o que ficou decidido numa sessão anterior, aponta divergências entre o que ele lembra e o que está no disco, e registra o que virou fato ao encerrar.

O que ele não faz: decidir arquitetura por inferência. Ele pergunta.

Instalar

Dentro do Claude Code:

/plugin marketplace add evandrobreis/cfourdev-claude
/plugin install cfour@cfourdev

Para que todo mundo que clonar um repositório receba o plugin sem digitar nada, declare isso no .claude/settings.json do repositório:

.claude/settings.json

{
  "extraKnownMarketplaces": {
    "cfourdev": {
      "source": { "source": "github", "repo": "evandrobreis/cfourdev-claude" }
    }
  },
  "enabledPlugins": {
    "cfour@cfourdev": true
  }
}

Os comandos que o plugin acrescenta aparecem na ajuda do próprio Claude Code depois da instalação — é de lá que vem a lista atual, e não daqui: o plugin tem ciclo de vida próprio.

Pré-requisitos

• o Claude Code instalado;
• a ferramenta cfour instalada — Instalação. O plugin não a substitui: ele a usa;
• um repositório onde a modelagem vai morar.

O que ele grava no seu repositório

Além do modelo — que é o mesmo YAML de sempre — o plugin mantém uma memória da modelagem em:

.claude/cfour/history/<id-da-modelagem>/

É onde ficam o contexto do software apurado nas conversas, as decisões tomadas e o estado da última sessão. Isso é dado, e não código: vale versionar, porque é o que faz a próxima sessão continuar de onde a anterior parou — inclusive para outra pessoa da equipe.

A memória é indexada pelo identificador da modelagem, e não pela pasta dela. Uma consequência: mover a modelagem para outro repositório move o modelo, e a memória tem de ser levada junto deliberadamente.

Plugin, linha de comando e MCP

São três coisas diferentes, e as três convivem:

o plugin	escreve o modelo conversando, na sua máquina
o cfour	escreve o modelo por comando, na sua máquina, e publica
o servidor MCP	lê o modelo publicado, de qualquer lugar

O plugin é uma camada sobre a linha de comando: tudo o que ele faz, você também consegue fazer digitando. O MCP é outra coisa — ele responde perguntas sobre o que já está publicado, e não escreve nada.