As dezoito skills cobrem o ciclo de um binário, da sua descrição inicial à release. Cada etapa produz os arquivos que a seguinte consulta para continuar.
O trabalho gira em torno de dois documentos. O CLISPEC.md, único por
binário, guarda a visão macro: o que o binário é, a que públicos serve, o que fica de
fora e a superfície já entregue. Cada evolução ganha uma spec em
specs/NNNN-slug.md, com as mudanças na superfície, como o binário vai
funcionar (Behavior), como o código deve ser feito (Design), as tarefas e
os testes de aceite. A spec começa na entrevista, recebe as marcas das
skills de implementação e, concluída, tem a superfície copiada para o
CLISPEC.md pelo agente. Os dois documentos são Markdown puro, escritos à
mão pelo agente, o binário não os lê.
Visão geral
frase da pessoa │ ▼termfy ─────────────────────────────────────────────────────────┐ ├─► termfy-init ─► termfy-brand │ ├─► termfy-clispec (CLISPEC.md e specs iniciais) │ ├─► por spec: termfy-spec (ou termfy-api-import) │ │ ├─► por entrega: termfy-config ─► termfy-api ─► │ │ │ termfy-database ─► termfy-cli / termfy-command-set ─► │ │ │ termfy-mcp ─► termfy-tui │ │ │ └─► termfy-test │ │ ├─► termfy-review ─► termfy-docs │ │ └─► fechamento │ └─► termfy-release ─► termfy-mcp-client │ │ (identidade → termfy-brand; propósito → termfy-clispec; │ nova evolução → termfy-spec) ◄──────────────────────────────────────┘0. Entrar: termfy
Use termfy para descrever o que você quer em linguagem natural quando
ainda não souber qual skill chamar. Ela diagnostica o estágio do repositório, confirma nome,
propósito e públicos em uma única mensagem e chama as demais skills na
ordem abaixo. Para só duas vezes: na aprovação do CLISPEC.md com a
primeira spec e antes da release.
1. Criar: termfy-init
No setup, logo depois de clicar em Use this template, peça ao agente
para usar termfy-init. Ela aplica a identidade, mantém as skills e passa
para termfy-clispec, confere --version, about --json e mcp --list e
roda bun run validate.
Em um projeto existente, use a mesma skill no modo de manutenção para
instalar, atualizar ou reparar as skills, preservando a identidade, o
CLISPEC.md e as specs. O agente executa os comandos internos de cada modo.
2. Apresentar: termfy-brand
Quando o nome, o título, a descrição, o autor, os links, a licença, os
créditos ou as cores mudarem. Cuida do que o init não altera: créditos,
paleta, painel “Standards” da aba About, campos de identidade do
CLISPEC.md. Confere as
superfícies: --version, about, aba About, info do OpenCLI e nome do
servidor MCP.
3. Descrever o binário: termfy-clispec
Use termfy-clispec no início do projeto e retome a entrevista quando o
propósito, os públicos ou os limites mudarem. A skill entrevista você para
entender o problema que o binário resolve e os modos que precisa atender.
Ela detalha as capacidades, as integrações e o armazenamento necessário
para gravar a visão macro no CLISPEC.md. Com você,
monta a lista de specs iniciais, uma por capacidade entregável. Grava
cada uma em specs/ como draft, com a linha correspondente no índice.
Deixa pronto: o CLISPEC.md com Purpose, Audiences, Out of scope, a
Surface do que o esqueleto já entrega e o índice das specs iniciais em
draft.
4. Especificar cada evolução: termfy-spec ou termfy-api-import
Para cada evolução, termfy-spec entrevista em blocos curtos e escreve
a spec: Goal, Behavior, Design, Surface com as mudanças na superfície,
Tasks e Tests. Quando o ponto de partida é a documentação de uma API
(OpenAPI, Postman, página ou texto), termfy-api-import lê a documentação,
propõe commands por recurso, tools, settings e credenciais. Grava tudo
em Surface de uma spec nova. Em ambos os casos, a spec segue o contrato
antes de sair de draft: Goal, Behavior e Design com texto e ao menos uma
tarefa. O que a spec planeja e o código ainda não tem é o trabalho da
evolução.
Deixa pronto: uma tarefa com a tag da skill responsável por entrega e um teste de aceite por resultado esperado.
5. Implementar, uma entrega por vez
Ordem para um recurso novo:
termfy-configdeclara a key e a credencial que o recurso usa.termfy-apicria o client do serviço externo, quando houver.termfy-databasecria as tabelas por migration e os repositórios, só quando a spec descreve registros que o binário guarda entre execuções.termfy-clicria um command avulso,termfy-command-setgera a famíliarecurso list|show|create|update|deletede uma vez, com tools e screen.termfy-mcpespelha o que faltou em tools, reutilizando as funções.termfy-tuidá uma aba ao recurso, comlistPanelquando for lista.termfy-testescreve os testes de aceite da spec nos três modos antes de marcar o item.
Cada skill lê a spec aberta antes de mexer no código, segue o Behavior e o
Design e, ao concluir e testar, marca [x] no item da spec. O
CLISPEC.md não muda nessa etapa: o código fica à frente dele até o
fechamento. Se o código ganhou algo que nenhuma spec previa, crie uma spec
de adoção e descreva o que já existe em Surface, essas entradas chegam ao
CLISPEC.md quando ela fechar.
6. Fechar a spec: termfy-review, termfy-docs e termfy-spec
termfy-review compara a entrega com o Behavior e o Design da spec e
confere o CLISPEC.md e as specs contra o código. A revisão também procura
segredos expostos e saída indevida no stdout do MCP. Ela verifica os
contratos de saída, a documentação e os padrões de interface do framework.
O relatório indica se a spec pode fechar e classifica as falhas por gravidade,
sem editar. Corrigido o que ela apontou, termfy-docs relê
bun run dev -- --skill como um agente leria, corrige a cobertura apontada
por bun run docs:check e regenera docs/opencli.json. Com todos os itens
marcados, o agente fecha a spec pelo fluxo de termfy-spec: aplica Surface
às tabelas do CLISPEC.md, troca o status para done na spec e no índice
e registra a data nas Notes do CLISPEC.md. A próxima spec da lista volta à etapa 4.
7. Publicar e ligar aos agentes: termfy-release e termfy-mcp-client
termfy-release publica depois que as specs da versão foram fechadas.
Avança a versão, escreve o changelog (que pode citar os IDs das specs
fechadas), valida e cria commit e tag. Depois confere a release que o workflow
gera, com binários e checksums.
termfy-mcp-client configura o binário em Claude Code, Codex, Cursor,
OpenCode ou Gemini CLI e valida com mcp --list e o Inspector.
Quando sair da ordem
- Alteração pequena em um command existente:
termfy-specescreve uma spec curta com a alteração em Surface, uma tarefa e um teste, depoistermfy-cli,termfy-teste o fechamento da spec. - Só mudar texto da documentação:
termfy-docsdireto. - Só mudar cores ou créditos:
termfy-branddireto. - Só revisar antes de um merge:
termfy-reviewdireto. - Atualizar as skills para uma versão nova do framework:
termfy-initno modo de manutenção das skills, se a faixa de compatibilidade mudou, leia oCHANGELOG.mddo framework antes da próxima etapa.
O que cada skill não faz
termfynão implementa, orquestra.termfy-initnão escreve oCLISPEC.mddo produto, passa paratermfy-clispec.termfy-clispecnão planeja tarefas, descreve o binário e cria as specs iniciais.termfy-specetermfy-api-importnão implementam, descrevem e conferem.termfy-databasesó entra quando você solicita armazenamento local, o esqueleto guarda apenas settings e credenciais.- As skills de implementação não inventam requisitos nem marcam itens no
CLISPEC.md, o que falta vai para## Notesda spec. termfy-reviewnão edita, relata.termfy-docsnão documenta o framework nem as skills, documenta o binário.- Só
termfy-releasefaz commit, tag e release. Ela faz isso quando a você solicita a publicação.