context-first-cli 1.5.8 → 1.6.0

package/dist/templates/commands/engineer/plan.md

@@ -6,6 +6,15 @@ Este comando cria o plano técnico detalhado para implementação da feature.
 
 - PRD criado via `/spec`
 - Análise inicial feita via `/start`
+- Arquivos `context.md` e `architecture.md` criados e aprovados
+
+## ⚠️ IMPORTANTE: Arquivos Imutáveis
+
+**Este comando deve LER mas NÃO MODIFICAR:**
+- ✅ **LER** `.sessions/<ISSUE-ID>/context.md` (imutável)
+- ✅ **LER** `.sessions/<ISSUE-ID>/architecture.md` (imutável)
+- ✅ **CRIAR** `.sessions/<ISSUE-ID>/plan.md` (mutável - será atualizado durante `/work`)
+- ❌ **NÃO modificar `context.md` ou `architecture.md`**
 
 ## 📚 Carregar MetaSpecs
 

package/dist/templates/commands/engineer/start.md

@@ -13,6 +13,7 @@ Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
    - Contexto de negócio
    - Stack, arquitetura e padrões técnicos
    - Convenções do projeto
+   - ADRs (Architecture Decision Records)
 
 ## 🎯 Contexto do Projeto
 
@@ -77,34 +78,154 @@ Após análise inicial, formule **3-5 clarificações mais importantes**:
 - Qual a ordem de implementação recomendada?
 - Há impacto em APIs ou contratos entre serviços?
 
-## 📝 Documentação da Sessão
+## 💾 Criação do Context.md
 
-Crie arquivo `./.sessions/<ISSUE-ID>/start.md` com:
+**IMPORTANTE**: Este arquivo é **IMUTÁVEL** após aprovação. Não deve ser modificado por comandos subsequentes.
+
+Crie arquivo `./.sessions/<ISSUE-ID>/context.md` com:
 
 ```markdown
-# [Título da Feature] - Início
+# Context: [Nome da Feature]
+
+## Por Que
+[Valor de negócio, persona atendida, métrica impactada]
+
+## O Que
+[Funcionalidades principais, comportamento esperado]
 
-## Entendimento
-[Resumo do que será construído e por quê]
+## Como
+[Abordagem técnica, componentes, repositórios afetados]
 
-## Repositórios Afetados
-- **repo-1**: [O que será feito]
-- **repo-2**: [O que será feito]
+## Validação contra Metaspecs
+- [x] Alinhado com estratégia de produto
+- [x] Atende persona correta
+- [x] Métrica impactada documentada
+- [x] Usa stack aprovada
+- [x] Respeita ADRs
+- [x] Sem conflitos com limitações conhecidas
 
-## Perguntas Pendentes
-1. [Pergunta 1]
-2. [Pergunta 2]
+## Dependências
+[Bibliotecas, APIs, componentes existentes]
 
-## Validações Realizadas
-- [x] Alinhado com estratégia
-- [x] Stack aprovada
-- [ ] Pendente: [algo a validar]
+## Restrições
+[Limitações técnicas, performance targets, budget]
 
-## Próximos Passos
-1. Aguardar respostas das perguntas
-2. Executar `/plan` para planejamento técnico detalhado
+## Testes
+[E2E críticos, unit tests necessários, cobertura esperada]
 ```
 
+**Após criar `context.md`, peça revisão e aprovação do usuário antes de prosseguir.**
+
+---
+
+## 🏗️ Criação do Architecture.md
+
+**IMPORTANTE**: Este arquivo é **IMUTÁVEL** após aprovação. Não deve ser modificado por comandos subsequentes.
+
+### Princípios Arquiteturais (OBRIGATÓRIO)
+
+**ANTES de criar a arquitetura, você DEVE:**
+
+1. **Ler ADRs (Architecture Decision Records)**:
+   - Liste ADRs em metaspecs
+   - Leia TODOS os ADRs relevantes para a feature
+   - Identifique restrições e padrões obrigatórios
+
+2. **Consultar padrões arquiteturais**:
+   - Leia guias de estrutura do projeto em metaspecs
+   - Leia padrões de código em metaspecs
+   - Identifique padrões existentes no código (use Glob/Grep para encontrar exemplos similares)
+
+3. **Validar compliance com ADRs**:
+   - Para cada ADR relevante, verifique se a solução proposta respeita as decisões
+   - Documente compliance no architecture.md
+   - Se houver violação, justifique ou proponha correção
+
+4. **Analisar código existente**:
+   - Use Glob/Grep para encontrar componentes/módulos similares
+   - Entenda padrões e estruturas existentes
+   - Alinhe nova implementação com padrões do projeto
+
+### Estrutura do Documento de Arquitetura
+
+Crie arquivo `./.sessions/<ISSUE-ID>/architecture.md` com:
+
+```markdown
+# Architecture: [Nome da Feature]
+
+## Visão Geral
+[Visão de alto nível do sistema antes e depois da mudança]
+
+## Componentes Afetados
+[Lista de componentes e suas relações, dependências]
+
+### Diagrama de Componentes
+[Descrição textual ou diagrama Mermaid dos componentes]
+
+### Fluxo de Dados
+1. [Passo 1 do fluxo]
+2. [Passo 2 do fluxo]
+3. [Passo 3 do fluxo]
+
+## Estrutura de Diretórios Proposta
+[Baseada em padrões do projeto]
+
+```
+repo-1/
+├── src/
+│   ├── components/
+│   │   └── NewComponent.tsx (CRIAR)
+│   └── services/
+│       └── NewService.ts (CRIAR)
+```
+
+## Padrões e Melhores Práticas
+[Padrões que serão mantidos ou introduzidos]
+
+## Validação de ADRs
+[Lista de ADRs consultados e compliance]
+
+- [x] ADR-001: [Nome] - Compliant
+- [x] ADR-002: [Nome] - Compliant
+
+## Dependências Externas
+[Bibliotecas que serão usadas ou adicionadas]
+
+## Decisões Técnicas
+
+### Decisão 1: [Título]
+**Contexto**: [Por que precisamos decidir isso]
+**Opções consideradas**:
+- Opção A: [Prós e contras]
+- Opção B: [Prós e contras]
+**Decisão**: [Opção escolhida]
+**Justificativa**: [Por que escolhemos esta opção]
+
+## Restrições e Suposições
+[Limitações técnicas e premissas]
+
+## Trade-offs
+[Alternativas consideradas e por que não foram escolhidas]
+
+## Consequências
+**Positivas**:
+- [Benefício 1]
+- [Benefício 2]
+
+**Negativas**:
+- [Custo/limitação 1]
+- [Custo/limitação 2]
+
+## Arquivos Principais
+[Lista dos principais arquivos a serem editados/criados]
+
+- `repo-1/src/components/NewComponent.tsx` (CRIAR)
+- `repo-1/src/services/NewService.ts` (CRIAR)
+- `repo-2/src/controllers/NewController.ts` (CRIAR)
+```
+
+**Após criar `architecture.md`, peça revisão e aprovação do usuário antes de prosseguir.**
+
 ---
 
 **Argumentos fornecidos**:
@@ -117,10 +238,20 @@ Crie arquivo `./.sessions/<ISSUE-ID>/start.md` com:
 
 ## 🎯 Próximo Passo
 
-Após esclarecimentos e aprovação:
+**Após aprovação do usuário dos arquivos `context.md` e `architecture.md`**:
 
 ```bash
 /plan
 ```
 
 Este comando criará o planejamento técnico detalhado da implementação.
+
+---
+
+## ⚠️ IMPORTANTE: Arquivos Imutáveis
+
+**`context.md` e `architecture.md` são IMUTÁVEIS após aprovação.**
+
+- ✅ Podem ser LIDOS por comandos subsequentes (`/plan`, `/work`)
+- ❌ NÃO devem ser MODIFICADOS por nenhum comando
+- ❌ Se houver necessidade de mudança, discuta com o usuário e crie novos arquivos ou atualize a issue no task manager

package/dist/templates/commands/engineer/work.md

@@ -7,7 +7,21 @@ Este comando executa uma unidade de trabalho no workspace atual, implementando p
 Antes de executar, certifique-se de que:
 - Executou `/start` e `/plan` para ter o planejamento técnico
 - Está no workspace correto (verifique `diretório do workspace`)
-- Tem o arquivo `./.sessions/<ISSUE-ID>/plan.md` disponível
+- Tem os arquivos `.sessions/<ISSUE-ID>/` disponíveis:
+  - `context.md` (imutável)
+  - `architecture.md` (imutável)
+  - `plan.md` (mutável)
+
+## ⚠️ IMPORTANTE: Arquivos Imutáveis
+
+**Este comando deve LER mas NÃO MODIFICAR:**
+- ✅ **LER** `.sessions/<ISSUE-ID>/context.md` (imutável)
+- ✅ **LER** `.sessions/<ISSUE-ID>/architecture.md` (imutável)
+- ✅ **ATUALIZAR** `.sessions/<ISSUE-ID>/plan.md` (marcar progresso)
+- ✅ **IMPLEMENTAR** código nos repositórios do workspace
+- ✅ **FAZER COMMITS** nos repositórios do workspace
+- ❌ **NÃO modificar `context.md` ou `architecture.md`**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais (fora do workspace)**
 
 ## 📚 Carregar MetaSpecs
 

package/dist/templates/commands/products/check.md

@@ -2,6 +2,16 @@
 
 Este comando valida requisitos, decisões ou implementações contra as metaspecs do projeto.
 
+## ⚠️ IMPORTANTE: Modo de Operação
+
+**Este comando é para VALIDAÇÃO:**
+- ✅ Validar contra metaspecs
+- ✅ **LER** arquivos dos repositórios (read-only)
+- ✅ Gerar relatório de validação
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO modificar código**
+- ❌ **NÃO modificar `context.md` ou `architecture.md`**
+
 ## 🎯 Objetivo
 
 Garantir alinhamento com:

package/dist/templates/commands/products/collect.md

@@ -8,8 +8,11 @@ Você é um especialista em produto responsável por coletar e documentar novas
 - ✅ Coletar e entender requisitos
 - ✅ Criar issue no task manager via MCP
 - ✅ Fazer perguntas de esclarecimento
+- ✅ **LER** arquivos dos repositórios principais (read-only)
 - ❌ **NÃO implementar código**
 - ❌ **NÃO fazer edits em arquivos de código**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO fazer commits**
 
 **Próximo passo**: `/refine [ISSUE-ID]` para refinar os requisitos coletados.
 

package/dist/templates/commands/products/refine.md

@@ -4,7 +4,14 @@ Este comando refina uma issue coletada, transformando-a em requisitos claros e v
 
 ## ⚠️ IMPORTANTE: Este Comando NÃO Implementa Código
 
-Este comando é para refinamento de requisitos, não implementação.
+**Este comando é APENAS para refinamento de requisitos:**
+- ✅ Refinar e validar requisitos
+- ✅ Atualizar issue no task manager via MCP
+- ✅ **LER** arquivos dos repositórios principais (read-only)
+- ❌ **NÃO implementar código**
+- ❌ **NÃO fazer edits em arquivos de código**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO fazer commits**
 
 **Próximo passo**: `/spec [ISSUE-ID]` para criar a especificação completa (PRD).
 

package/dist/templates/commands/products/spec.md

@@ -4,7 +4,14 @@ Este comando cria a especificação completa (Product Requirements Document) da
 
 ## ⚠️ IMPORTANTE: Este Comando NÃO Implementa Código
 
-Este comando é para documentação de requisitos, não implementação.
+**Este comando é APENAS para documentação de requisitos:**
+- ✅ Criar PRD (Product Requirements Document)
+- ✅ Atualizar issue no task manager via MCP
+- ✅ **LER** arquivos dos repositórios principais (read-only)
+- ❌ **NÃO implementar código**
+- ❌ **NÃO fazer edits em arquivos de código**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO fazer commits**
 
 **Próximo passo**: `/start` para iniciar o desenvolvimento.
 

package/dist/utils/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAazF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoB3E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ/E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAqBD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlE"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAazF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoB3E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ/E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAqBD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlE"}

package/dist/utils/git.js

@@ -40,15 +40,19 @@ async function createWorktree(mainRepoPath, worktreePath, branchName) {
     const branches = await git.branch();
     const branchExists = branches.all.includes(branchName) || branches.all.includes(`remotes/origin/${branchName}`);
     if (!branchExists) {
-        // Create new branch from current HEAD
-        await git.checkoutLocalBranch(branchName);
-        console.log(chalk_1.default.gray(`  Created new branch: ${branchName}`));
+        // Create new branch WITHOUT checking it out in main repo
+        // The worktree will be created with this new branch
+        console.log(chalk_1.default.gray(`  Will create new branch: ${branchName} (in worktree only)`));
     }
     // Create worktree
-    console.log(chalk_1.default.gray(`    Executing: git worktree add "${worktreePath}" "${branchName}"`));
+    // Use -b flag if branch doesn't exist to create it in the worktree
+    const worktreeCmd = branchExists
+        ? `git worktree add "${worktreePath}" "${branchName}"`
+        : `git worktree add -b "${branchName}" "${worktreePath}"`;
+    console.log(chalk_1.default.gray(`    Executing: ${worktreeCmd}`));
     console.log(chalk_1.default.gray(`    Working directory: ${mainRepoPath}`));
     try {
-        const output = (0, child_process_1.execSync)(`git worktree add "${worktreePath}" "${branchName}"`, {
+        const output = (0, child_process_1.execSync)(worktreeCmd, {
             cwd: mainRepoPath,
             stdio: 'pipe',
             encoding: 'utf-8',

package/dist/utils/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-first-cli",
-  "version": "1.5.8",
+  "version": "1.6.0",
   "description": "A generic CLI to manage the Context-First development methodology across any project.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/templates/commands/engineer/plan.md

@@ -6,6 +6,15 @@ Este comando cria o plano técnico detalhado para implementação da feature.
 
 - PRD criado via `/spec`
 - Análise inicial feita via `/start`
+- Arquivos `context.md` e `architecture.md` criados e aprovados
+
+## ⚠️ IMPORTANTE: Arquivos Imutáveis
+
+**Este comando deve LER mas NÃO MODIFICAR:**
+- ✅ **LER** `.sessions/<ISSUE-ID>/context.md` (imutável)
+- ✅ **LER** `.sessions/<ISSUE-ID>/architecture.md` (imutável)
+- ✅ **CRIAR** `.sessions/<ISSUE-ID>/plan.md` (mutável - será atualizado durante `/work`)
+- ❌ **NÃO modificar `context.md` ou `architecture.md`**
 
 ## 📚 Carregar MetaSpecs
 

package/templates/commands/engineer/start.md

@@ -13,6 +13,7 @@ Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
    - Contexto de negócio
    - Stack, arquitetura e padrões técnicos
    - Convenções do projeto
+   - ADRs (Architecture Decision Records)
 
 ## 🎯 Contexto do Projeto
 
@@ -77,34 +78,154 @@ Após análise inicial, formule **3-5 clarificações mais importantes**:
 - Qual a ordem de implementação recomendada?
 - Há impacto em APIs ou contratos entre serviços?
 
-## 📝 Documentação da Sessão
+## 💾 Criação do Context.md
 
-Crie arquivo `./.sessions/<ISSUE-ID>/start.md` com:
+**IMPORTANTE**: Este arquivo é **IMUTÁVEL** após aprovação. Não deve ser modificado por comandos subsequentes.
+
+Crie arquivo `./.sessions/<ISSUE-ID>/context.md` com:
 
 ```markdown
-# [Título da Feature] - Início
+# Context: [Nome da Feature]
+
+## Por Que
+[Valor de negócio, persona atendida, métrica impactada]
+
+## O Que
+[Funcionalidades principais, comportamento esperado]
 
-## Entendimento
-[Resumo do que será construído e por quê]
+## Como
+[Abordagem técnica, componentes, repositórios afetados]
 
-## Repositórios Afetados
-- **repo-1**: [O que será feito]
-- **repo-2**: [O que será feito]
+## Validação contra Metaspecs
+- [x] Alinhado com estratégia de produto
+- [x] Atende persona correta
+- [x] Métrica impactada documentada
+- [x] Usa stack aprovada
+- [x] Respeita ADRs
+- [x] Sem conflitos com limitações conhecidas
 
-## Perguntas Pendentes
-1. [Pergunta 1]
-2. [Pergunta 2]
+## Dependências
+[Bibliotecas, APIs, componentes existentes]
 
-## Validações Realizadas
-- [x] Alinhado com estratégia
-- [x] Stack aprovada
-- [ ] Pendente: [algo a validar]
+## Restrições
+[Limitações técnicas, performance targets, budget]
 
-## Próximos Passos
-1. Aguardar respostas das perguntas
-2. Executar `/plan` para planejamento técnico detalhado
+## Testes
+[E2E críticos, unit tests necessários, cobertura esperada]
 ```
 
+**Após criar `context.md`, peça revisão e aprovação do usuário antes de prosseguir.**
+
+---
+
+## 🏗️ Criação do Architecture.md
+
+**IMPORTANTE**: Este arquivo é **IMUTÁVEL** após aprovação. Não deve ser modificado por comandos subsequentes.
+
+### Princípios Arquiteturais (OBRIGATÓRIO)
+
+**ANTES de criar a arquitetura, você DEVE:**
+
+1. **Ler ADRs (Architecture Decision Records)**:
+   - Liste ADRs em metaspecs
+   - Leia TODOS os ADRs relevantes para a feature
+   - Identifique restrições e padrões obrigatórios
+
+2. **Consultar padrões arquiteturais**:
+   - Leia guias de estrutura do projeto em metaspecs
+   - Leia padrões de código em metaspecs
+   - Identifique padrões existentes no código (use Glob/Grep para encontrar exemplos similares)
+
+3. **Validar compliance com ADRs**:
+   - Para cada ADR relevante, verifique se a solução proposta respeita as decisões
+   - Documente compliance no architecture.md
+   - Se houver violação, justifique ou proponha correção
+
+4. **Analisar código existente**:
+   - Use Glob/Grep para encontrar componentes/módulos similares
+   - Entenda padrões e estruturas existentes
+   - Alinhe nova implementação com padrões do projeto
+
+### Estrutura do Documento de Arquitetura
+
+Crie arquivo `./.sessions/<ISSUE-ID>/architecture.md` com:
+
+```markdown
+# Architecture: [Nome da Feature]
+
+## Visão Geral
+[Visão de alto nível do sistema antes e depois da mudança]
+
+## Componentes Afetados
+[Lista de componentes e suas relações, dependências]
+
+### Diagrama de Componentes
+[Descrição textual ou diagrama Mermaid dos componentes]
+
+### Fluxo de Dados
+1. [Passo 1 do fluxo]
+2. [Passo 2 do fluxo]
+3. [Passo 3 do fluxo]
+
+## Estrutura de Diretórios Proposta
+[Baseada em padrões do projeto]
+
+```
+repo-1/
+├── src/
+│   ├── components/
+│   │   └── NewComponent.tsx (CRIAR)
+│   └── services/
+│       └── NewService.ts (CRIAR)
+```
+
+## Padrões e Melhores Práticas
+[Padrões que serão mantidos ou introduzidos]
+
+## Validação de ADRs
+[Lista de ADRs consultados e compliance]
+
+- [x] ADR-001: [Nome] - Compliant
+- [x] ADR-002: [Nome] - Compliant
+
+## Dependências Externas
+[Bibliotecas que serão usadas ou adicionadas]
+
+## Decisões Técnicas
+
+### Decisão 1: [Título]
+**Contexto**: [Por que precisamos decidir isso]
+**Opções consideradas**:
+- Opção A: [Prós e contras]
+- Opção B: [Prós e contras]
+**Decisão**: [Opção escolhida]
+**Justificativa**: [Por que escolhemos esta opção]
+
+## Restrições e Suposições
+[Limitações técnicas e premissas]
+
+## Trade-offs
+[Alternativas consideradas e por que não foram escolhidas]
+
+## Consequências
+**Positivas**:
+- [Benefício 1]
+- [Benefício 2]
+
+**Negativas**:
+- [Custo/limitação 1]
+- [Custo/limitação 2]
+
+## Arquivos Principais
+[Lista dos principais arquivos a serem editados/criados]
+
+- `repo-1/src/components/NewComponent.tsx` (CRIAR)
+- `repo-1/src/services/NewService.ts` (CRIAR)
+- `repo-2/src/controllers/NewController.ts` (CRIAR)
+```
+
+**Após criar `architecture.md`, peça revisão e aprovação do usuário antes de prosseguir.**
+
 ---
 
 **Argumentos fornecidos**:
@@ -117,10 +238,20 @@ Crie arquivo `./.sessions/<ISSUE-ID>/start.md` com:
 
 ## 🎯 Próximo Passo
 
-Após esclarecimentos e aprovação:
+**Após aprovação do usuário dos arquivos `context.md` e `architecture.md`**:
 
 ```bash
 /plan
 ```
 
 Este comando criará o planejamento técnico detalhado da implementação.
+
+---
+
+## ⚠️ IMPORTANTE: Arquivos Imutáveis
+
+**`context.md` e `architecture.md` são IMUTÁVEIS após aprovação.**
+
+- ✅ Podem ser LIDOS por comandos subsequentes (`/plan`, `/work`)
+- ❌ NÃO devem ser MODIFICADOS por nenhum comando
+- ❌ Se houver necessidade de mudança, discuta com o usuário e crie novos arquivos ou atualize a issue no task manager

package/templates/commands/engineer/work.md

@@ -7,7 +7,21 @@ Este comando executa uma unidade de trabalho no workspace atual, implementando p
 Antes de executar, certifique-se de que:
 - Executou `/start` e `/plan` para ter o planejamento técnico
 - Está no workspace correto (verifique `diretório do workspace`)
-- Tem o arquivo `./.sessions/<ISSUE-ID>/plan.md` disponível
+- Tem os arquivos `.sessions/<ISSUE-ID>/` disponíveis:
+  - `context.md` (imutável)
+  - `architecture.md` (imutável)
+  - `plan.md` (mutável)
+
+## ⚠️ IMPORTANTE: Arquivos Imutáveis
+
+**Este comando deve LER mas NÃO MODIFICAR:**
+- ✅ **LER** `.sessions/<ISSUE-ID>/context.md` (imutável)
+- ✅ **LER** `.sessions/<ISSUE-ID>/architecture.md` (imutável)
+- ✅ **ATUALIZAR** `.sessions/<ISSUE-ID>/plan.md` (marcar progresso)
+- ✅ **IMPLEMENTAR** código nos repositórios do workspace
+- ✅ **FAZER COMMITS** nos repositórios do workspace
+- ❌ **NÃO modificar `context.md` ou `architecture.md`**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais (fora do workspace)**
 
 ## 📚 Carregar MetaSpecs
 

package/templates/commands/products/check.md

@@ -2,6 +2,16 @@
 
 Este comando valida requisitos, decisões ou implementações contra as metaspecs do projeto.
 
+## ⚠️ IMPORTANTE: Modo de Operação
+
+**Este comando é para VALIDAÇÃO:**
+- ✅ Validar contra metaspecs
+- ✅ **LER** arquivos dos repositórios (read-only)
+- ✅ Gerar relatório de validação
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO modificar código**
+- ❌ **NÃO modificar `context.md` ou `architecture.md`**
+
 ## 🎯 Objetivo
 
 Garantir alinhamento com:

package/templates/commands/products/collect.md

@@ -8,8 +8,11 @@ Você é um especialista em produto responsável por coletar e documentar novas
 - ✅ Coletar e entender requisitos
 - ✅ Criar issue no task manager via MCP
 - ✅ Fazer perguntas de esclarecimento
+- ✅ **LER** arquivos dos repositórios principais (read-only)
 - ❌ **NÃO implementar código**
 - ❌ **NÃO fazer edits em arquivos de código**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO fazer commits**
 
 **Próximo passo**: `/refine [ISSUE-ID]` para refinar os requisitos coletados.
 

package/templates/commands/products/refine.md

@@ -4,7 +4,14 @@ Este comando refina uma issue coletada, transformando-a em requisitos claros e v
 
 ## ⚠️ IMPORTANTE: Este Comando NÃO Implementa Código
 
-Este comando é para refinamento de requisitos, não implementação.
+**Este comando é APENAS para refinamento de requisitos:**
+- ✅ Refinar e validar requisitos
+- ✅ Atualizar issue no task manager via MCP
+- ✅ **LER** arquivos dos repositórios principais (read-only)
+- ❌ **NÃO implementar código**
+- ❌ **NÃO fazer edits em arquivos de código**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO fazer commits**
 
 **Próximo passo**: `/spec [ISSUE-ID]` para criar a especificação completa (PRD).
 

package/templates/commands/products/spec.md

@@ -4,7 +4,14 @@ Este comando cria a especificação completa (Product Requirements Document) da
 
 ## ⚠️ IMPORTANTE: Este Comando NÃO Implementa Código
 
-Este comando é para documentação de requisitos, não implementação.
+**Este comando é APENAS para documentação de requisitos:**
+- ✅ Criar PRD (Product Requirements Document)
+- ✅ Atualizar issue no task manager via MCP
+- ✅ **LER** arquivos dos repositórios principais (read-only)
+- ❌ **NÃO implementar código**
+- ❌ **NÃO fazer edits em arquivos de código**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO fazer commits**
 
 **Próximo passo**: `/start` para iniciar o desenvolvimento.