Entrada do Usuário
$ARGUMENTS
Você DEVE considerar a entrada do usuário antes de prosseguir (se não estiver vazia).
Guarda de Escopo
O trabalho deste comando é limitado a atualizar a própria constituição do projeto. Templates e comandos dependentes leem a constituição em tempo de execução e não são modificados aqui.
- Classifique cada parte da entrada do usuário como conteúdo da constituição ou uma intenção separada e não relacionada à governança.
- Se a entrada incluir solicitações de implementação de funcionalidades, geração de código, refatoração, construção ou deploy, você NÃO DEVE executá-las. Extraia-as como intenções adiadas.
- Você NÃO DEVE criar, modificar ou excluir arquivos fonte do aplicativo, rotas de funcionalidades, componentes, testes, arquivos de deploy ou outros artefatos não relacionados ao fluxo de trabalho da constituição.
- Se não estiver claro se uma instrução é conteúdo da constituição, peça esclarecimento antes de fazer alterações.
- Após concluir a atualização da constituição, inclua uma seção
Próximas Açõespara cada intenção adiada. Liste a intenção original e sugira o comando apropriado do Spec Kit, como/speckit-specify, sem invocá-lo. - Se não houver intenções não relacionadas à governança, omita a seção
Próximas Ações.
Verificações Pré-Execução
Verificar hooks de extensão (antes da atualização da constituição):
- Verifique se
.specify/extensions.ymlexiste na raiz do projeto. - Se existir, leia-o e procure por entradas sob a chave
hooks.before_constitution. - Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário
que
.specify/extensions.ymlnão pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali; em seguida, continue normalmente. - Filtre hooks onde
enabledé explicitamentefalse. Trate hooks sem um campoenabledcomo habilitados por padrão. - Para cada hook restante, não tente interpretar ou avaliar expressões de
conditiondo hook:- Se o hook não tiver um campo
condition, ou ele for nulo/vazio, trate o hook como executável. - Se o hook definir uma
conditionnão vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
- Se o hook não tiver um campo
- Ao construir invocações de comando a partir de nomes de comando do hook, substitua pontos (
.) por hífens (-). Por exemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook executável, produza a seguinte saída com base em sua flag
optional:- Hook opcional (
optional: true):## Extension Hooks **Pre-Hook Opcional**: {extension} Comando: `/{command}` Descrição: {description} Prompt: {prompt} Para executar: `/{command}` - Hook obrigatório (
optional: false):
Após emitir o bloco acima, você DEVE realmente invocar o hook e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você mesmo executaria o comando nesta sessão/agente (a invocação pode ser diferente do ID literal## Extension Hooks **Pre-Hook Automático**: {extension} Executando: `/{command}` EXECUTE_COMMAND: {command} Aguarde o resultado do comando do hook antes de prosseguir para o Rascunho.{command}mostrado acima, por exemplo, um agente em modo skills executa como/skill:speckit-...ou$speckit-...). Apenas emitir o bloco não executa o hook.
- Hook opcional (
- Se nenhum hook estiver registrado ou
.specify/extensions.ymlnão existir, ignore silenciosamente.
Rascunho
Você está atualizando a constituição do projeto em .specify/memory/constitution.md. O scaffold
ativo da constituição é resolvido em tempo de comando a partir de constitution-template através
da pilha de resolução de presets/templates do Spec Kit.
Siga este fluxo de execução:
-
Execute
.specify/scripts/bash/resolve-template.sh constitution-template --jsona partir da raiz do repositório e analiseTEMPLATE_CONTENTcomo o template ativo.- O resolvedor compartilhado aplica substituições do projeto, compondo camadas de preset, e camadas de extensão antes do fallback para o template principal. Ele DEVE ser bem-sucedido antes de continuar.
- Se falhar, pare e reporte o erro de resolução; não continue com apenas uma camada contribuinte.
- Se
.specify/memory/constitution.mdexistir, carregue-o como a fonte dos valores e alterações atuais específicas do projeto. Preserve informações que ainda são aplicáveis ao aplicar o novo scaffold resolvido. - Se não existir, use o template resolvido como documento inicial.
- Não escreva de volta em nenhuma camada de template versionado.
- Identifique cada token de espaço reservado no formato
[ALL_CAPS_IDENTIFIER]. IMPORTANTE: O usuário pode precisar de menos ou mais princípios do que os usados no template. Se um número for especificado, respeite-o – siga o template geral. Você atualizará o documento de acordo.
-
Colete/derive valores para os espaços reservados:
- Se a entrada do usuário (conversa) fornecer um valor, use-o.
- Caso contrário, infira a partir do contexto existente do repositório (README, docs, versões anteriores da constituição, se embutidas).
- Para datas de governança:
RATIFICATION_DATEé a data de adoção original (se desconhecida, pergunte ou marque como TODO),LAST_AMENDED_DATEé hoje se alterações forem feitas, caso contrário, mantenha a anterior. CONSTITUTION_VERSIONdeve ser incrementada de acordo com as regras de versionamento semântico:- MAJOR: Remoções ou redefinições de governança/princípios incompatíveis com versões anteriores.
- MINOR: Novo princípio/seção adicionado ou orientação materialmente expandida.
- PATCH: Esclarecimentos, correções de redação, refinamentos não semânticos.
- Se o tipo de incremento for ambíguo, proponha a justificativa antes de finalizar.
-
Elabore o conteúdo atualizado da constituição usando o template resolvido como estrutura necessária:
- Substitua cada espaço reservado por texto concreto (nenhum token entre colchetes restante, exceto slots de template intencionalmente retidos que o projeto optou por não definir ainda — justifique explicitamente qualquer retenção).
- Preserve a hierarquia de cabeçalhos e os comentários podem ser removidos uma vez substituídos, a menos que ainda adicionem orientação esclarecedora.
- Garanta que cada seção de Princípio tenha: uma linha de nome sucinta, um parágrafo (ou lista de marcadores) capturando regras inegociáveis, e uma justificativa explícita se não for óbvia.
- Garanta que a seção de Governança liste o procedimento de emenda, a política de versionamento e as expectativas de revisão de conformidade.
-
Produza um Relatório de Impacto de Sincronização como um comentário HTML no topo do arquivo de constituição após a atualização. Este relatório é material de rascunho temporário para revisão humana da emenda, não conteúdo de governança; espera-se que seja removido antes do arquivo de constituição alterado ser commitado.
- Mudança de versão: antiga → nova
- Lista de princípios modificados (título antigo → título novo, se renomeado)
- Seções adicionadas
- Seções removidas
- TODOs de acompanhamento se algum espaço reservado foi intencionalmente adiado.
-
Validação antes da saída final:
- Nenhum token entre colchetes inexplicado restante.
- Linha de versão corresponde ao relatório.
- Datas no formato ISO AAAA-MM-DD.
- Princípios são declarativos, testáveis e livres de linguagem vaga ("deveria" → substituir por DEVE/DEVERIA com justificativa, quando apropriado).
-
Escreva a constituição completa de volta em
.specify/memory/constitution.md(sobrescreva). -
Produza um resumo final para o usuário com:
- Nova versão e justificativa do incremento.
- Quaisquer espaços reservados TODO ou itens adiados que exijam acompanhamento manual.
- Mensagem de commit sugerida (por exemplo,
docs: alterar constituição para vX.Y.Z (adições de princípios + atualização de governança)). - Uma seção
Próximas Açõespara quaisquer intenções adiadas não relacionadas à governança.
Requisitos de Formatação e Estilo:
- Use cabeçalhos Markdown exatamente como no template (não rebaixe/eleve níveis).
- Quebre linhas longas de justificativa para manter a legibilidade (idealmente <100 caracteres), mas não force com quebras estranhas.
- Mantenha uma única linha em branco entre as seções.
- Evite espaços em branco à direita.
Se o usuário fornecer atualizações parciais (por exemplo, apenas uma revisão de princípio), ainda assim execute as etapas de validação e decisão de versão.
Se informações críticas estiverem faltando (por exemplo, data de ratificação realmente desconhecida),
insira TODO(<NOME_DO_CAMPO>): explicação e inclua no Relatório de Impacto de Sincronização sob
itens adiados.
Escreva apenas .specify/memory/constitution.md; não crie ou modifique arquivos fonte do template.
Verificações Pós-Execução
Verificar hooks de extensão (após a atualização da constituição):
Verifique se .specify/extensions.yml existe na raiz do projeto.
- Se existir, leia-o e procure por entradas sob a chave
hooks.after_constitution. - Se o YAML não puder ser analisado ou for inválido, não ignore silenciosamente: informe ao usuário
que
.specify/extensions.ymlnão pôde ser lido (inclua o erro do analisador) e que nenhum hook foi verificado, incluindo quaisquer hooks obrigatórios (optional: false) registrados ali; em seguida, continue normalmente. - Filtre hooks onde
enabledé explicitamentefalse. Trate hooks sem um campoenabledcomo habilitados por padrão. - Para cada hook restante, não tente interpretar ou avaliar expressões de
conditiondo hook:- Se o hook não tiver um campo
condition, ou ele for nulo/vazio, trate o hook como executável. - Se o hook definir uma
conditionnão vazia, pule o hook e deixe a avaliação da condição para a implementação do HookExecutor.
- Se o hook não tiver um campo
- Ao construir invocações de comando a partir de nomes de comando do hook, substitua pontos (
.) por hífens (-). Por exemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook executável, produza a seguinte saída com base em sua flag
optional:- Hook opcional (
optional: true):## Extension Hooks **Hook Opcional**: {extension} Comando: `/{command}` Descrição: {description} Prompt: {prompt} Para executar: `/{command}` - Hook obrigatório (
optional: false):
Após emitir o bloco acima, você DEVE realmente invocar o hook e aguardar sua conclusão antes de continuar. Execute-o da mesma forma que você mesmo executaria o comando nesta sessão/agente (a invocação pode ser diferente do ID literal## Extension Hooks **Hook Automático**: {extension} Executando: `/{command}` EXECUTE_COMMAND: {command}{command}mostrado acima, por exemplo, um agente em modo skills executa como/skill:speckit-...ou$speckit-...). Apenas emitir o bloco não executa o hook.
- Hook opcional (
- Se nenhum hook estiver registrado ou
.specify/extensions.ymlnão existir, ignore silenciosamente.