Perfis

Escolha quais fluxos de trabalho são instalados e se eles são instalados como skills, comandos ou ambos.

Um perfil é sua preferência sobre quais fluxos de trabalho do OpenSpec (as skills e os comandos na sua ferramenta de IA) são instalados em sua máquina. O perfil padrão é core. Inclua ou exclua fluxos de trabalho e sua seleção será salva como o perfil custom.

O conjunto core

O perfil core instala seis fluxos de trabalho, cobrindo todo o ciclo, da ideia ao arquivamento:

Fluxo de trabalho	Para que serve
explore	Pense a fundo em uma ideia antes que ela se torne uma proposta de mudança
propose	Crie uma proposta de mudança e gere todos os seus artefatos de planejamento em uma única etapa
apply	Implemente as tarefas de uma proposta de mudança
update	Revise os artefatos de planejamento existentes de uma proposta de mudança
sync	Mescle as atualizações de spec de uma proposta de mudança em specs/ sem arquivá-la
archive	Mova uma proposta de mudança concluída para o arquivo

Cada um tem um link para seu contrato completo: argumentos, o que ele cria e como ele responde.

Expandindo o conjunto: fluxos de trabalho opcionais

Há mais seis fluxos de trabalho disponíveis além do conjunto core. Três deles (new, continue, ff) criam uma proposta de mudança artefato por artefato, em vez de tudo de uma vez como propose.

Fluxo de trabalho	Para que serve
new	Comece uma proposta de mudança como uma estrutura inicial vazia
continue	Crie o próximo artefato de planejamento em uma proposta de mudança, um de cada vez
ff	Crie uma proposta de mudança e todos os artefatos de planejamento de que a implementação precisa, em uma única passagem
verify	Verifique se a implementação corresponde aos artefatos da proposta de mudança
bulk-archive	Arquive várias propostas de mudança de uma vez
onboard	Aprenda o fluxo de trabalho fazendo uma proposta de mudança real do início ao fim

Para alterar o conjunto, execute o seletor interativo:

openspec config profile

O seletor pergunta o que configurar (entrega, fluxos de trabalho ou ambos) e, em seguida, lista todos os doze fluxos de trabalho como caixas de seleção, com os instalados marcados. Qualquer seleção que não seja exatamente os seis do core é salva como o perfil custom, então você também pode desmarcar fluxos de trabalho do core que não usa.

Entrega: skills, comandos ou ambos

A entrega é uma configuração de perfil que permite escolher instalar apenas skills ou apenas comandos. O padrão é both. A configuração do seu projeto explica as duas formas e por que ambas existem. O contrato exato desse campo está em Configurações da CLI (config.json).

Duas maneiras de alterá-la:

Interativamente: execute openspec config profile e escolha "Delivery only". Veja como alternar para apenas skills:

Current profile settings
  Delivery: both

? What do you want to configure? Delivery only
? Delivery mode (how workflows are installed): Skills only

Config changes:
  delivery: both -> skills
? Apply changes to this project now? (Y/n) y

Diretamente: um comando, sem prompts:

openspec config set delivery skills   # ou: both, commands

A entrega nunca altera o nome do perfil. core e custom descrevem apenas o conjunto de fluxos de trabalho, e voltar para core mantém sua configuração de entrega.

Alternando perfis

A alternância tem duas etapas: altere o perfil na sua máquina e depois atualize cada projeto para aplicá-lo.

1. Altere o perfil:

   openspec config profile        # interativo
   openspec config profile core   # redefinir para os seis do core (mantém a entrega)

2. Execute a atualização em cada projeto em que você trabalha:

   openspec update

Quando seu diretório atual é um projeto OpenSpec existente, o fluxo interativo oferece executar a etapa 2 ali para você.