context-first-cli 1.3.1 → 1.4.0

package/README.md

@@ -53,6 +53,7 @@ npm install -g context-first-cli
 | `context-cli create:orchestrator` | Create a new orchestrator repository from a template with all necessary structure. |
 | `context-cli add:repo` | Add a new code repository to `context-manifest.json` interactively. |
 | `context-cli add:repo-metaspec` | Add or update the MetaSpecs repository in `context-manifest.json`. |
+| `context-cli config:setup` | Interactively configure `ai.properties.md` for local development. |
 
 ### Workspace Commands
 
@@ -115,23 +116,22 @@ npx context-first-cli@latest add:repo
 
 Each repository will be added to `context-manifest.json` with its configuration.
 
-### Step 3: Configure Local Paths
+### Step 3: Configure Local Environment
 
-Edit `ai.properties.md` in your orchestrator to set up local paths and credentials:
+Run `config:setup` to interactively configure your local `ai.properties.md` file.
 
-```markdown
-# Paths dos Projetos
-base_path=/path/to/your/workspace
-meta_specs_path=/path/to/your/meta-specs
-backend_path=/path/to/your/backend
-frontend_path=/path/to/your/frontend
-
-# Task Manager Configuration
-task_management_system=jira
-jira_site=https://your-org.atlassian.net
-...
+```bash
+cd my-project-orchestrator/
+npx context-first-cli@latest config:setup
 ```
 
+This will ask for:
+1.  **Base workspace path** (where repositories will be cloned, e.g., `~/workspace`)
+2.  **Auto-clone** (whether to clone missing repositories automatically)
+3.  **Task manager** settings (Jira, Linear, etc.)
+
+This generates an `ai.properties.md` file tailored to your machine, following the convention-over-configuration principle.
+
 **Note**: This file is gitignored because it contains local paths specific to each developer.
 
 ### Step 4: Initialize Your Application Repositories
@@ -241,9 +241,11 @@ npx context-first-cli@latest add:repo
 npx context-first-cli@latest add:repo
 # ID: admin, URL: git@github.com:myorg/my-saas-admin.git
 
-# 3. Configure local paths
-nano ai.properties.md
-# Edit paths to match your local setup
+# 3. Configure local environment
+npx context-first-cli@latest config:setup
+# Base path: ~/workspace
+# Auto-clone: Yes
+# Task manager: Jira
 
 # 4. Push orchestrator to Git
 git remote add origin git@github.com:myorg/my-saas-orchestrator.git

package/dist/commands/update-commands.d.ts

@@ -0,0 +1,2 @@
+export declare function updateCommands(): Promise<void>;
+//# sourceMappingURL=update-commands.d.ts.map

package/dist/commands/update-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-commands.d.ts","sourceRoot":"","sources":["../../src/commands/update-commands.ts"],"names":[],"mappings":"AAKA,wBAAsB,cAAc,kBAoHnC"}

package/dist/commands/update-commands.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateCommands = updateCommands;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+async function updateCommands() {
+    console.log(chalk_1.default.blue('\n🔄 Update Commands\n'));
+    // 1. Verificar se está em um orchestrator
+    const manifestPath = path.join(process.cwd(), 'context-manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        console.log(chalk_1.default.red('❌ Error: context-manifest.json not found'));
+        console.log(chalk_1.default.yellow('This command must be run from an orchestrator directory'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.green('✓ Found orchestrator directory'));
+    // 2. Detectar qual pasta de comandos existe
+    const claudeCommandsPath = path.join(process.cwd(), '.claude', 'commands');
+    const cursorCommandsPath = path.join(process.cwd(), '.cursor', 'commands');
+    let commandsPath;
+    let aiProvider;
+    if (fs.existsSync(claudeCommandsPath)) {
+        commandsPath = claudeCommandsPath;
+        aiProvider = 'claude';
+    }
+    else if (fs.existsSync(cursorCommandsPath)) {
+        commandsPath = cursorCommandsPath;
+        aiProvider = 'cursor';
+    }
+    else {
+        console.log(chalk_1.default.red('❌ Error: No commands directory found'));
+        console.log(chalk_1.default.yellow('Expected .claude/commands or .cursor/commands'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.green(`✓ Found ${aiProvider} commands directory`));
+    // 3. Fazer backup dos comandos atuais
+    const backupPath = path.join(process.cwd(), `.${aiProvider}-commands-backup-${Date.now()}`);
+    const { shouldBackup } = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'shouldBackup',
+            message: 'Create backup of current commands before updating?',
+            default: true,
+        },
+    ]);
+    if (shouldBackup) {
+        fs.cpSync(commandsPath, backupPath, { recursive: true });
+        console.log(chalk_1.default.green(`✓ Backup created at: ${backupPath}`));
+    }
+    // 4. Perguntar quais comandos atualizar
+    const { updateMode } = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'updateMode',
+            message: 'Which commands do you want to update?',
+            choices: [
+                { name: 'All commands (recommended)', value: 'all' },
+                { name: 'Select specific commands', value: 'selective' },
+            ],
+        },
+    ]);
+    // 5. Copiar templates atualizados
+    const templatesPath = path.join(__dirname, '..', 'templates', 'commands');
+    if (!fs.existsSync(templatesPath)) {
+        console.log(chalk_1.default.red('❌ Error: Templates not found'));
+        console.log(chalk_1.default.yellow('Please reinstall context-first-cli'));
+        process.exit(1);
+    }
+    if (updateMode === 'all') {
+        // Atualizar todos os comandos
+        fs.cpSync(templatesPath, commandsPath, { recursive: true });
+        console.log(chalk_1.default.green('✓ All commands updated successfully'));
+    }
+    else {
+        // Modo seletivo
+        const availableCommands = getAllCommandFiles(templatesPath);
+        const { selectedCommands } = await inquirer_1.default.prompt([
+            {
+                type: 'checkbox',
+                name: 'selectedCommands',
+                message: 'Select commands to update:',
+                choices: availableCommands.map(cmd => ({
+                    name: cmd.replace(/\//g, ' / '),
+                    value: cmd,
+                })),
+            },
+        ]);
+        // Copiar apenas os comandos selecionados
+        for (const command of selectedCommands) {
+            const sourcePath = path.join(templatesPath, command);
+            const destPath = path.join(commandsPath, command);
+            // Criar diretório se não existir
+            const destDir = path.dirname(destPath);
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            fs.copyFileSync(sourcePath, destPath);
+            console.log(chalk_1.default.green(`✓ Updated: ${command}`));
+        }
+    }
+    console.log(chalk_1.default.blue('\n✨ Commands updated successfully!\n'));
+    if (shouldBackup) {
+        console.log(chalk_1.default.yellow(`💡 Backup location: ${backupPath}`));
+        console.log(chalk_1.default.yellow('   You can restore from backup if needed\n'));
+    }
+}
+function getAllCommandFiles(dir, baseDir = dir) {
+    const files = [];
+    const items = fs.readdirSync(dir);
+    for (const item of items) {
+        const fullPath = path.join(dir, item);
+        const stat = fs.statSync(fullPath);
+        if (stat.isDirectory()) {
+            files.push(...getAllCommandFiles(fullPath, baseDir));
+        }
+        else if (item.endsWith('.md')) {
+            const relativePath = path.relative(baseDir, fullPath);
+            files.push(relativePath);
+        }
+    }
+    return files.sort();
+}
+//# sourceMappingURL=update-commands.js.map

package/dist/commands/update-commands.js.map

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

package/dist/index.js

@@ -7,6 +7,7 @@ const create_orchestrator_1 = require("./commands/create-orchestrator");
 const add_repo_1 = require("./commands/add-repo");
 const add_repo_metaspec_1 = require("./commands/add-repo-metaspec");
 const config_setup_1 = require("./commands/config-setup");
+const update_commands_1 = require("./commands/update-commands");
 const feature_1 = require("./commands/feature");
 const doctor_1 = require("./commands/doctor");
 const status_1 = require("./commands/status");
@@ -36,6 +37,10 @@ program
     .command('config:setup')
     .description('Interactively configure ai.properties.md for local development')
     .action(config_setup_1.configSetupCommand);
+program
+    .command('update:commands')
+    .description('Update command templates in an existing orchestrator')
+    .action(update_commands_1.updateCommands);
 // Feature management commands
 const feature = program.command('feature').description('Manage feature workspaces');
 feature

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AAEpC,0CAA8C;AAC9C,wEAA2E;AAC3E,kDAAqD;AACrD,oEAAsE;AACtE,0DAA6D;AAC7D,gDAAqD;AACrD,8CAAkD;AAClD,8CAAkD;AAElD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,8EAA8E,CAAC;KAC3F,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,iBAAiB;AACjB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,kBAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,qBAAqB,CAAC;KAC9B,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,+CAAyB,CAAC,CAAC;AAErC,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,yBAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,iEAAiE,CAAC;KAC9E,MAAM,CAAC,0CAAsB,CAAC,CAAC;AAElC,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,iCAAkB,CAAC,CAAC;AAE9B,8BAA8B;AAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;AAEpF,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,qBAAqB,EAAE,iDAAiD,CAAC;KAChF,MAAM,CAAC,yBAAe,CAAC,KAAK,CAAC,CAAC;AAEjC,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,yBAAe,CAAC,IAAI,CAAC,CAAC;AAEhC,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,yBAAe,CAAC,MAAM,CAAC,CAAC;AAElC,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,aAAa,EAAE,oCAAoC,CAAC;KAC3D,MAAM,CAAC,yBAAe,CAAC,GAAG,CAAC,CAAC;AAE/B,sBAAsB;AACtB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,sBAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,sBAAa,CAAC,CAAC;AAEzB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AAEpC,0CAA8C;AAC9C,wEAA2E;AAC3E,kDAAqD;AACrD,oEAAsE;AACtE,0DAA6D;AAC7D,gEAA4D;AAC5D,gDAAqD;AACrD,8CAAkD;AAClD,8CAAkD;AAElD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,8EAA8E,CAAC;KAC3F,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,iBAAiB;AACjB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,kBAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,qBAAqB,CAAC;KAC9B,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,+CAAyB,CAAC,CAAC;AAErC,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,yBAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,iEAAiE,CAAC;KAC9E,MAAM,CAAC,0CAAsB,CAAC,CAAC;AAElC,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,iCAAkB,CAAC,CAAC;AAE9B,OAAO;KACJ,OAAO,CAAC,iBAAiB,CAAC;KAC1B,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,gCAAc,CAAC,CAAC;AAE1B,8BAA8B;AAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;AAEpF,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,qBAAqB,EAAE,iDAAiD,CAAC;KAChF,MAAM,CAAC,yBAAe,CAAC,KAAK,CAAC,CAAC;AAEjC,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,yBAAe,CAAC,IAAI,CAAC,CAAC;AAEhC,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,yBAAe,CAAC,MAAM,CAAC,CAAC;AAElC,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,aAAa,EAAE,oCAAoC,CAAC;KAC3D,MAAM,CAAC,yBAAe,CAAC,GAAG,CAAC,CAAC;AAE/B,sBAAsB;AACtB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,sBAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,sBAAa,CAAC,CAAC;AAEzB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

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

@@ -6,14 +6,14 @@ Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
 
 Antes de iniciar, carregue o contexto consultando:
 - `context-manifest.json` - Estrutura de repositórios
-- `specs/business/index.md` - Contexto de negócio
-- `specs/technical/index.md` - Stack, arquitetura e padrões técnicos
-- `.workspace.json` - Informações do workspace atual
+- `repositório de MetaSpecs (seção de negócio)index.md` - Contexto de negócio
+- `repositório de MetaSpecs (seção técnica)index.md` - Stack, arquitetura e padrões técnicos
+- `diretório do workspace` - Informações do workspace atual
 
 ## ⚙️ Configuração Inicial
 
 1. **Verificar Workspace**:
-   - Confirme que está no workspace correto (verifique `.workspace.json`)
+   - Confirme que está no workspace correto (verifique `diretório do workspace`)
    - Liste os repositórios disponíveis no workspace
 
 2. **Verificar Branches**:

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

@@ -7,7 +7,7 @@ Este comando executa uma unidade de trabalho no workspace atual, implementando p
 Antes de executar, certifique-se de que:
 - Executou `/warm-up` para carregar o contexto
 - Executou `/start` e `/plan` para ter o planejamento técnico
-- Está no workspace correto (verifique `.workspace.json`)
+- Está no workspace correto (verifique `diretório do workspace`)
 - Tem o arquivo `./.sessions/<ISSUE-ID>/plan.md` disponível
 
 ## 🎯 Objetivo

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

@@ -25,30 +25,30 @@ Execute este comando:
 Navegue até o diretório do orchestrator e identifique quais metaspecs existem:
 
 ```bash
-ls -la ../.context-orchestrator/specs/
+ls -la repositório de MetaSpecs
 ```
 
 ### 2. Validação de Negócio
 
-Se existirem metaspecs de negócio (`specs/business/`):
+Se existirem metaspecs de negócio (`repositório de MetaSpecs (seção de negócio)`):
 
 ```markdown
 ## Validação de Negócio
 
 ### Estratégia de Produto
-- **Arquivo**: `specs/business/PRODUCT_STRATEGY.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)PRODUCT_STRATEGY.md`
 - **Validação**: [Esta feature está alinhada com a estratégia?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
 
 ### Personas
-- **Arquivo**: `specs/business/CUSTOMER_PERSONAS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)CUSTOMER_PERSONAS.md`
 - **Validação**: [Atende a persona correta?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
 
 ### Métricas
-- **Arquivo**: `specs/business/PRODUCT_METRICS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)PRODUCT_METRICS.md`
 - **Validação**: [Métrica de sucesso está documentada?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
@@ -56,32 +56,32 @@ Se existirem metaspecs de negócio (`specs/business/`):
 
 ### 3. Validação Técnica
 
-Se existirem metaspecs técnicas (`specs/technical/`):
+Se existirem metaspecs técnicas (`repositório de MetaSpecs (seção técnica)`):
 
 ```markdown
 ## Validação Técnica
 
 ### Stack Tecnológica
-- **Arquivo**: `specs/technical/meta/stack.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)meta/stack.md`
 - **Validação**: [Usa apenas tecnologias aprovadas?]
 - **Status**: ✅ Conforme / ⚠️ Exceção justificada / ❌ Não conforme
 - **Notas**: [Tecnologias usadas e justificativas]
 
 ### Arquitetura
-- **Arquivo**: `specs/technical/ARCHITECTURE.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)ARCHITECTURE.md`
 - **Validação**: [Segue padrões arquiteturais?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 - **Notas**: [Observações]
 
 ### ADRs (Architecture Decision Records)
-- **Diretório**: `specs/technical/adr/`
+- **Diretório**: `repositório de MetaSpecs (seção técnica)adr/`
 - **Validação**: [Respeita decisões arquiteturais documentadas?]
 - **ADRs Relevantes**: [Lista de ADRs verificados]
 - **Status**: ✅ Conforme / ⚠️ Conflito menor / ❌ Conflito crítico
 - **Notas**: [Observações]
 
 ### Regras de Negócio
-- **Arquivo**: `specs/technical/BUSINESS_LOGIC.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)BUSINESS_LOGIC.md`
 - **Validação**: [Implementa regras de negócio corretamente?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 - **Notas**: [Observações]
@@ -93,17 +93,17 @@ Se existirem metaspecs técnicas (`specs/technical/`):
 ## Validação de Padrões
 
 ### Código
-- **Arquivo**: `specs/technical/CODE_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)CODE_STANDARDS.md`
 - **Validação**: [Segue padrões de código?]
 - **Status**: ✅ Conforme / ⚠️ Pequenos desvios / ❌ Não conforme
 
 ### Testes
-- **Arquivo**: `specs/technical/TEST_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)TEST_STANDARDS.md`
 - **Validação**: [Estratégia de testes adequada?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 
 ### Documentação
-- **Arquivo**: `specs/technical/DOC_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)DOC_STANDARDS.md`
 - **Validação**: [Documentação adequada?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 ```

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

@@ -18,9 +18,9 @@ Você é um especialista em produto responsável por coletar e documentar novas
 ## Contexto do Projeto
 
 Antes de iniciar, carregue o contexto consultando:
-- `context-manifest.json` - Estrutura do projeto
-- `specs/business/` - Contexto de negócio (se disponível)
-- `specs/technical/` - Contexto técnico (se disponível)
+- `context-manifest.json` do orchestrator - Estrutura do projeto
+- Repositório de MetaSpecs (definido no manifest) - Leia os arquivos `index.md` como referência
+- `README.md` dos repositórios envolvidos
 
 ## Seu Objetivo
 

package/dist/templates/commands/warm-up.md

@@ -7,51 +7,64 @@ Este comando prepara o ambiente carregando o contexto completo do projeto e do w
 Verifique se você está dentro de um workspace criado pelo `context-cli`:
 
 ```bash
-# Procurar pelo arquivo .workspace.json no diretório atual ou pais
+# Verificar se está em um diretório de workspace
 pwd
-ls -la .workspace.json 2>/dev/null || echo "Não está em um workspace"
+# O workspace geralmente está em ~/workspaces/<ISSUE-ID>/
 ```
 
-Se não estiver em um workspace, pergunte ao usuário qual workspace usar ou se deve criar um novo.
+Se não estiver em um workspace, pergunte ao usuário qual workspace usar ou se deve criar um novo com `feature:start`.
 
-## 2. Carregar Configuração do Orchestrator
+## 2. Carregar Configuração do Projeto
 
-Leia o arquivo `.workspace.json` para identificar:
-- Issue ID do workspace
-- Repositórios incluídos neste workspace
-- Data de criação e última atualização
+Identifique o orchestrator do projeto:
 
-## 3. Carregar Metaspecs (se disponíveis)
+1. **Procure o arquivo `.contextrc.json`** em qualquer um dos repositórios do workspace
+2. Este arquivo contém a URL do repositório orchestrator
+3. Se o orchestrator ainda não estiver clonado localmente, clone-o
 
-Navegue até o diretório do orchestrator (geralmente `../.context-orchestrator/`) e leia:
+## 3. Carregar Manifesto do Projeto
 
-1. **Manifesto do Projeto**: `context-manifest.json`
-   - Entenda a estrutura de repositórios
-   - Identifique dependências entre repos
+Leia o `context-manifest.json` do orchestrator para entender:
+- Lista completa de repositórios do ecossistema
+- URL do repositório de MetaSpecs
+- Dependências entre repositórios
+- Roles de cada repositório (application, library, service, specs-provider)
 
-2. **Índices de Documentação** (se existirem):
-   - `specs/business/index.md` - Contexto de negócio
-   - `specs/technical/index.md` - Contexto técnico
-   - `README.md` - Visão geral do projeto
+## 4. Carregar MetaSpecs
 
-3. **Especificações Core** (se existirem):
-   - `specs/business/PRODUCT_STRATEGY.md` - Estratégia do produto
-   - `specs/technical/meta/intent.md` - Objetivos e constraints
-   - `specs/technical/meta/stack.md` - Stack tecnológica e ADRs
+O repositório de MetaSpecs está definido no `context-manifest.json` (geralmente com `role: "specs-provider"`).
 
-## 4. Contexto dos Repositórios
+**Leia sempre os arquivos de índice primeiro:**
 
-Para cada repositório no workspace, leia:
-- `README.md` - Entenda o propósito do repositório
-- `package.json` ou arquivo equivalente - Identifique dependências e scripts
+1. **`README.md`** - Visão geral do projeto e estrutura de documentação
+2. **`index.md`** (na raiz ou em subpastas) - Índice de especificações disponíveis
 
-## 5. Navegação Inteligente
+**Use os índices como referência** para navegar até as especificações específicas que você precisa. Não assuma que arquivos específicos existem - sempre consulte os índices primeiro.
+
+## 5. Carregar Sessão Atual (se existir)
+
+Verifique se existe uma sessão salva para este workspace:
+
+```bash
+# Procurar por sessão no orchestrator
+ls -la .sessions/<ISSUE-ID>/ 2>/dev/null
+```
+
+Se existir, leia os arquivos de sessão para recuperar o contexto da última execução.
+
+## 6. Contexto dos Repositórios
+
+Para cada repositório presente no workspace, leia:
+- `README.md` - Propósito e visão geral do repositório
+- Arquivo de configuração principal (`package.json`, `pom.xml`, `requirements.txt`, etc.)
+
+## 7. Navegação Inteligente
 
 - **Código**: Use ferramentas de busca (glob, grep) para localizar arquivos relevantes
-- **Documentação**: Use os índices carregados para encontrar especificações
+- **Documentação**: Use os índices dos MetaSpecs como referência
 - **Aguarde Instruções**: NÃO leia outros arquivos agora. Aguarde o próximo comando.
 
-## 6. Princípio Jidoka (Parar ao Detectar Problemas)
+## 8. Princípio Jidoka (Parar ao Detectar Problemas)
 
 Se detectar desalinhamento, conflitos ou problemas:
 1. 🛑 **PARE** imediatamente

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-first-cli",
-  "version": "1.3.1",
+  "version": "1.4.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/start.md

@@ -6,14 +6,14 @@ Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
 
 Antes de iniciar, carregue o contexto consultando:
 - `context-manifest.json` - Estrutura de repositórios
-- `specs/business/index.md` - Contexto de negócio
-- `specs/technical/index.md` - Stack, arquitetura e padrões técnicos
-- `.workspace.json` - Informações do workspace atual
+- `repositório de MetaSpecs (seção de negócio)index.md` - Contexto de negócio
+- `repositório de MetaSpecs (seção técnica)index.md` - Stack, arquitetura e padrões técnicos
+- `diretório do workspace` - Informações do workspace atual
 
 ## ⚙️ Configuração Inicial
 
 1. **Verificar Workspace**:
-   - Confirme que está no workspace correto (verifique `.workspace.json`)
+   - Confirme que está no workspace correto (verifique `diretório do workspace`)
    - Liste os repositórios disponíveis no workspace
 
 2. **Verificar Branches**:

package/templates/commands/engineer/work.md

@@ -7,7 +7,7 @@ Este comando executa uma unidade de trabalho no workspace atual, implementando p
 Antes de executar, certifique-se de que:
 - Executou `/warm-up` para carregar o contexto
 - Executou `/start` e `/plan` para ter o planejamento técnico
-- Está no workspace correto (verifique `.workspace.json`)
+- Está no workspace correto (verifique `diretório do workspace`)
 - Tem o arquivo `./.sessions/<ISSUE-ID>/plan.md` disponível
 
 ## 🎯 Objetivo

package/templates/commands/products/check.md

@@ -25,30 +25,30 @@ Execute este comando:
 Navegue até o diretório do orchestrator e identifique quais metaspecs existem:
 
 ```bash
-ls -la ../.context-orchestrator/specs/
+ls -la repositório de MetaSpecs
 ```
 
 ### 2. Validação de Negócio
 
-Se existirem metaspecs de negócio (`specs/business/`):
+Se existirem metaspecs de negócio (`repositório de MetaSpecs (seção de negócio)`):
 
 ```markdown
 ## Validação de Negócio
 
 ### Estratégia de Produto
-- **Arquivo**: `specs/business/PRODUCT_STRATEGY.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)PRODUCT_STRATEGY.md`
 - **Validação**: [Esta feature está alinhada com a estratégia?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
 
 ### Personas
-- **Arquivo**: `specs/business/CUSTOMER_PERSONAS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)CUSTOMER_PERSONAS.md`
 - **Validação**: [Atende a persona correta?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
 
 ### Métricas
-- **Arquivo**: `specs/business/PRODUCT_METRICS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)PRODUCT_METRICS.md`
 - **Validação**: [Métrica de sucesso está documentada?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
@@ -56,32 +56,32 @@ Se existirem metaspecs de negócio (`specs/business/`):
 
 ### 3. Validação Técnica
 
-Se existirem metaspecs técnicas (`specs/technical/`):
+Se existirem metaspecs técnicas (`repositório de MetaSpecs (seção técnica)`):
 
 ```markdown
 ## Validação Técnica
 
 ### Stack Tecnológica
-- **Arquivo**: `specs/technical/meta/stack.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)meta/stack.md`
 - **Validação**: [Usa apenas tecnologias aprovadas?]
 - **Status**: ✅ Conforme / ⚠️ Exceção justificada / ❌ Não conforme
 - **Notas**: [Tecnologias usadas e justificativas]
 
 ### Arquitetura
-- **Arquivo**: `specs/technical/ARCHITECTURE.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)ARCHITECTURE.md`
 - **Validação**: [Segue padrões arquiteturais?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 - **Notas**: [Observações]
 
 ### ADRs (Architecture Decision Records)
-- **Diretório**: `specs/technical/adr/`
+- **Diretório**: `repositório de MetaSpecs (seção técnica)adr/`
 - **Validação**: [Respeita decisões arquiteturais documentadas?]
 - **ADRs Relevantes**: [Lista de ADRs verificados]
 - **Status**: ✅ Conforme / ⚠️ Conflito menor / ❌ Conflito crítico
 - **Notas**: [Observações]
 
 ### Regras de Negócio
-- **Arquivo**: `specs/technical/BUSINESS_LOGIC.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)BUSINESS_LOGIC.md`
 - **Validação**: [Implementa regras de negócio corretamente?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 - **Notas**: [Observações]
@@ -93,17 +93,17 @@ Se existirem metaspecs técnicas (`specs/technical/`):
 ## Validação de Padrões
 
 ### Código
-- **Arquivo**: `specs/technical/CODE_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)CODE_STANDARDS.md`
 - **Validação**: [Segue padrões de código?]
 - **Status**: ✅ Conforme / ⚠️ Pequenos desvios / ❌ Não conforme
 
 ### Testes
-- **Arquivo**: `specs/technical/TEST_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)TEST_STANDARDS.md`
 - **Validação**: [Estratégia de testes adequada?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 
 ### Documentação
-- **Arquivo**: `specs/technical/DOC_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)DOC_STANDARDS.md`
 - **Validação**: [Documentação adequada?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 ```

package/templates/commands/products/collect.md

@@ -18,9 +18,9 @@ Você é um especialista em produto responsável por coletar e documentar novas
 ## Contexto do Projeto
 
 Antes de iniciar, carregue o contexto consultando:
-- `context-manifest.json` - Estrutura do projeto
-- `specs/business/` - Contexto de negócio (se disponível)
-- `specs/technical/` - Contexto técnico (se disponível)
+- `context-manifest.json` do orchestrator - Estrutura do projeto
+- Repositório de MetaSpecs (definido no manifest) - Leia os arquivos `index.md` como referência
+- `README.md` dos repositórios envolvidos
 
 ## Seu Objetivo
 

package/templates/commands/warm-up.md

@@ -7,51 +7,64 @@ Este comando prepara o ambiente carregando o contexto completo do projeto e do w
 Verifique se você está dentro de um workspace criado pelo `context-cli`:
 
 ```bash
-# Procurar pelo arquivo .workspace.json no diretório atual ou pais
+# Verificar se está em um diretório de workspace
 pwd
-ls -la .workspace.json 2>/dev/null || echo "Não está em um workspace"
+# O workspace geralmente está em ~/workspaces/<ISSUE-ID>/
 ```
 
-Se não estiver em um workspace, pergunte ao usuário qual workspace usar ou se deve criar um novo.
+Se não estiver em um workspace, pergunte ao usuário qual workspace usar ou se deve criar um novo com `feature:start`.
 
-## 2. Carregar Configuração do Orchestrator
+## 2. Carregar Configuração do Projeto
 
-Leia o arquivo `.workspace.json` para identificar:
-- Issue ID do workspace
-- Repositórios incluídos neste workspace
-- Data de criação e última atualização
+Identifique o orchestrator do projeto:
 
-## 3. Carregar Metaspecs (se disponíveis)
+1. **Procure o arquivo `.contextrc.json`** em qualquer um dos repositórios do workspace
+2. Este arquivo contém a URL do repositório orchestrator
+3. Se o orchestrator ainda não estiver clonado localmente, clone-o
 
-Navegue até o diretório do orchestrator (geralmente `../.context-orchestrator/`) e leia:
+## 3. Carregar Manifesto do Projeto
 
-1. **Manifesto do Projeto**: `context-manifest.json`
-   - Entenda a estrutura de repositórios
-   - Identifique dependências entre repos
+Leia o `context-manifest.json` do orchestrator para entender:
+- Lista completa de repositórios do ecossistema
+- URL do repositório de MetaSpecs
+- Dependências entre repositórios
+- Roles de cada repositório (application, library, service, specs-provider)
 
-2. **Índices de Documentação** (se existirem):
-   - `specs/business/index.md` - Contexto de negócio
-   - `specs/technical/index.md` - Contexto técnico
-   - `README.md` - Visão geral do projeto
+## 4. Carregar MetaSpecs
 
-3. **Especificações Core** (se existirem):
-   - `specs/business/PRODUCT_STRATEGY.md` - Estratégia do produto
-   - `specs/technical/meta/intent.md` - Objetivos e constraints
-   - `specs/technical/meta/stack.md` - Stack tecnológica e ADRs
+O repositório de MetaSpecs está definido no `context-manifest.json` (geralmente com `role: "specs-provider"`).
 
-## 4. Contexto dos Repositórios
+**Leia sempre os arquivos de índice primeiro:**
 
-Para cada repositório no workspace, leia:
-- `README.md` - Entenda o propósito do repositório
-- `package.json` ou arquivo equivalente - Identifique dependências e scripts
+1. **`README.md`** - Visão geral do projeto e estrutura de documentação
+2. **`index.md`** (na raiz ou em subpastas) - Índice de especificações disponíveis
 
-## 5. Navegação Inteligente
+**Use os índices como referência** para navegar até as especificações específicas que você precisa. Não assuma que arquivos específicos existem - sempre consulte os índices primeiro.
+
+## 5. Carregar Sessão Atual (se existir)
+
+Verifique se existe uma sessão salva para este workspace:
+
+```bash
+# Procurar por sessão no orchestrator
+ls -la .sessions/<ISSUE-ID>/ 2>/dev/null
+```
+
+Se existir, leia os arquivos de sessão para recuperar o contexto da última execução.
+
+## 6. Contexto dos Repositórios
+
+Para cada repositório presente no workspace, leia:
+- `README.md` - Propósito e visão geral do repositório
+- Arquivo de configuração principal (`package.json`, `pom.xml`, `requirements.txt`, etc.)
+
+## 7. Navegação Inteligente
 
 - **Código**: Use ferramentas de busca (glob, grep) para localizar arquivos relevantes
-- **Documentação**: Use os índices carregados para encontrar especificações
+- **Documentação**: Use os índices dos MetaSpecs como referência
 - **Aguarde Instruções**: NÃO leia outros arquivos agora. Aguarde o próximo comando.
 
-## 6. Princípio Jidoka (Parar ao Detectar Problemas)
+## 8. Princípio Jidoka (Parar ao Detectar Problemas)
 
 Se detectar desalinhamento, conflitos ou problemas:
 1. 🛑 **PARE** imediatamente