@dynamicworks/br-openspec 1.3.1 → 2.0.1

package/README.pt-BR.md

@@ -1,212 +1,212 @@
-<p align="center">
-  <a href="https://github.com/dynamicworks-com-br/BR-OpenSpec">
-    <picture>
-      <source srcset="assets/openspec_bg.png">
-      <img src="assets/openspec_bg.png" alt="OpenSpec logo">
-    </picture>
-  </a>
-</p>
-
-<p align="center">
-  <a href="https://github.com/dynamicworks-com-br/BR-OpenSpec/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/dynamicworks-com-br/BR-OpenSpec/actions/workflows/ci.yml/badge.svg" /></a>
-  <a href="https://www.npmjs.com/package/@dynamicworks/br-openspec"><img alt="npm version" src="https://img.shields.io/npm/v/@dynamicworks/br-openspec?style=flat-square" /></a>
-  <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>
-</p>
-
-<details>
-<summary><strong>O framework de spec mais querido.</strong></summary>
-
-[![Stars](https://img.shields.io/github/stars/dynamicworks-com-br/BR-OpenSpec?style=flat-square&label=Stars)](https://github.com/dynamicworks-com-br/BR-OpenSpec/stargazers)
-[![Downloads](https://img.shields.io/npm/dm/@dynamicworks/br-openspec?style=flat-square&label=Downloads/mo)](https://www.npmjs.com/package/@dynamicworks/br-openspec)
-[![Contributors](https://img.shields.io/github/contributors/dynamicworks-com-br/BR-OpenSpec?style=flat-square&label=Contributors)](https://github.com/dynamicworks-com-br/BR-OpenSpec/graphs/contributors)
-
-</details>
-<p></p>
-Nossa filosofia:
-
-> Esta filosofia foi definida pelo projeto original [OpenSpec](https://github.com/tab-tools/openspec) e o BR-OpenSpec fará o possível para honrá-la em cada decisão.
-
-```text
-→ fluido, não rígido
-→ iterativo, não em cascata
-→ simples, não complexo
-→ feito para brownfield, não apenas greenfield
-→ escalável de projetos pessoais a empresas
-```
-
-> [!TIP]
-> **Novo fluxo de trabalho disponível!** Reconstruímos o BR-OpenSpec com um novo fluxo de trabalho guiado por artefatos.
->
-> Execute `/opsx:propose "sua ideia"` para começar. → [Saiba mais aqui](docs/pt-BR/opsx.md)
-
-<p align="center">
-  Siga <a href="https://x.com/0xTab">@0xTab no X</a> para atualizações.
-</p>
-
-<!-- TODO: Add GIF demo of /opsx:propose → /opsx:archive workflow -->
-
-## Veja em ação
-
-```text
-Você: /opsx:propose add-dark-mode
-IA:   Criado openspec/changes/add-dark-mode/
-      ✓ proposal.md — por que estamos fazendo isso, o que está mudando
-      ✓ specs/       — requisitos e cenários
-      ✓ design.md    — abordagem técnica
-      ✓ tasks.md     — checklist de implementação
-      Pronto para implementação!
-
-Você: /opsx:apply
-IA:   Implementando tarefas...
-      ✓ 1.1 Adicionar provedor de contexto de tema
-      ✓ 1.2 Criar componente de alternância
-      ✓ 2.1 Adicionar variáveis CSS
-      ✓ 2.2 Conectar localStorage
-      Todas as tarefas concluídas!
-
-Você: /opsx:archive
-IA:   Arquivado em openspec/changes/archive/2025-01-23-add-dark-mode/
-      Specs atualizadas. Pronto para a próxima funcionalidade.
-```
-
-<details>
-<summary><strong>Dashboard do BR-OpenSpec</strong></summary>
-
-<p align="center">
-  <img src="assets/openspec_dashboard.png" alt="OpenSpec dashboard preview" width="90%">
-</p>
-
-</details>
-
-## Início Rápido
-
-**Requer Node.js 20.19.0 ou superior.**
-
-Instale o BR-OpenSpec globalmente:
-
-```bash
-npm install -g @dynamicworks/br-openspec@latest
-```
-
-Em seguida, navegue até o diretório do seu projeto e inicialize:
-
-```bash
-cd your-project
-openspec init
-```
-
-Agora diga à sua IA: `/opsx:propose <o-que-você-quer-construir>`
-
-Se você quiser o fluxo de trabalho expandido (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:sync`, `/opsx:bulk-archive`, `/opsx:onboard`), selecione-o com `openspec config profile` e aplique com `openspec update`.
-
-> [!NOTE]
-> Não tem certeza se sua ferramenta é suportada? [Veja a lista completa](docs/pt-BR/supported-tools.md) – suportamos mais de 25 ferramentas e crescendo.
->
-> Também funciona com pnpm, yarn, bun e nix. [Veja as opções de instalação](docs/pt-BR/installation.md).
-
-## Documentação
-
-→ **[Primeiros Passos](docs/pt-BR/getting-started.md)**: primeiros passos<br>
-→ **[Fluxos de Trabalho](docs/pt-BR/workflows.md)**: combinações e padrões<br>
-→ **[Comandos](docs/pt-BR/commands.md)**: slash commands e skills<br>
-→ **[CLI](docs/pt-BR/cli.md)**: referência do terminal<br>
-→ **[Ferramentas Suportadas](docs/pt-BR/supported-tools.md)**: integrações e caminhos de instalação<br>
-→ **[Conceitos](docs/pt-BR/concepts.md)**: como tudo se encaixa<br>
-→ **[Multi-Idioma](docs/pt-BR/multi-language.md)**: suporte a múltiplos idiomas<br>
-→ **[Personalização](docs/pt-BR/customization.md)**: faça do seu jeito
-
-
-## Por que o BR-OpenSpec?
-
-Assistentes de codificação com IA são poderosos, mas imprevisíveis quando os requisitos vivem apenas no histórico do chat. O BR-OpenSpec adiciona uma camada leve de especificação para que você concorde sobre o que construir antes de qualquer código ser escrito.
-
-> **Por que este fork?** O BR-OpenSpec é mantido em **Português Brasileiro** e destina-se a quem implementa e mantém projetos com domínios de negócio primariamente em pt-BR, bem como a quem não tem o inglês como língua nativa. Ter specs, propostas e tarefas no idioma do time e do negócio reduz o risco de interpretações erradas e acelera o alinhamento entre humanos e IA.
-
-- **Alinhe antes de construir** — humano e IA alinham as specs antes de o código ser escrito
-- **Mantenha-se organizado** — cada mudança tem sua própria pasta com proposta, specs, design e tarefas
-- **Trabalhe com fluidez** — atualize qualquer artefato a qualquer momento, sem fases rígidas
-- **Use suas ferramentas** — funciona com mais de 20 assistentes de IA via slash commands
-
-### Como nos comparamos
-
-**vs. [Spec Kit](https://github.com/github/spec-kit)** (GitHub) — Completo, mas pesado. Fases rígidas, muito Markdown, configuração em Python. O BR-OpenSpec é mais leve e permite iterar livremente.
-
-**vs. [Kiro](https://kiro.dev)** (AWS) — Poderoso, mas você fica preso à IDE deles e limitado aos modelos Claude. O BR-OpenSpec funciona com as ferramentas que você já usa.
-
-**vs. nada** — Codificação com IA sem specs significa prompts vagos e resultados imprevisíveis. O BR-OpenSpec traz previsibilidade sem a burocracia.
-
-## Atualizando o BR-OpenSpec
-
-**Atualize o pacote**
-
-```bash
-npm install -g @dynamicworks/br-openspec@latest
-```
-
-**Atualize as instruções do agente**
-
-Execute dentro de cada projeto para regenerar a orientação da IA e garantir que os slash commands mais recentes estejam ativos:
-
-```bash
-openspec update
-```
-
-**Gerenciar configurações de IDE/Code Agent**
-
-Adicione ou remova integrações de IDE e Code Agent suportadas sem precisar executar `init` novamente:
-
-```bash
-openspec tools            # lista interativa
-openspec tools --add claude,cursor
-openspec tools --remove windsurf
-```
-
-## Notas de Uso
-
-**Seleção de modelo**: O BR-OpenSpec funciona melhor com modelos de alto raciocínio. Recomendamos Opus 4.5 e GPT 5.2 tanto para planejamento quanto para implementação.
-
-**Higiene de contexto**: O BR-OpenSpec se beneficia de uma janela de contexto limpa. Limpe seu contexto antes de iniciar a implementação e mantenha uma boa higiene de contexto ao longo da sua sessão.
-
-## Contribuindo
-
-**Pequenas correções** — Correções de bugs, erros de digitação e melhorias menores podem ser enviadas diretamente como PRs.
-
-**Mudanças maiores** — Para novas funcionalidades, refatorações significativas ou mudanças arquiteturais, envie primeiro uma proposta de mudança do BR-OpenSpec para que possamos alinhar a intenção e os objetivos antes de começar a implementação.
-
-Ao escrever propostas, tenha em mente a filosofia do BR-OpenSpec: servimos a uma grande variedade de usuários em diferentes agentes de codificação, modelos e casos de uso. As mudanças devem funcionar bem para todos.
-
-**Código gerado por IA é bem-vindo** — desde que tenha sido testado e verificado. PRs contendo código gerado por IA devem mencionar o agente de codificação e o modelo usado (ex.: "Gerado com Claude Code usando claude-opus-4-5-20251101").
-
-### Desenvolvimento
-
-- Instalar dependências: `pnpm install`
-- Compilar: `pnpm run build`
-- Testar: `pnpm test`
-- Desenvolver CLI localmente: `pnpm run dev` ou `pnpm run dev:cli`
-- Commits convencionais (uma linha): `type(scope): subject`
-
-## Outros
-
-<details>
-<summary><strong>Telemetria</strong></summary>
-
-O BR-OpenSpec coleta estatísticas de uso anônimas.
-
-Coletamos apenas nomes de comandos e versão para entender padrões de uso. Sem argumentos, caminhos, conteúdo ou PII. Desativado automaticamente em CI.
-
-**Desativar:** `export OPENSPEC_TELEMETRY=0` ou `export DO_NOT_TRACK=1`
-
-</details>
-
-<details>
-<summary><strong>Mantenedores e Consultores</strong></summary>
-
-Veja [MAINTAINERS.md](MAINTAINERS.md) para a lista de mantenedores principais e consultores que ajudam a guiar o projeto.
-
-</details>
-
-
-
-## Licença
-
-MIT
+<p align="center">
+  <a href="https://github.com/dynamicworks-com-br/BR-OpenSpec">
+    <picture>
+      <source srcset="assets/openspec_bg.png">
+      <img src="assets/openspec_bg.png" alt="OpenSpec logo">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/dynamicworks-com-br/BR-OpenSpec/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/dynamicworks-com-br/BR-OpenSpec/actions/workflows/ci.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@dynamicworks/br-openspec"><img alt="npm version" src="https://img.shields.io/npm/v/@dynamicworks/br-openspec?style=flat-square" /></a>
+  <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>
+</p>
+
+<details>
+<summary><strong>O framework de spec mais querido.</strong></summary>
+
+[![Stars](https://img.shields.io/github/stars/dynamicworks-com-br/BR-OpenSpec?style=flat-square&label=Stars)](https://github.com/dynamicworks-com-br/BR-OpenSpec/stargazers)
+[![Downloads](https://img.shields.io/npm/dm/@dynamicworks/br-openspec?style=flat-square&label=Downloads/mo)](https://www.npmjs.com/package/@dynamicworks/br-openspec)
+[![Contributors](https://img.shields.io/github/contributors/dynamicworks-com-br/BR-OpenSpec?style=flat-square&label=Contributors)](https://github.com/dynamicworks-com-br/BR-OpenSpec/graphs/contributors)
+
+</details>
+<p></p>
+Nossa filosofia:
+
+> Esta filosofia foi definida pelo projeto original [OpenSpec](https://github.com/tab-tools/openspec) e o BR-OpenSpec fará o possível para honrá-la em cada decisão.
+
+```text
+→ fluido, não rígido
+→ iterativo, não em cascata
+→ simples, não complexo
+→ feito para brownfield, não apenas greenfield
+→ escalável de projetos pessoais a empresas
+```
+
+> [!TIP]
+> **Novo fluxo de trabalho disponível!** Reconstruímos o BR-OpenSpec com um novo fluxo de trabalho guiado por artefatos.
+>
+> Execute `/opsx:propose "sua ideia"` para começar. → [Saiba mais aqui](docs/pt-BR/opsx.md)
+
+<p align="center">
+  Siga <a href="https://x.com/0xTab">@0xTab no X</a> para atualizações.
+</p>
+
+<!-- TODO: Add GIF demo of /opsx:propose → /opsx:archive workflow -->
+
+## Veja em ação
+
+```text
+Você: /opsx:propose add-dark-mode
+IA:   Criado openspec/changes/add-dark-mode/
+      ✓ proposal.md — por que estamos fazendo isso, o que está mudando
+      ✓ specs/       — requisitos e cenários
+      ✓ design.md    — abordagem técnica
+      ✓ tasks.md     — checklist de implementação
+      Pronto para implementação!
+
+Você: /opsx:apply
+IA:   Implementando tarefas...
+      ✓ 1.1 Adicionar provedor de contexto de tema
+      ✓ 1.2 Criar componente de alternância
+      ✓ 2.1 Adicionar variáveis CSS
+      ✓ 2.2 Conectar localStorage
+      Todas as tarefas concluídas!
+
+Você: /opsx:archive
+IA:   Arquivado em openspec/changes/archive/2025-01-23-add-dark-mode/
+      Specs atualizadas. Pronto para a próxima funcionalidade.
+```
+
+<details>
+<summary><strong>Dashboard do BR-OpenSpec</strong></summary>
+
+<p align="center">
+  <img src="assets/openspec_dashboard.png" alt="OpenSpec dashboard preview" width="90%">
+</p>
+
+</details>
+
+## Início Rápido
+
+**Requer Node.js 20.19.0 ou superior.**
+
+Instale o BR-OpenSpec globalmente:
+
+```bash
+npm install -g @dynamicworks/br-openspec@latest
+```
+
+Em seguida, navegue até o diretório do seu projeto e inicialize:
+
+```bash
+cd your-project
+openspec init
+```
+
+Agora diga à sua IA: `/opsx:propose <o-que-você-quer-construir>`
+
+Se você quiser o fluxo de trabalho expandido (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:sync`, `/opsx:bulk-archive`, `/opsx:onboard`), selecione-o com `openspec config profile` e aplique com `openspec update`.
+
+> [!NOTE]
+> Não tem certeza se sua ferramenta é suportada? [Veja a lista completa](docs/pt-BR/supported-tools.md) – suportamos mais de 25 ferramentas e crescendo.
+>
+> Também funciona com pnpm, yarn, bun e nix. [Veja as opções de instalação](docs/pt-BR/installation.md).
+
+## Documentação
+
+→ **[Primeiros Passos](docs/pt-BR/getting-started.md)**: primeiros passos<br>
+→ **[Fluxos de Trabalho](docs/pt-BR/workflows.md)**: combinações e padrões<br>
+→ **[Comandos](docs/pt-BR/commands.md)**: slash commands e skills<br>
+→ **[CLI](docs/pt-BR/cli.md)**: referência do terminal<br>
+→ **[Ferramentas Suportadas](docs/pt-BR/supported-tools.md)**: integrações e caminhos de instalação<br>
+→ **[Conceitos](docs/pt-BR/concepts.md)**: como tudo se encaixa<br>
+→ **[Multi-Idioma](docs/pt-BR/multi-language.md)**: suporte a múltiplos idiomas<br>
+→ **[Personalização](docs/pt-BR/customization.md)**: faça do seu jeito
+
+
+## Por que o BR-OpenSpec?
+
+Assistentes de codificação com IA são poderosos, mas imprevisíveis quando os requisitos vivem apenas no histórico do chat. O BR-OpenSpec adiciona uma camada leve de especificação para que você concorde sobre o que construir antes de qualquer código ser escrito.
+
+> **Por que este fork?** O BR-OpenSpec é mantido em **Português Brasileiro** e destina-se a quem implementa e mantém projetos com domínios de negócio primariamente em pt-BR, bem como a quem não tem o inglês como língua nativa. Ter specs, propostas e tarefas no idioma do time e do negócio reduz o risco de interpretações erradas e acelera o alinhamento entre humanos e IA.
+
+- **Alinhe antes de construir** — humano e IA alinham as specs antes de o código ser escrito
+- **Mantenha-se organizado** — cada mudança tem sua própria pasta com proposta, specs, design e tarefas
+- **Trabalhe com fluidez** — atualize qualquer artefato a qualquer momento, sem fases rígidas
+- **Use suas ferramentas** — funciona com mais de 20 assistentes de IA via slash commands
+
+### Como nos comparamos
+
+**vs. [Spec Kit](https://github.com/github/spec-kit)** (GitHub) — Completo, mas pesado. Fases rígidas, muito Markdown, configuração em Python. O BR-OpenSpec é mais leve e permite iterar livremente.
+
+**vs. [Kiro](https://kiro.dev)** (AWS) — Poderoso, mas você fica preso à IDE deles e limitado aos modelos Claude. O BR-OpenSpec funciona com as ferramentas que você já usa.
+
+**vs. nada** — Codificação com IA sem specs significa prompts vagos e resultados imprevisíveis. O BR-OpenSpec traz previsibilidade sem a burocracia.
+
+## Atualizando o BR-OpenSpec
+
+**Atualize o pacote**
+
+```bash
+npm install -g @dynamicworks/br-openspec@latest
+```
+
+**Atualize as instruções do agente**
+
+Execute dentro de cada projeto para regenerar a orientação da IA e garantir que os slash commands mais recentes estejam ativos:
+
+```bash
+openspec update
+```
+
+**Gerenciar configurações de IDE/Code Agent**
+
+Adicione ou remova integrações de IDE e Code Agent suportadas sem precisar executar `init` novamente:
+
+```bash
+openspec tools            # lista interativa
+openspec tools --add claude,cursor
+openspec tools --remove windsurf
+```
+
+## Notas de Uso
+
+**Seleção de modelo**: O BR-OpenSpec funciona melhor com modelos de alto raciocínio. Recomendamos Opus 4.5 e GPT 5.2 tanto para planejamento quanto para implementação.
+
+**Higiene de contexto**: O BR-OpenSpec se beneficia de uma janela de contexto limpa. Limpe seu contexto antes de iniciar a implementação e mantenha uma boa higiene de contexto ao longo da sua sessão.
+
+## Contribuindo
+
+**Pequenas correções** — Correções de bugs, erros de digitação e melhorias menores podem ser enviadas diretamente como PRs.
+
+**Mudanças maiores** — Para novas funcionalidades, refatorações significativas ou mudanças arquiteturais, envie primeiro uma proposta de mudança do BR-OpenSpec para que possamos alinhar a intenção e os objetivos antes de começar a implementação.
+
+Ao escrever propostas, tenha em mente a filosofia do BR-OpenSpec: servimos a uma grande variedade de usuários em diferentes agentes de codificação, modelos e casos de uso. As mudanças devem funcionar bem para todos.
+
+**Código gerado por IA é bem-vindo** — desde que tenha sido testado e verificado. PRs contendo código gerado por IA devem mencionar o agente de codificação e o modelo usado (ex.: "Gerado com Claude Code usando claude-opus-4-5-20251101").
+
+### Desenvolvimento
+
+- Instalar dependências: `pnpm install`
+- Compilar: `pnpm run build`
+- Testar: `pnpm test`
+- Desenvolver CLI localmente: `pnpm run dev` ou `pnpm run dev:cli`
+- Commits convencionais (uma linha): `type(scope): subject`
+
+## Outros
+
+<details>
+<summary><strong>Telemetria</strong></summary>
+
+O BR-OpenSpec coleta estatísticas de uso anônimas.
+
+Coletamos apenas nomes de comandos e versão para entender padrões de uso. Sem argumentos, caminhos, conteúdo ou PII. Desativado automaticamente em CI.
+
+**Desativar:** `export OPENSPEC_TELEMETRY=0` ou `export DO_NOT_TRACK=1`
+
+</details>
+
+<details>
+<summary><strong>Mantenedores e Consultores</strong></summary>
+
+Veja [MAINTAINERS.md](MAINTAINERS.md) para a lista de mantenedores principais e consultores que ajudam a guiar o projeto.
+
+</details>
+
+
+
+## Licença
+
+MIT

package/bin/openspec.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-
+#!/usr/bin/env node
+
 import '../dist/cli/index.js';

package/dist/commands/feedback.js

@@ -60,10 +60,10 @@ function generateMetadata() {
     const version = getVersion();
     const platform = getPlatform();
     const timestamp = getTimestamp();
-    return `---
-${FEEDBACK_MESSAGES.submittedVia}
-${FEEDBACK_MESSAGES.versionLabel(version)}
-${FEEDBACK_MESSAGES.platformLabel(platform)}
+    return `---
+${FEEDBACK_MESSAGES.submittedVia}
+${FEEDBACK_MESSAGES.versionLabel(version)}
+${FEEDBACK_MESSAGES.platformLabel(platform)}
 ${FEEDBACK_MESSAGES.timestampLabel(timestamp)}`;
 }
 /**

package/dist/commands/schema.js

@@ -795,74 +795,74 @@ export function registerSchemaCommand(program) {
 function createDefaultTemplate(artifactId) {
     switch (artifactId) {
         case 'proposal':
-            return `## Why
-
-<!-- Describe the motivation for this change -->
-
-## What Changes
-
-<!-- Describe what will change -->
-
-## Capabilities
-
-### New Capabilities
-<!-- List new capabilities -->
-
-### Modified Capabilities
-<!-- List modified capabilities -->
-
-## Impact
-
-<!-- Describe the impact on existing functionality -->
+            return `## Why
+
+<!-- Describe the motivation for this change -->
+
+## What Changes
+
+<!-- Describe what will change -->
+
+## Capabilities
+
+### New Capabilities
+<!-- List new capabilities -->
+
+### Modified Capabilities
+<!-- List modified capabilities -->
+
+## Impact
+
+<!-- Describe the impact on existing functionality -->
 `;
         case 'specs':
-            return `## ADDED Requirements
-
-### Requirement: Example requirement
-
-Description of the requirement.
-
-#### Scenario: Example scenario
-- **WHEN** some condition
-- **THEN** some outcome
+            return `## ADDED Requirements
+
+### Requirement: Example requirement
+
+Description of the requirement.
+
+#### Scenario: Example scenario
+- **WHEN** some condition
+- **THEN** some outcome
 `;
         case 'design':
-            return `## Context
-
-<!-- Background and context -->
-
-## Goals / Non-Goals
-
-**Goals:**
-<!-- List goals -->
-
-**Non-Goals:**
-<!-- List non-goals -->
-
-## Decisions
-
-### 1. Decision Name
-
-Description and rationale.
-
-**Alternatives considered:**
-- Alternative 1: Rejected because...
-
-## Risks / Trade-offs
-
-<!-- List risks and trade-offs -->
+            return `## Context
+
+<!-- Background and context -->
+
+## Goals / Non-Goals
+
+**Goals:**
+<!-- List goals -->
+
+**Non-Goals:**
+<!-- List non-goals -->
+
+## Decisions
+
+### 1. Decision Name
+
+Description and rationale.
+
+**Alternatives considered:**
+- Alternative 1: Rejected because...
+
+## Risks / Trade-offs
+
+<!-- List risks and trade-offs -->
 `;
         case 'tasks':
-            return `## Implementation Tasks
-
-- [ ] Task 1
-- [ ] Task 2
-- [ ] Task 3
+            return `## Implementation Tasks
+
+- [ ] Task 1
+- [ ] Task 2
+- [ ] Task 3
 `;
         default:
-            return `## ${artifactId}
-
-<!-- Add content here -->
+            return `## ${artifactId}
+
+<!-- Add content here -->
 `;
     }
 }

package/dist/core/artifact-graph/instruction-loader.js

@@ -4,7 +4,7 @@ import { getSchemaDir, resolveSchema } from './resolver.js';
 import { ArtifactGraph } from './graph.js';
 import { detectCompleted } from './state.js';
 import { resolveSchemaForChange } from '../../utils/change-metadata.js';
-import { WORKFLOW_MESSAGES } from '../../messages/index.js';
+import { WORKFLOW_MESSAGES, ARTIFACT_GRAPH_MESSAGES } from '../../messages/index.js';
 import { FileSystemUtils } from '../../utils/file-system.js';
 import { readProjectConfig, validateConfigRules } from '../project-config.js';
 // Session-level cache for validation warnings (avoid repeating same warnings)
@@ -36,7 +36,7 @@ export function loadTemplate(schemaName, templatePath, projectRoot) {
     }
     const templatePathOnDisk = path.join(schemaDir, 'templates', templatePath);
     if (!fs.existsSync(templatePathOnDisk)) {
-        throw new TemplateLoadError(`Template not found: ${templatePathOnDisk}`, templatePathOnDisk);
+        throw new TemplateLoadError(ARTIFACT_GRAPH_MESSAGES.templateNotFound(templatePathOnDisk), templatePathOnDisk);
     }
     const fullPath = FileSystemUtils.canonicalizeExistingPath(templatePathOnDisk);
     try {
@@ -44,7 +44,7 @@ export function loadTemplate(schemaName, templatePath, projectRoot) {
     }
     catch (err) {
         const ioError = err instanceof Error ? err : new Error(String(err));
-        throw new TemplateLoadError(`Failed to read template: ${ioError.message}`, fullPath);
+        throw new TemplateLoadError(ARTIFACT_GRAPH_MESSAGES.failedToReadTemplate(ioError.message), fullPath);
     }
 }
 /**
@@ -93,7 +93,7 @@ export function loadChangeContext(projectRoot, changeName, schemaName) {
 export function generateInstructions(context, artifactId, projectRoot) {
     const artifact = context.graph.getArtifact(artifactId);
     if (!artifact) {
-        throw new Error(`Artifact '${artifactId}' not found in schema '${context.schemaName}'`);
+        throw new Error(ARTIFACT_GRAPH_MESSAGES.artifactNotFound(artifactId, context.schemaName));
     }
     const templateContent = loadTemplate(context.schemaName, artifact.template, context.projectRoot);
     const dependencies = getDependencyInfo(artifact, context.graph, context.completed);