@dynamicworks/br-openspec 1.3.1 → 2.0.1

package/dist/core/templates/workflows/feedback.js

@@ -2,103 +2,103 @@ export function getFeedbackSkillTemplate() {
     return {
         name: 'feedback',
         description: 'Colete e envie feedback do usuário sobre o BR-OpenSpec com enriquecimento de contexto e anonimização.',
-        instructions: `Ajude o usuário a enviar feedback sobre o BR-OpenSpec.
-
-**Objetivo**: Guie o usuário através da coleta, enriquecimento e envio de feedback enquanto garante privacidade através de anonimização.
-
-**Processo**
-
-1. **Reúna contexto da conversa**
-   - Revise o histórico recente da conversa para contexto
-   - Identifique qual tarefa estava sendo realizada
-   - Note o que funcionou bem ou mal
-   - Capture pontos de fricção específicos ou elogios
-
-2. **Elabore feedback enriquecido**
-   - Crie um título claro e descritivo (uma única frase, sem prefixo "Feedback:" necessário)
-   - Escreva um corpo que inclua:
-     - O que o usuário estava tentando fazer
-     - O que aconteceu (bom ou ruim)
-     - Contexto relevante da conversa
-     - Quaisquer sugestões ou pedidos específicos
-
-3. **Anonimize informações sensíveis**
-   - Substitua caminhos de arquivo por \`<path>\` ou descrições genéricas
-   - Substitua chaves de API, tokens, segredos por \`<redacted>\`
-   - Substitua nomes de empresa/organização por \`<company>\`
-   - Substitua nomes pessoais por \`<user>\`
-   - Substitua URLs específicas por \`<url>\` a menos que sejam públicas/relevantes
-   - Mantenha detalhes técnicos que ajudam a entender o problema
-
-4. **Apresente o rascunho para aprovação**
-   - Mostre o rascunho completo ao usuário
-   - Exiba tanto título quanto corpo claramente
-   - Peça aprovação explícita antes de enviar
-   - Permita que o usuário solicite modificações
-
-5. **Envie após confirmação**
-   - Use o comando \`openspec feedback\` para enviar
-   - Formato: \`openspec feedback "título" --body "conteúdo do corpo"\`
-   - O comando adicionará automaticamente metadados (versão, plataforma, timestamp)
-
-**Exemplo de Rascunho**
-
-\`\`\`
-Título: O tratamento de erros no workflow de artifacts precisa melhorar
-
-Corpo:
-Eu estava trabalhando na criação de uma nova change e encontrei um problema com
-o workflow de artifacts. Quando tentei continuar após criar a
-proposal, o sistema não indicou claramente que eu precisava completar
-os specs primeiro.
-
-Sugestão: Adicione mensagens de erro mais claras que expliquem as cadeias de dependência
-no workflow de artifacts. Algo como "Não é possível criar design.md
-porque os specs não estão completos (0/2 done)."
-
-Contexto: Usando o schema spec-driven com <path>/my-project
-\`\`\`
-
-**Exemplos de Anonimização**
-
-Antes:
-\`\`\`
-Trabalhando em /Users/john/mycompany/auth-service/src/oauth.ts
-Falhou com API key: sk_live_abc123xyz
-Trabalhando na Acme Corp
-\`\`\`
-
-Depois:
-\`\`\`
-Trabalhando em <path>/oauth.ts
-Falhou com API key: <redacted>
-Trabalhando na <company>
-\`\`\`
-
-**Guardrails**
-
-- DEVE mostrar o rascunho completo antes de enviar
-- DEVE pedir aprovação explícita
-- DEVE anonimizar informações sensíveis
-- PERMITE que o usuário modifique o rascunho antes de enviar
-- NÃO envie sem confirmação do usuário
-- INCLUA contexto técnico relevante
-- MANTENHA insights específicos da conversa
-
-**Confirmação do Usuário Necessária**
-
-Sempre pergunte:
-\`\`\`
-Aqui está o feedback que elaborei:
-
-Título: [título]
-
-Corpo:
-[corpo]
-
-Parece bom? Posso modificá-lo se quiser, ou enviá-lo como está.
-\`\`\`
-
+        instructions: `Ajude o usuário a enviar feedback sobre o BR-OpenSpec.
+
+**Objetivo**: Guie o usuário através da coleta, enriquecimento e envio de feedback enquanto garante privacidade através de anonimização.
+
+**Processo**
+
+1. **Reúna contexto da conversa**
+   - Revise o histórico recente da conversa para contexto
+   - Identifique qual tarefa estava sendo realizada
+   - Note o que funcionou bem ou mal
+   - Capture pontos de fricção específicos ou elogios
+
+2. **Elabore feedback enriquecido**
+   - Crie um título claro e descritivo (uma única frase, sem prefixo "Feedback:" necessário)
+   - Escreva um corpo que inclua:
+     - O que o usuário estava tentando fazer
+     - O que aconteceu (bom ou ruim)
+     - Contexto relevante da conversa
+     - Quaisquer sugestões ou pedidos específicos
+
+3. **Anonimize informações sensíveis**
+   - Substitua caminhos de arquivo por \`<path>\` ou descrições genéricas
+   - Substitua chaves de API, tokens, segredos por \`<redacted>\`
+   - Substitua nomes de empresa/organização por \`<company>\`
+   - Substitua nomes pessoais por \`<user>\`
+   - Substitua URLs específicas por \`<url>\` a menos que sejam públicas/relevantes
+   - Mantenha detalhes técnicos que ajudam a entender o problema
+
+4. **Apresente o rascunho para aprovação**
+   - Mostre o rascunho completo ao usuário
+   - Exiba tanto título quanto corpo claramente
+   - Peça aprovação explícita antes de enviar
+   - Permita que o usuário solicite modificações
+
+5. **Envie após confirmação**
+   - Use o comando \`openspec feedback\` para enviar
+   - Formato: \`openspec feedback "título" --body "conteúdo do corpo"\`
+   - O comando adicionará automaticamente metadados (versão, plataforma, timestamp)
+
+**Exemplo de Rascunho**
+
+\`\`\`
+Título: O tratamento de erros no workflow de artifacts precisa melhorar
+
+Corpo:
+Eu estava trabalhando na criação de uma nova change e encontrei um problema com
+o workflow de artifacts. Quando tentei continuar após criar a
+proposal, o sistema não indicou claramente que eu precisava completar
+os specs primeiro.
+
+Sugestão: Adicione mensagens de erro mais claras que expliquem as cadeias de dependência
+no workflow de artifacts. Algo como "Não é possível criar design.md
+porque os specs não estão completos (0/2 done)."
+
+Contexto: Usando o schema spec-driven com <path>/my-project
+\`\`\`
+
+**Exemplos de Anonimização**
+
+Antes:
+\`\`\`
+Trabalhando em /Users/john/mycompany/auth-service/src/oauth.ts
+Falhou com API key: sk_live_abc123xyz
+Trabalhando na Acme Corp
+\`\`\`
+
+Depois:
+\`\`\`
+Trabalhando em <path>/oauth.ts
+Falhou com API key: <redacted>
+Trabalhando na <company>
+\`\`\`
+
+**Guardrails**
+
+- DEVE mostrar o rascunho completo antes de enviar
+- DEVE pedir aprovação explícita
+- DEVE anonimizar informações sensíveis
+- PERMITE que o usuário modifique o rascunho antes de enviar
+- NÃO envie sem confirmação do usuário
+- INCLUA contexto técnico relevante
+- MANTENHA insights específicos da conversa
+
+**Confirmação do Usuário Necessária**
+
+Sempre pergunte:
+\`\`\`
+Aqui está o feedback que elaborei:
+
+Título: [título]
+
+Corpo:
+[corpo]
+
+Parece bom? Posso modificá-lo se quiser, ou enviá-lo como está.
+\`\`\`
+
 Só prossiga com o envio após o usuário confirmar.`,
         license: 'MIT',
         compatibility: 'Requer openspec CLI.',

package/dist/core/templates/workflows/ff-change.js

@@ -2,95 +2,95 @@ export function getFfChangeSkillTemplate() {
     return {
         name: 'openspec-ff-change',
         description: 'Avance rapidamente pela criação de artifacts do BR-OpenSpec. Use quando o usuário quiser criar rapidamente todos os artifacts necessários para implementação sem passar por cada um individualmente.',
-        instructions: `Avance rapidamente pela criação de artifacts - gere tudo o que é necessário para iniciar a implementação de uma vez só.
-
-**Entrada**: A solicitação do usuário deve incluir um nome de change (kebab-case) OU uma descrição do que ele quer construir.
-
-**Passos**
-
-1. **Se nenhuma entrada clara for fornecida, pergunte o que ele quer construir**
-
-   Use a ferramenta **AskUserQuestion** (aberta, sem opções pré-definidas) para perguntar:
-   > "Em qual change você quer trabalhar? Descreva o que quer construir ou corrigir."
-
-   A partir da descrição dele, derive um nome kebab-case (por exemplo, "adicionar autenticação de usuário" → \`add-user-auth\`).
-
-   **IMPORTANTE**: NÃO prossiga sem entender o que o usuário quer construir.
-
-2. **Crie o diretório da change**
-   \`\`\`bash
-   openspec new change "<nome>"
-   \`\`\`
-   Isso cria uma change com scaffold em \`openspec/changes/<nome>/\`.
-
-3. **Obtenha a ordem de construção dos artifacts**
-   \`\`\`bash
-   openspec status --change "<nome>" --json
-   \`\`\`
-   Analise o JSON para obter:
-   - \`applyRequires\`: array de IDs de artifacts necessários antes da implementação (por exemplo, \`["tasks"]\`)
-   - \`artifacts\`: lista de todos os artifacts com seu status e dependências
-
-4. **Crie artifacts em sequência até estar pronto para apply**
-
-   Use a ferramenta **TodoWrite** para rastrear o progresso pelos artifacts.
-
-   Percorra os artifacts em ordem de dependência (artifacts sem dependências pendentes primeiro):
-
-   a. **Para cada artifact que está \`ready\` (dependências satisfeitas)**:
-      - Obtenha instruções:
-        \`\`\`bash
-        openspec instructions <artifact-id> --change "<nome>" --json
-        \`\`\`
-      - O JSON de instruções inclui:
-        - \`context\`: Contexto do projeto (restrições para você - NÃO inclua na saída)
-        - \`rules\`: Regras específicas do artifact (restrições para você - NÃO inclua na saída)
-        - \`template\`: A estrutura a ser usada para seu arquivo de saída
-        - \`instruction\`: Orientação específica do schema para este tipo de artifact
-        - \`outputPath\`: Onde escrever o artifact
-        - \`dependencies\`: Artifacts concluídos para ler como contexto
-      - Leia quaisquer arquivos de dependências concluídos para contexto
-      - Crie o arquivo do artifact usando \`template\` como a estrutura
-      - Aplique \`context\` e \`rules\` como restrições - mas NÃO copie-os para o arquivo
-      - Mostre breve progresso: "✓ Criado <artifact-id>"
-
-   b. **Continue até todos os artifacts \`applyRequires\` estarem completos**
-      - Após criar cada artifact, reexecute \`openspec status --change "<nome>" --json\`
-      - Verifique se cada ID de artifact em \`applyRequires\` tem \`status: "done"\` no array de artifacts
-      - Pare quando todos os artifacts \`applyRequires\` estiverem done
-
-   c. **Se um artifact requerer entrada do usuário** (contexto incerto):
-      - Use a ferramenta **AskUserQuestion** para esclarecer
-      - Depois continue com a criação
-
-5. **Mostre o status final**
-   \`\`\`bash
-   openspec status --change "<nome>"
-   \`\`\`
-
-**Saída**
-
-Após completar todos os artifacts, resuma:
-- Nome da change e localização
-- Lista de artifacts criados com breves descrições
-- O que está pronto: "Todos os artifacts criados! Pronto para implementação."
-- Prompt: "Execute \`/opsx:apply\` ou peça-me para implementar para começar a trabalhar nas tarefas."
-
-**Diretrizes de Criação de Artifacts**
-
-- Siga o campo \`instruction\` de \`openspec instructions\` para cada tipo de artifact
-- O schema define o que cada artifact deve conter - siga-o
-- Leia artifacts de dependência para contexto antes de criar novos
-- Use \`template\` como a estrutura para seu arquivo de saída - preencha suas seções
-- **IMPORTANTE**: \`context\` e \`rules\` são restrições para VOCÊ, não conteúdo para o arquivo
-  - NÃO copie blocos \`<context>\`, \`<rules>\`, \`<project_context>\` para o artifact
-  - Eles guiam o que você escreve, mas nunca devem aparecer na saída
-
-**Guardrails**
-- Crie TODOS os artifacts necessários para implementação (conforme definido pelo \`apply.requires\` do schema)
-- Sempre leia artifacts de dependência antes de criar um novo
-- Se o contexto estiver criticamente incerto, pergunte ao usuário - mas prefira tomar decisões razoáveis para manter o momento
-- Se uma change com aquele nome já existir, pergunte se o usuário quer continuar ela ou criar uma nova
+        instructions: `Avance rapidamente pela criação de artifacts - gere tudo o que é necessário para iniciar a implementação de uma vez só.
+
+**Entrada**: A solicitação do usuário deve incluir um nome de change (kebab-case) OU uma descrição do que ele quer construir.
+
+**Passos**
+
+1. **Se nenhuma entrada clara for fornecida, pergunte o que ele quer construir**
+
+   Use a ferramenta **AskUserQuestion** (aberta, sem opções pré-definidas) para perguntar:
+   > "Em qual change você quer trabalhar? Descreva o que quer construir ou corrigir."
+
+   A partir da descrição dele, derive um nome kebab-case (por exemplo, "adicionar autenticação de usuário" → \`add-user-auth\`).
+
+   **IMPORTANTE**: NÃO prossiga sem entender o que o usuário quer construir.
+
+2. **Crie o diretório da change**
+   \`\`\`bash
+   openspec new change "<nome>"
+   \`\`\`
+   Isso cria uma change com scaffold em \`openspec/changes/<nome>/\`.
+
+3. **Obtenha a ordem de construção dos artifacts**
+   \`\`\`bash
+   openspec status --change "<nome>" --json
+   \`\`\`
+   Analise o JSON para obter:
+   - \`applyRequires\`: array de IDs de artifacts necessários antes da implementação (por exemplo, \`["tasks"]\`)
+   - \`artifacts\`: lista de todos os artifacts com seu status e dependências
+
+4. **Crie artifacts em sequência até estar pronto para apply**
+
+   Use a ferramenta **TodoWrite** para rastrear o progresso pelos artifacts.
+
+   Percorra os artifacts em ordem de dependência (artifacts sem dependências pendentes primeiro):
+
+   a. **Para cada artifact que está \`ready\` (dependências satisfeitas)**:
+      - Obtenha instruções:
+        \`\`\`bash
+        openspec instructions <artifact-id> --change "<nome>" --json
+        \`\`\`
+      - O JSON de instruções inclui:
+        - \`context\`: Contexto do projeto (restrições para você - NÃO inclua na saída)
+        - \`rules\`: Regras específicas do artifact (restrições para você - NÃO inclua na saída)
+        - \`template\`: A estrutura a ser usada para seu arquivo de saída
+        - \`instruction\`: Orientação específica do schema para este tipo de artifact
+        - \`outputPath\`: Onde escrever o artifact
+        - \`dependencies\`: Artifacts concluídos para ler como contexto
+      - Leia quaisquer arquivos de dependências concluídos para contexto
+      - Crie o arquivo do artifact usando \`template\` como a estrutura
+      - Aplique \`context\` e \`rules\` como restrições - mas NÃO copie-os para o arquivo
+      - Mostre breve progresso: "✓ Criado <artifact-id>"
+
+   b. **Continue até todos os artifacts \`applyRequires\` estarem completos**
+      - Após criar cada artifact, reexecute \`openspec status --change "<nome>" --json\`
+      - Verifique se cada ID de artifact em \`applyRequires\` tem \`status: "done"\` no array de artifacts
+      - Pare quando todos os artifacts \`applyRequires\` estiverem done
+
+   c. **Se um artifact requerer entrada do usuário** (contexto incerto):
+      - Use a ferramenta **AskUserQuestion** para esclarecer
+      - Depois continue com a criação
+
+5. **Mostre o status final**
+   \`\`\`bash
+   openspec status --change "<nome>"
+   \`\`\`
+
+**Saída**
+
+Após completar todos os artifacts, resuma:
+- Nome da change e localização
+- Lista de artifacts criados com breves descrições
+- O que está pronto: "Todos os artifacts criados! Pronto para implementação."
+- Prompt: "Execute \`/opsx:apply\` ou peça-me para implementar para começar a trabalhar nas tarefas."
+
+**Diretrizes de Criação de Artifacts**
+
+- Siga o campo \`instruction\` de \`openspec instructions\` para cada tipo de artifact
+- O schema define o que cada artifact deve conter - siga-o
+- Leia artifacts de dependência para contexto antes de criar novos
+- Use \`template\` como a estrutura para seu arquivo de saída - preencha suas seções
+- **IMPORTANTE**: \`context\` e \`rules\` são restrições para VOCÊ, não conteúdo para o arquivo
+  - NÃO copie blocos \`<context>\`, \`<rules>\`, \`<project_context>\` para o artifact
+  - Eles guiam o que você escreve, mas nunca devem aparecer na saída
+
+**Guardrails**
+- Crie TODOS os artifacts necessários para implementação (conforme definido pelo \`apply.requires\` do schema)
+- Sempre leia artifacts de dependência antes de criar um novo
+- Se o contexto estiver criticamente incerto, pergunte ao usuário - mas prefira tomar decisões razoáveis para manter o momento
+- Se uma change com aquele nome já existir, pergunte se o usuário quer continuar ela ou criar uma nova
 - Verifique se cada arquivo do artifact existe após escrever antes de prosseguir para o próximo`,
         license: 'MIT',
         compatibility: 'Requer openspec CLI.',
@@ -103,95 +103,95 @@ export function getOpsxFfCommandTemplate() {
         description: 'Crie uma change e gere todos os artifacts necessários para implementação de uma vez só',
         category: 'Workflow',
         tags: ['workflow', 'artifacts', 'experimental'],
-        content: `Avance rapidamente pela criação de artifacts - gere tudo o que é necessário para iniciar a implementação.
-
-**Entrada**: O argumento após \`/opsx:ff\` é o nome da change (kebab-case), OU uma descrição do que o usuário quer construir.
-
-**Passos**
-
-1. **Se nenhuma entrada for fornecida, pergunte o que ele quer construir**
-
-   Use a ferramenta **AskUserQuestion** (aberta, sem opções pré-definidas) para perguntar:
-   > "Em qual change você quer trabalhar? Descreva o que quer construir ou corrigir."
-
-   A partir da descrição dele, derive um nome kebab-case (por exemplo, "adicionar autenticação de usuário" → \`add-user-auth\`).
-
-   **IMPORTANTE**: NÃO prossiga sem entender o que o usuário quer construir.
-
-2. **Crie o diretório da change**
-   \`\`\`bash
-   openspec new change "<nome>"
-   \`\`\`
-   Isso cria uma change com scaffold em \`openspec/changes/<nome>/\`.
-
-3. **Obtenha a ordem de construção dos artifacts**
-   \`\`\`bash
-   openspec status --change "<nome>" --json
-   \`\`\`
-   Analise o JSON para obter:
-   - \`applyRequires\`: array de IDs de artifacts necessários antes da implementação (por exemplo, \`["tasks"]\`)
-   - \`artifacts\`: lista de todos os artifacts com seu status e dependências
-
-4. **Crie artifacts em sequência até estar pronto para apply**
-
-   Use a ferramenta **TodoWrite** para rastrear o progresso pelos artifacts.
-
-   Percorra os artifacts em ordem de dependência (artifacts sem dependências pendentes primeiro):
-
-   a. **Para cada artifact que está \`ready\` (dependências satisfeitas)**:
-      - Obtenha instruções:
-        \`\`\`bash
-        openspec instructions <artifact-id> --change "<nome>" --json
-        \`\`\`
-      - O JSON de instruções inclui:
-        - \`context\`: Contexto do projeto (restrições para você - NÃO inclua na saída)
-        - \`rules\`: Regras específicas do artifact (restrições para você - NÃO inclua na saída)
-        - \`template\`: A estrutura a ser usada para seu arquivo de saída
-        - \`instruction\`: Orientação específica do schema para este tipo de artifact
-        - \`outputPath\`: Onde escrever o artifact
-        - \`dependencies\`: Artifacts concluídos para ler como contexto
-      - Leia quaisquer arquivos de dependências concluídos para contexto
-      - Crie o arquivo do artifact usando \`template\` como a estrutura
-      - Aplique \`context\` e \`rules\` como restrições - mas NÃO copie-os para o arquivo
-      - Mostre breve progresso: "✓ Criado <artifact-id>"
-
-   b. **Continue até todos os artifacts \`applyRequires\` estarem completos**
-      - Após criar cada artifact, reexecute \`openspec status --change "<nome>" --json\`
-      - Verifique se cada ID de artifact em \`applyRequires\` tem \`status: "done"\` no array de artifacts
-      - Pare quando todos os artifacts \`applyRequires\` estiverem done
-
-   c. **Se um artifact requerer entrada do usuário** (contexto incerto):
-      - Use a ferramenta **AskUserQuestion** para esclarecer
-      - Depois continue com a criação
-
-5. **Mostre o status final**
-   \`\`\`bash
-   openspec status --change "<nome>"
-   \`\`\`
-
-**Saída**
-
-Após completar todos os artifacts, resuma:
-- Nome da change e localização
-- Lista de artifacts criados com breves descrições
-- O que está pronto: "Todos os artifacts criados! Pronto para implementação."
-- Prompt: "Execute \`/opsx:apply\` para começar a implementar."
-
-**Diretrizes de Criação de Artifacts**
-
-- Siga o campo \`instruction\` de \`openspec instructions\` para cada tipo de artifact
-- O schema define o que cada artifact deve conter - siga-o
-- Leia artifacts de dependência para contexto antes de criar novos
-- Use \`template\` como a estrutura para seu arquivo de saída - preencha suas seções
-- **IMPORTANTE**: \`context\` e \`rules\` são restrições para VOCÊ, não conteúdo para o arquivo
-  - NÃO copie blocos \`<context>\`, \`<rules>\`, \`<project_context>\` para o artifact
-  - Eles guiam o que você escreve, mas nunca devem aparecer na saída
-
-**Guardrails**
-- Crie TODOS os artifacts necessários para implementação (conforme definido pelo \`apply.requires\` do schema)
-- Sempre leia artifacts de dependência antes de criar um novo
-- Se o contexto estiver criticamente incerto, pergunte ao usuário - mas prefira tomar decisões razoáveis para manter o momento
-- Se uma change com aquele nome já existir, pergunte se o usuário quer continuar ela ou criar uma nova
+        content: `Avance rapidamente pela criação de artifacts - gere tudo o que é necessário para iniciar a implementação.
+
+**Entrada**: O argumento após \`/opsx:ff\` é o nome da change (kebab-case), OU uma descrição do que o usuário quer construir.
+
+**Passos**
+
+1. **Se nenhuma entrada for fornecida, pergunte o que ele quer construir**
+
+   Use a ferramenta **AskUserQuestion** (aberta, sem opções pré-definidas) para perguntar:
+   > "Em qual change você quer trabalhar? Descreva o que quer construir ou corrigir."
+
+   A partir da descrição dele, derive um nome kebab-case (por exemplo, "adicionar autenticação de usuário" → \`add-user-auth\`).
+
+   **IMPORTANTE**: NÃO prossiga sem entender o que o usuário quer construir.
+
+2. **Crie o diretório da change**
+   \`\`\`bash
+   openspec new change "<nome>"
+   \`\`\`
+   Isso cria uma change com scaffold em \`openspec/changes/<nome>/\`.
+
+3. **Obtenha a ordem de construção dos artifacts**
+   \`\`\`bash
+   openspec status --change "<nome>" --json
+   \`\`\`
+   Analise o JSON para obter:
+   - \`applyRequires\`: array de IDs de artifacts necessários antes da implementação (por exemplo, \`["tasks"]\`)
+   - \`artifacts\`: lista de todos os artifacts com seu status e dependências
+
+4. **Crie artifacts em sequência até estar pronto para apply**
+
+   Use a ferramenta **TodoWrite** para rastrear o progresso pelos artifacts.
+
+   Percorra os artifacts em ordem de dependência (artifacts sem dependências pendentes primeiro):
+
+   a. **Para cada artifact que está \`ready\` (dependências satisfeitas)**:
+      - Obtenha instruções:
+        \`\`\`bash
+        openspec instructions <artifact-id> --change "<nome>" --json
+        \`\`\`
+      - O JSON de instruções inclui:
+        - \`context\`: Contexto do projeto (restrições para você - NÃO inclua na saída)
+        - \`rules\`: Regras específicas do artifact (restrições para você - NÃO inclua na saída)
+        - \`template\`: A estrutura a ser usada para seu arquivo de saída
+        - \`instruction\`: Orientação específica do schema para este tipo de artifact
+        - \`outputPath\`: Onde escrever o artifact
+        - \`dependencies\`: Artifacts concluídos para ler como contexto
+      - Leia quaisquer arquivos de dependências concluídos para contexto
+      - Crie o arquivo do artifact usando \`template\` como a estrutura
+      - Aplique \`context\` e \`rules\` como restrições - mas NÃO copie-os para o arquivo
+      - Mostre breve progresso: "✓ Criado <artifact-id>"
+
+   b. **Continue até todos os artifacts \`applyRequires\` estarem completos**
+      - Após criar cada artifact, reexecute \`openspec status --change "<nome>" --json\`
+      - Verifique se cada ID de artifact em \`applyRequires\` tem \`status: "done"\` no array de artifacts
+      - Pare quando todos os artifacts \`applyRequires\` estiverem done
+
+   c. **Se um artifact requerer entrada do usuário** (contexto incerto):
+      - Use a ferramenta **AskUserQuestion** para esclarecer
+      - Depois continue com a criação
+
+5. **Mostre o status final**
+   \`\`\`bash
+   openspec status --change "<nome>"
+   \`\`\`
+
+**Saída**
+
+Após completar todos os artifacts, resuma:
+- Nome da change e localização
+- Lista de artifacts criados com breves descrições
+- O que está pronto: "Todos os artifacts criados! Pronto para implementação."
+- Prompt: "Execute \`/opsx:apply\` para começar a implementar."
+
+**Diretrizes de Criação de Artifacts**
+
+- Siga o campo \`instruction\` de \`openspec instructions\` para cada tipo de artifact
+- O schema define o que cada artifact deve conter - siga-o
+- Leia artifacts de dependência para contexto antes de criar novos
+- Use \`template\` como a estrutura para seu arquivo de saída - preencha suas seções
+- **IMPORTANTE**: \`context\` e \`rules\` são restrições para VOCÊ, não conteúdo para o arquivo
+  - NÃO copie blocos \`<context>\`, \`<rules>\`, \`<project_context>\` para o artifact
+  - Eles guiam o que você escreve, mas nunca devem aparecer na saída
+
+**Guardrails**
+- Crie TODOS os artifacts necessários para implementação (conforme definido pelo \`apply.requires\` do schema)
+- Sempre leia artifacts de dependência antes de criar um novo
+- Se o contexto estiver criticamente incerto, pergunte ao usuário - mas prefira tomar decisões razoáveis para manter o momento
+- Se uma change com aquele nome já existir, pergunte se o usuário quer continuar ela ou criar uma nova
 - Verifique se cada arquivo do artifact existe após escrever antes de prosseguir para o próximo`
     };
 }