context-first-cli 2.3.0 → 2.3.2

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

@@ -1,122 +1,59 @@
 # Warm-up - Context Loading
 
-This command prepares the environment by loading the full context of the current project and workspace.
+Prepares the environment by loading optimized project context.
 
-## 1. Identify Current Workspace
+## 1. Load Configuration
 
-Check if you are inside a workspace created by `context-cli`:
+Read the orchestrator files:
+- **`context-manifest.json`** - Repositories and roles
+- **`ai.properties.md`** - base_path, task_management_system
 
-```bash
-# Check if you are in a workspace directory
-pwd
-# The workspace is usually located at ~/workspaces/<ISSUE-ID>/
-```
-
-If you are not in a workspace, ask the user which workspace to use or if a new one should be created with `feature:start`.
-
-## 📋 Project Configuration
+## 2. Load Compact Context (OPTIMIZED)
 
-**⚠️ IMPORTANT: Always read the project configuration files BEFORE running this command!**
+**IMPORTANT**: Use PROGRESSIVE loading to save context window.
 
-### Required Files
+### Required (warm-up)
 
-1. **`context-manifest.json`** (root of the orchestrator)
-   - List of project repositories
-   - Roles of each repository (metaspecs, application, etc.)
-   - URLs and dependencies between repositories
+Locate metaspecs via `context-manifest.json` (role: "specs-provider"):
 
-2. **`ai.properties.md`** (root of the orchestrator)
-   - Project settings (`project_name`, `base_path`)
-   - Task management system (`task_management_system`)
-   - Credentials and specific configurations
-
-### How to Read
-
-```bash
-# 1. Read context-manifest.json
-cat context-manifest.json
-
-# 2. Read ai.properties.md
-cat ai.properties.md
+```
+{base_path}/{metaspecs-id}/specs/_meta/WARM_UP_CONTEXT.md  (~100 lines)
 ```
 
-### Essential Information
-
-After reading the files, you will have:
-- ✅ Complete list of project repositories
-- ✅ Location of the metaspecs repository
-- ✅ Base path to locate repositories
-- ✅ Configured task management system
-- ✅ Project-specific configurations
-
-**🛑 DO NOT proceed without reading these files!** They contain critical information for the correct execution of the command.
-
-## 2. Load Project Configuration
-
-You are already in the project orchestrator (root of the current repository).
-
-1. **Verify you are at the orchestrator root**: `pwd` should show the orchestrator directory
-2. **Read the `context-manifest.json` file** at the orchestrator root
-3. **Read the `ai.properties.md` file** to obtain local configurations (base_path, etc.)
-
-## 3. Load Project Manifest
-
-Read the `context-manifest.json` from the orchestrator to understand:
-- Complete list of ecosystem repositories
-- URL of the MetaSpecs repository
-- Dependencies between repositories
-- Roles of each repository (application, library, service, specs-provider)
-
-## 4. Load MetaSpecs
-
-The MetaSpecs repository is **separate** and defined in `context-manifest.json` with `role: "metaspecs"`.
-
-**Locate the metaspecs repository:**
-
-1. Read `context-manifest.json` and find the repository with `role: "metaspecs"`
-2. Obtain the `id` of that repository (e.g., "my-project-metaspecs")
-3. Read `ai.properties.md` to get the `base_path`
-4. The metaspecs repository is located at: `{base_path}/{metaspecs-id}/`
+This file contains ALL essentials:
+- Technology stack
+- Context hierarchy
+- 5 critical rules
+- Minimal code patterns
+- On-demand loading table
 
-**Always read the index files first:**
+### On Demand (DO NOT load during warm-up)
 
-1. **`README.md`** - Project overview and documentation structure
-2. **`index.md`** (in root or subfolders) - Index of available specifications
+| Need | Document |
+|------|----------|
+| Generate code | `CLAUDE.meta.md` |
+| Architecture | `ARCHITECTURE.md` |
+| Specific feature | `features/{FEATURE}.md` |
+| Complete anti-patterns | `ANTI_PATTERNS.md` |
 
-**Use the indexes as a reference** to navigate to the specific specifications you need. Do not assume specific files exist — always consult the indexes first.
+## 3. Verify Repositories
 
-## 5. Load Current Session (if any)
+For each repository in `context-manifest.json`:
+- Verify existence at `{base_path}/{repo-id}/`
+- **DO NOT** read README.md now (on demand)
 
-Check if there is a saved session for this workspace:
+## 4. Verify Session (if exists)
 
 ```bash
-# Look for session in the orchestrator
 ls -la .sessions/<ISSUE-ID>/ 2>/dev/null
 ```
 
-If it exists, read the session files to recover the context of the last execution.
-
-## 6. Repository Context
-
-For each repository present in the workspace, read:
-- `README.md` - Purpose and overview of the repository
-- Main configuration file (`package.json`, `pom.xml`, `requirements.txt`, etc.)
-
-## 7. Smart Navigation
-
-- **Code**: Use search tools (glob, grep) to locate relevant files
-- **Documentation**: Use MetaSpecs indexes as reference
-- **Wait for Instructions**: DO NOT read other files now. Wait for the next command.
-
-## 8. Jidoka Principle (Stop Upon Detecting Problems)
+## 5. Jidoka Principle
 
-If you detect misalignment, conflicts, or problems:
-1. 🛑 **STOP** immediately
-2. 📝 **DOCUMENT** the problem found
-3. 💬 **ALERT** the user before proceeding
+If problems detected: **STOP**, document, alert the user.
 
 ---
 
-**Provided arguments**: #$ARGUMENTS
+**Arguments**: #$ARGUMENTS
 
-**Status**: Context loaded. Awaiting next command.
+**Status**: Context loaded. Awaiting next command.

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

@@ -1,123 +1,59 @@
 # Calentamiento - Carga de Contexto
 
-Este comando prepara el entorno cargando el contexto completo del proyecto y del workspace actual.
+Prepara el entorno cargando el contexto optimizado del proyecto.
 
-## 1. Identificar Workspace Actual
+## 1. Cargar Configuración
 
-Verifique si está dentro de un workspace creado por `context-cli`:
+Lee los archivos del orquestador:
+- **`context-manifest.json`** - Repositorios y roles
+- **`ai.properties.md`** - base_path, task_management_system
 
-```bash
-# Verificar si está en un directorio de workspace
-pwd
-# El workspace generalmente está en ~/workspaces/<ISSUE-ID>/
-```
-
-Si no está en un workspace, pregunte al usuario qué workspace usar o si debe crear uno nuevo con `feature:start`.
-
-## 📋 Configuración del Proyecto
+## 2. Cargar Contexto Compacto (OPTIMIZADO)
 
-**⚠️ IMPORTANTE: ¡Siempre lea los archivos de configuración del proyecto ANTES de ejecutar este comando!**
+**IMPORTANTE**: Usa carga PROGRESIVA para economizar la ventana de contexto.
 
-### Archivos Obligatorios
+### Obligatorio (warm-up)
 
-1. **`context-manifest.json`** (raíz del orchestrator)
-   - Lista de repositorios del proyecto
-   - Roles de cada repositorio (metaspecs, application, etc.)
-   - URLs y dependencias entre repositorios
+Localiza metaspecs vía `context-manifest.json` (role: "specs-provider"):
 
-2. **`ai.properties.md`** (raíz del orchestrator)
-   - Configuraciones del proyecto (`project_name`, `base_path`)
-   - Sistema de gestión de tareas (`task_management_system`)
-   - Credenciales y configuraciones específicas
-
-### Cómo Leer
-
-```bash
-# 1. Leer context-manifest.json
-cat context-manifest.json
-
-# 2. Leer ai.properties.md
-cat ai.properties.md
+```
+{base_path}/{metaspecs-id}/specs/_meta/WARM_UP_CONTEXT.md  (~100 líneas)
 ```
 
-### Información Esencial
-
-Después de leer los archivos, tendrá:
-- ✅ Lista completa de repositorios del proyecto
-- ✅ Ubicación del repositorio de metaspecs
-- ✅ Base path para localizar repositorios
-- ✅ Sistema de gestión de tareas configurado
-- ✅ Configuraciones específicas del proyecto
-
-**🛑 NO continúe sin leer estos archivos!** Contienen información crítica para la correcta ejecución del comando.
-
-
-## 2. Cargar Configuración del Proyecto
-
-Ya está en el orchestrator del proyecto (raíz del repositorio actual).
-
-1. **Verifique que está en la raíz del orchestrator**: `pwd` debe mostrar el directorio del orchestrator
-2. **Lea el archivo `context-manifest.json`** en la raíz del orchestrator
-3. **Lea el archivo `ai.properties.md`** para obtener configuraciones locales (base_path, etc.)
-
-## 3. Cargar Manifiesto del Proyecto
-
-Lea el `context-manifest.json` del orchestrator para entender:
-- Lista completa de repositorios del ecosistema
-- URL del repositorio de MetaSpecs
-- Dependencias entre repositorios
-- Roles de cada repositorio (application, library, service, specs-provider)
-
-## 4. Cargar MetaSpecs
-
-El repositorio de MetaSpecs es **separado** y está definido en el `context-manifest.json` con `role: "metaspecs"`.
-
-**Localice el repositorio de metaspecs:**
-
-1. Lea `context-manifest.json` y encuentre el repositorio con `role: "metaspecs"`
-2. Obtenga el `id` de ese repositorio (ej: "my-project-metaspecs")
-3. Lea `ai.properties.md` para obtener el `base_path`
-4. El repositorio de metaspecs está en: `{base_path}/{metaspecs-id}/`
+Este archivo contiene TODOS los esenciales:
+- Stack tecnológico
+- Jerarquía de contexto
+- 5 reglas críticas
+- Patrones de código mínimos
+- Tabla de carga bajo demanda
 
-**Lea siempre los archivos de índice primero:**
+### Bajo Demanda (NO cargar durante warm-up)
 
-1. **`README.md`** - Visión general del proyecto y estructura de documentación
-2. **`index.md`** (en la raíz o en subcarpetas) - Índice de especificaciones disponibles
+| Necesidad | Documento |
+|-----------|-----------|
+| Generar código | `CLAUDE.meta.md` |
+| Arquitectura | `ARCHITECTURE.md` |
+| Feature específica | `features/{FEATURE}.md` |
+| Anti-patrones completos | `ANTI_PATTERNS.md` |
 
-**Use los índices como referencia** para navegar hasta las especificaciones específicas que necesite. No asuma que archivos específicos existen - siempre consulte los índices primero.
+## 3. Verificar Repositorios
 
-## 5. Cargar Sesión Actual (si existe)
+Para cada repositorio en `context-manifest.json`:
+- Verificar existencia en `{base_path}/{repo-id}/`
+- **NO** leer README.md ahora (bajo demanda)
 
-Verifique si existe una sesión guardada para este workspace:
+## 4. Verificar Sesión (si existe)
 
 ```bash
-# Buscar sesión en el orchestrator
 ls -la .sessions/<ISSUE-ID>/ 2>/dev/null
 ```
 
-Si existe, lea los archivos de sesión para recuperar el contexto de la última ejecución.
-
-## 6. Contexto de los Repositorios
-
-Para cada repositorio presente en el workspace, lea:
-- `README.md` - Propósito y visión general del repositorio
-- Archivo de configuración principal (`package.json`, `pom.xml`, `requirements.txt`, etc.)
-
-## 7. Navegación Inteligente
-
-- **Código**: Use herramientas de búsqueda (glob, grep) para localizar archivos relevantes
-- **Documentación**: Use los índices de los MetaSpecs como referencia
-- **Espere Instrucciones**: NO lea otros archivos ahora. Espere el próximo comando.
-
-## 8. Principio Jidoka (Parar al Detectar Problemas)
+## 5. Principio Jidoka
 
-Si detecta desalineamientos, conflictos o problemas:
-1. 🛑 **PARE** inmediatamente
-2. 📝 **DOCUMENTE** el problema encontrado
-3. 💬 **ALERTE** al usuario antes de continuar
+Si se detectan problemas: **PARA**, documenta, alerta al usuario.
 
 ---
 
-**Argumentos proporcionados**: #$ARGUMENTS
+**Argumentos**: #$ARGUMENTS
 
-**Estado**: Contexto cargado. Esperando próximo comando.
+**Estado**: Contexto cargado. Esperando próximo comando.

package/templates/commands/pt-BR/warm-up.md

@@ -1,123 +1,59 @@
 # Aquecimento - Carregamento de Contexto
 
-Este comando prepara o ambiente carregando o contexto completo do projeto e do workspace atual.
+Prepara o ambiente carregando o contexto otimizado do projeto.
 
-## 1. Identificar Workspace Atual
+## 1. Carregar Configuração
 
-Verifique se você está dentro de um workspace criado pelo `context-cli`:
+Leia os arquivos do orchestrator:
+- **`context-manifest.json`** - Repositórios e roles
+- **`ai.properties.md`** - base_path, task_management_system
 
-```bash
-# Verificar se está em um diretório de workspace
-pwd
-# 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 com `feature:start`.
-
-## 📋 Configuração do Projeto
+## 2. Carregar Contexto Compacto (OTIMIZADO)
 
-**⚠️ IMPORTANTE: Sempre leia os arquivos de configuração do projeto ANTES de executar este comando!**
+**IMPORTANTE**: Use carregamento PROGRESSIVO para economizar janela de contexto.
 
-### Arquivos Obrigatórios
+### Obrigatório (warm-up)
 
-1. **`context-manifest.json`** (raiz do orchestrator)
-   - Lista de repositórios do projeto
-   - Roles de cada repositório (metaspecs, application, etc.)
-   - URLs e dependências entre repositórios
+Localize metaspecs via `context-manifest.json` (role: "specs-provider"):
 
-2. **`ai.properties.md`** (raiz do orchestrator)
-   - Configurações do projeto (`project_name`, `base_path`)
-   - Sistema de gerenciamento de tarefas (`task_management_system`)
-   - Credenciais e configurações específicas
-
-### Como Ler
-
-```bash
-# 1. Ler context-manifest.json
-cat context-manifest.json
-
-# 2. Ler ai.properties.md
-cat ai.properties.md
+```
+{base_path}/{metaspecs-id}/specs/_meta/WARM_UP_CONTEXT.md  (~100 linhas)
 ```
 
-### Informações Essenciais
-
-Após ler os arquivos, você terá:
-- ✅ Lista completa de repositórios do projeto
-- ✅ Localização do repositório de metaspecs
-- ✅ Base path para localizar repositórios
-- ✅ Sistema de task management configurado
-- ✅ Configurações específicas do projeto
-
-**🛑 NÃO prossiga sem ler estes arquivos!** Eles contêm informações críticas para a execução correta do comando.
-
-
-## 2. Carregar Configuração do Projeto
-
-Você já está no orchestrator do projeto (raiz do repositório atual).
-
-1. **Verifique se está na raiz do orchestrator**: `pwd` deve mostrar o diretório do orchestrator
-2. **Leia o arquivo `context-manifest.json`** na raiz do orchestrator
-3. **Leia o arquivo `ai.properties.md`** para obter configurações locais (base_path, etc.)
-
-## 3. Carregar Manifesto do Projeto
-
-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)
-
-## 4. Carregar MetaSpecs
-
-O repositório de MetaSpecs é **separado** e está definido no `context-manifest.json` com `role: "metaspecs"`.
-
-**Localize o repositório de metaspecs:**
-
-1. Leia `context-manifest.json` e encontre o repositório com `role: "metaspecs"`
-2. Obtenha o `id` desse repositório (ex: "my-project-metaspecs")
-3. Leia `ai.properties.md` para obter o `base_path`
-4. O repositório de metaspecs está em: `{base_path}/{metaspecs-id}/`
+Este arquivo contém TODOS os essenciais:
+- Stack tecnológica
+- Hierarquia de contexto
+- 5 regras críticas
+- Padrões de código mínimos
+- Tabela de carregamento sob demanda
 
-**Leia sempre os arquivos de índice primeiro:**
+### Sob Demanda (NÃO carregar durante warm-up)
 
-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
+| Necessidade | Documento |
+|-------------|-----------|
+| Gerar código | `CLAUDE.meta.md` |
+| Arquitetura | `ARCHITECTURE.md` |
+| Feature específica | `features/{FEATURE}.md` |
+| Anti-patterns completos | `ANTI_PATTERNS.md` |
 
-**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.
+## 3. Verificar Repositórios
 
-## 5. Carregar Sessão Atual (se existir)
+Para cada repositório no `context-manifest.json`:
+- Verificar existência em `{base_path}/{repo-id}/`
+- **NÃO** ler README.md agora (sob demanda)
 
-Verifique se existe uma sessão salva para este workspace:
+## 4. Verificar Sessão (se existir)
 
 ```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 dos MetaSpecs como referência
-- **Aguarde Instruções**: NÃO leia outros arquivos agora. Aguarde o próximo comando.
-
-## 8. Princípio Jidoka (Parar ao Detectar Problemas)
+## 5. Princípio Jidoka
 
-Se detectar desalinhamento, conflitos ou problemas:
-1. 🛑 **PARE** imediatamente
-2. 📝 **DOCUMENTE** o problema encontrado
-3. 💬 **ALERTE** o usuário antes de prosseguir
+Se problemas detectados: **PARE**, documente, alerte o usuário.
 
 ---
 
-**Argumentos fornecidos**: #$ARGUMENTS
+**Argumentos**: #$ARGUMENTS
 
 **Status**: Contexto carregado. Aguardando próximo comando.