@onion-architect-ai/cli 4.1.0-beta.1 → 4.1.0-beta.3

package/templates/.onion/contexts/technical/commands/advanced/release-start.md

@@ -0,0 +1,95 @@
+---
+name: start
+description: Iniciar release branch com versionamento e changelog.
+model: sonnet
+category: git
+tags: [release, gitflow, version]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# 🚀 Git Flow - Iniciar Release
+
+Iniciar processo de release criando branch de release com versionamento automático, preparação de changelog e validações pré-release. Workflow completo para gestão segura de releases seguindo padrões GitFlow.
+
+## 🎯 Funcionalidades
+
+### Release Workflow e Versionamento
+- Criação de release branch a partir de develop branch
+- Auto-detecção e bump inteligente de versionamento (semver)
+- Preparação automática de changelog baseada em commits
+- Validações de estado pré-release (working directory, conflicts)
+- Setup de ClickUp task para release tracking completo
+
+### Versionamento Inteligente e Automação
+- Detecção automática de package.json e version files
+- Bump semântico (major.minor.patch) com validation
+- Support para diferentes tipos de projeto e convenções
+- Validações de tag conflicts e branch state
+- Integration com @gitflow-specialist para release strategy
+
+### Validações e Safety-First
+- Verificações de repository state e uncommitted changes
+- Primary branch detection (main/master) automática
+- Develop branch sync validation antes da release
+- Release branch creation com error handling robusto
+- Educational guidance durante processo de release
+
+## 🚀 Como Usar
+
+```bash
+/git/release/start "v2.1.0"           # Release com versão específica  
+/git/release/start "2.1.0"            # Versão sem prefixo v
+/git/release/start "patch"            # Auto-bump patch (2.0.1 → 2.0.2)
+/git/release/start "minor"            # Auto-bump minor (2.0.1 → 2.1.0) 
+/git/release/start "major"            # Auto-bump major (2.0.1 → 3.0.0)
+```
+
+**Pré-requisitos**: Working directory limpo, develop branch disponível
+
+### Processo Executado
+1. **Validações**: Verifica repository state, versão fornecida, working directory
+2. **Branch Detection**: Detecta primary branch (main/master) e develop
+3. **Version Processing**: Processa versioning (específica ou auto-bump)
+4. **Release Branch**: Cria release/version branch a partir de develop
+5. **ClickUp Setup**: Cria task de release tracking e atualiza status
+6. **Changelog Prep**: Prepara changelog baseado em commits desde última release
+
+### Version Bump Intelligence
+Durante execução, processa diferentes tipos de versionamento:
+- Versões explícitas: Valida formato semver e disponibilidade
+- Auto-bump: Detecta última tag e incrementa conforme tipo
+- Project detection: Identifica package.json, version files, etc.
+- Conflict prevention: Verifica tags existentes antes de proceder
+
+## 🤝 Integração @gitflow-specialist
+
+*Este comando sempre consulta @gitflow-specialist para release strategy validation, version bump analysis, branch creation guidance e troubleshooting de release workflows complexos.*
+
+## ⚠️ Resolução de Problemas
+
+### Version Required Error
+- **Sintoma**: Comando executado sem especificar versão
+- **Solução**: Fornecer versão específica ou tipo de bump (patch/minor/major)
+
+### Uncommitted Changes
+- **Causa**: Working directory não está limpo antes da release
+- **Fix**: `git add . && git commit -m "prepare for release"` antes de iniciar
+
+### Develop Branch Not Found
+- **Sintoma**: Develop branch não existe ou não está disponível
+- **Solução**: `git checkout -b develop` ou `git fetch origin develop`
+
+### Version Already Exists
+- **Causa**: Tag ou branch de release já existe para versão especificada
+- **Fix**: Usar versão diferente ou limpar tags/branches conflitantes
+
+### Primary Branch Detection Issues
+- **Sintoma**: Não consegue detectar main/master branch
+- **Solução**: Comando detecta automaticamente via @gitflow-specialist guidance
+
+### Release Branch Creation Failed
+- **Causa**: Problemas durante criação da branch de release
+- **Fix**: @gitflow-specialist fornece strategy específica para resolução

package/templates/.onion/contexts/technical/commands/advanced/reverse-consolidate.md

@@ -0,0 +1,160 @@
+---
+name: reverse-consolidate
+description: |
+  Engenharia reversa de projetos para gerar documentação consolidada.
+  Use como pré-processador para /docs/build-tech-docs.
+model: sonnet
+
+parameters:
+  - name: project_path
+    description: Caminho para o projeto a ser analisado
+    required: true
+  - name: output_path
+    description: Onde salvar documentação (default: docs/reverse/)
+    required: false
+
+category: docs
+tags:
+  - reverse-engineering
+  - documentation
+  - analysis
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /docs/build-tech-docs
+  - /docs/build-business-docs
+
+related_agents:
+  - docs-reverse-engineer
+  - system-documentation-orchestrator
+level: advanced
+context: technical
+---
+
+# 🔍 Engenharia Reversa de Projetos
+
+Orquestrador de engenharia reversa para gerar documentação consolidada.
+
+## 🎯 Objetivo
+
+Analisar qualquer projeto e gerar documento consolidado para `/docs/build-tech-docs`.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Validar Input
+
+```bash
+# Verificar path existe
+test -d "{{project_path}}" || { echo "❌ Path não existe"; exit 1; }
+
+# Verificar é projeto de software
+ls "{{project_path}}"/*.json "{{project_path}}"/*.yaml 2>/dev/null || \
+  echo "⚠️ Arquivos de config não detectados"
+```
+
+### Passo 2: Detectar Stack
+
+```bash
+# Package managers
+test -f package.json && STACK="javascript"
+test -f requirements.txt && STACK="python"
+test -f Cargo.toml && STACK="rust"
+test -f go.mod && STACK="go"
+
+# Frameworks
+grep -q "react" package.json && FRAMEWORK="react"
+grep -q "fastify" package.json && FRAMEWORK="fastify"
+grep -q "nx" package.json && MONOREPO="nx"
+```
+
+### Passo 3: Analisar Estrutura
+
+Delegar para @docs-reverse-engineer:
+
+1. **Directory Scan**
+   - Estrutura de pastas
+   - Padrões de arquivos
+   - Convenções de naming
+
+2. **Dependency Analysis**
+   - Dependências principais
+   - DevDependencies
+   - Peer dependencies
+
+3. **Architecture Detection**
+   - Padrões (MVC, DDD, Clean)
+   - Camadas identificadas
+   - Pontos de integração
+
+### Passo 4: Gerar Documento
+
+Criar `{{output_path}}/consolidated.md`:
+
+```markdown
+# Documentação Consolidada: [Nome do Projeto]
+
+## 📊 Metadados
+- Stack: [stack detectado]
+- Framework: [framework]
+- Monorepo: [sim/não]
+- Tamanho: [arquivos/linhas]
+
+## 🏗️ Arquitetura
+[Descrição da arquitetura detectada]
+
+## 📁 Estrutura
+[Árvore de diretórios comentada]
+
+## 🔧 Componentes Principais
+[Lista de módulos/componentes]
+
+## 🔗 Integrações
+[APIs, databases, serviços externos]
+
+## 📋 Recomendações
+[Sugestões para documentação adicional]
+```
+
+### Passo 5: Finalizar
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ ANÁLISE CONCLUÍDA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Projeto: {{project_path}}
+
+🔍 Stack Detectado:
+∟ Linguagem: TypeScript
+∟ Framework: React + Fastify
+∟ Monorepo: NX
+∟ Arquitetura: Clean Architecture
+
+📁 Arquivos Gerados:
+∟ docs/reverse/consolidated.md
+∟ docs/reverse/structure.json
+∟ docs/reverse/dependencies.json
+
+📈 Métricas:
+∟ Arquivos analisados: 245
+∟ Linhas de código: 12,450
+∟ Módulos: 18
+
+🚀 Próximo: /docs/build-tech-docs
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Agente: @docs-reverse-engineer
+- Próximo passo: /docs/build-tech-docs
+
+## ⚠️ Notas
+
+- Tempo médio: 2-5 minutos dependendo do tamanho
+- Funciona com JavaScript, Python, Rust, Go
+- Output otimizado para consumo por IA

package/templates/.onion/contexts/technical/commands/advanced/validate-phase-sync.md

@@ -0,0 +1,118 @@
+---
+name: validate-phase-sync
+description: Validar sincronização entre fases do plan.md e subtasks ClickUp.
+model: sonnet
+category: engineer
+tags: [validation, sync, clickup]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# 🔄 Validate Phase-Subtask Sync
+
+Validar e corrigir sincronização automática entre fases do plan.md e status das subtasks no ClickUp. Este comando identifica discrepâncias e corrige status desatualizados.
+
+## 🎯 Funcionalidades
+
+### Validação Automática de Status
+- Lê todas as fases do plan.md e identifica status atual (Completada ✅, Em Progresso ⏰, Não Iniciada ⏳)
+- Verifica status das subtasks correspondentes no ClickUp via Phase-Subtask Mapping
+- Identifica discrepâncias entre plan.md e ClickUp
+- Gera relatório de inconsistências encontradas
+
+### Correção Automática de Status
+- Atualiza automaticamente status das subtasks para refletir estado real das fases
+- Adiciona comentários retroativos nas subtasks com timestamp de correção
+- Documenta ações de correção realizadas
+- Valida integridade do mapeamento Phase→Subtask
+
+### Sistema de Alertas Proativo
+- Alerta quando mapeamento Phase-Subtask está ausente ou incompleto
+- Sugere criação de mapeamento quando detecta subtasks sem correlação
+- Identifica fases órfãs (sem subtask correspondente)
+- Reporta subtasks órfãs (sem fase correspondente)
+
+## 🚀 Como Usar
+
+```bash
+/engineer/validate-phase-sync
+```
+
+### Exemplos de Casos de Uso
+```bash
+/engineer/validate-phase-sync                    # Validação geral da sessão ativa
+/engineer/validate-phase-sync --fix-all         # Corrige todas inconsistências encontradas
+/engineer/validate-phase-sync --report-only     # Apenas relatório, não aplica correções
+```
+
+## 🤝 Integração ClickUp MCP
+
+### Operações Automáticas
+- **Leitura de Task**: Usa `get_task` com `subtasks=true` para estrutura completa
+- **Update de Status**: Aplica `update_task` nos subtasks com status correto
+- **Comentários de Correção**: Usa `create_task_comment` para documentar ajustes
+- **Validação de Integridade**: Verifica se mapeamento está correto e completo
+
+### Mapeamento Phase-Subtask
+Lê o mapeamento do arquivo `.cursor/sessions/[slug]/context.md`:
+```markdown
+## 📋 Phase-Subtask Mapping
+- **Phase 1**: "Template Consolidation" → Subtask ID: [id-1]
+- **Phase 2**: "Feature Commands" → Subtask ID: [id-2]
+- **Phase 3**: "Release Commands" → Subtask ID: [id-3]
+```
+
+### Correções Aplicadas
+- Fases "Completada ✅" → Subtask status "done"  
+- Fases "Em Progresso ⏰" → Subtask status "in progress"
+- Fases "Não Iniciada ⏳" → Subtask status "to do"
+
+## ⚙️ Processo de Validação
+
+1. **Detecta Sessão Ativa**: Identifica sessão em `.cursor/sessions/`
+2. **Lê Context.md**: Carrega mapeamento Phase-Subtask e task ID principal
+3. **Analisa Plan.md**: Extrai status atual de todas as fases
+4. **Consulta ClickUp**: Obtém status atual das subtasks via ClickUp MCP
+5. **Identifica Discrepâncias**: Compara status plan.md vs ClickUp
+6. **Aplica Correções**: Atualiza status das subtasks conforme necessário
+7. **Documenta Ações**: Registra todas correções aplicadas
+
+## ⚠️ Resolução de Problemas
+
+### Problema: "Mapeamento Phase-Subtask não encontrado"
+**Solução**: Verificar se context.md contém seção "Phase-Subtask Mapping"
+```bash
+# Execute se necessário:
+/engineer/create-phase-mapping
+```
+
+### Problema: "Subtask não encontrada no ClickUp"
+**Solução**: IDs do mapeamento podem estar incorretos
+- Verificar IDs das subtasks no ClickUp
+- Atualizar mapeamento no context.md
+- Executar validação novamente
+
+### Problema: "Múltiplas fases para mesma subtask"
+**Solução**: Revisar estrutura do projeto
+- Uma subtask deve corresponder a uma fase específica
+- Considerar quebrar fase complexa em múltiplas fases
+
+## 💡 Integração com Workflow
+
+### Uso Recomendado
+- **Durante desenvolvimento**: Executar ao final de cada sessão de trabalho
+- **Antes de PRs**: Validar sincronização completa antes de `/engineer/pr`
+- **Após interrupções**: Garantir consistência após retomar trabalho
+- **Debugging**: Identificar problemas de tracking de progresso
+
+### Prevenção Automática
+Este comando corrige o problema identificado onde `/engineer/work` não atualizava automaticamente os status das subtasks. Para projetos futuros:
+1. `/engineer/start` deve criar o mapeamento automaticamente
+2. `/engineer/work` deve usar este mapeamento para updates automáticos
+3. Este comando serve como backup/validação do processo automático
+
+---
+
+**🎯 CRITICAL FIX: Este comando resolve a falha arquitetural onde fases completadas não atualizavam automaticamente o status das subtasks correspondentes, garantindo sincronização perfeita entre plan.md e ClickUp.**

package/templates/.onion/contexts/technical/commands/help.md

@@ -0,0 +1,329 @@
+---
+name: help
+description: Lista comandos disponíveis do contexto Technical organizados por nível de complexidade
+model: sonnet
+category: technical
+tags: [help, discovery, onboarding, levels]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: technical
+---
+
+# Technical Context - Help
+
+Lista todos os comandos disponíveis no contexto **Technical**, organizados por nível de complexidade (starter, intermediate, advanced).
+
+---
+
+## 🎯 Uso
+
+```bash
+# Listar comandos starter (padrão - 80% dos casos)
+/technical/help
+
+# Listar comandos de um nível específico
+/technical/help --level=starter
+/technical/help --level=intermediate
+/technical/help --level=advanced
+
+# Listar todos os comandos
+/technical/help --level=all
+```
+
+---
+
+## 📋 Sistema de Níveis
+
+O Sistema Onion organiza comandos em **3 níveis** baseados na frequência de uso:
+
+| Nível | % Uso | Descrição | Onboarding |
+|-------|-------|-----------|------------|
+| **Starter** | 80% | Comandos essenciais para desenvolvimento diário | ~20 min |
+| **Intermediate** | 15% | Workflows avançados e operações especializadas | ~40 min |
+| **Advanced** | 5% | Automações complexas e casos edge | ~60 min |
+
+---
+
+## 📊 Comandos Disponíveis
+
+Você me pediu para executar o comando help. Vou listar os comandos organizados por nível:
+
+### 🌟 STARTER COMMANDS (8 comandos - 80% dos casos)
+**⏱️ Tempo de onboarding: ~20 minutos**
+
+Estes são os comandos que você usará no desenvolvimento diário:
+
+1. **`/technical/work "task-id"`**
+   - Continuar trabalho em feature ativa, lê sessão e identifica próxima fase
+   - Use quando: Retomar desenvolvimento de uma task em progresso
+   - Exemplo: `/technical/work "86adf8jj6"`
+
+2. **`/technical/plan "feature"`**
+   - Criar plano de desenvolvimento detalhado com fases
+   - Use quando: Iniciar nova feature, precisa quebrar em etapas
+   - Exemplo: `/technical/plan "user-authentication"`
+
+3. **`/technical/pr`**
+   - Criar Pull Request com descrição automática da sessão
+   - Use quando: Finalizar feature e submeter para review
+   - Exemplo: `/technical/pr`
+
+4. **`/technical/warm-up`**
+   - Preparar contexto técnico do projeto (stack, arquitetura, padrões)
+   - Use quando: Iniciar desenvolvimento em nova sessão
+   - Exemplo: `/technical/warm-up`
+
+5. **`/technical/docs`**
+   - Gerar/atualizar documentação técnica do projeto
+   - Use quando: Documentar feature implementada ou arquitetura
+   - Exemplo: `/technical/docs`
+
+6. **`/technical/sync`**
+   - Sincronizar branch local com remote, resolver conflitos
+   - Use quando: Atualizar código antes de começar desenvolvimento
+   - Exemplo: `/technical/sync`
+
+7. **`/technical/init`**
+   - Inicializar repositório git com gitflow ou outro workflow
+   - Use quando: Setup inicial de novo projeto
+   - Exemplo: `/technical/init`
+
+8. **`/technical/help`**
+   - Este comando! Lista comandos disponíveis por nível
+   - Use quando: Descobrir comandos ou aprender sistema
+   - Exemplo: `/technical/help --level=intermediate`
+
+---
+
+### 🔧 INTERMEDIATE COMMANDS (13 comandos - 15% dos casos)
+**⏱️ Tempo de onboarding: ~40 minutos**
+
+Comandos para workflows mais avançados:
+
+1. **`/technical/start "feature"`** - Iniciar nova feature (cria sessão, branch, plan)
+2. **`/technical/pre-pr`** - Validar código antes de criar PR (lint, tests, docs)
+3. **`/technical/pr-update`** - Atualizar PR existente com novos commits e descrição
+4. **`/technical/code-review`** - Realizar code review com checklist de qualidade
+5. **`/technical/fast-commit`** - Commit rápido seguindo conventional commits
+6. **`/technical/build-index`** - Construir índice de documentação técnica
+7. **`/technical/build-tech-docs`** - Gerar documentação técnica completa
+8. **`/technical/build-business-docs`** - Gerar documentação de negócio
+9. **`/technical/validate-docs`** - Validar consistência da documentação
+10. **`/technical/docs-health`** - Analisar saúde da documentação (cobertura, atualização)
+11. **`/technical/sync-sessions`** - Sincronizar sessões de desenvolvimento
+12. **`/technical/unit`** - Executar/criar testes unitários
+13. **`/technical/integration`** - Executar/criar testes de integração
+
+---
+
+### ⚡ ADVANCED COMMANDS (14 comandos - 5% dos casos)
+**⏱️ Tempo de onboarding: ~60 minutos**
+
+Comandos especializados para casos específicos:
+
+**Gestão de Releases:**
+1. **`/technical/bump`** - Incrementar versão do projeto (semver)
+2. **`/technical/hotfix`** - Criar branch de hotfix para correção urgente
+3. **`/technical/validate-phase-sync`** - Validar sincronização entre fases de desenvolvimento
+
+**Documentação Avançada:**
+4. **`/technical/refine-vision`** - Refinar visão técnica do projeto
+5. **`/technical/consolidate-documents`** - Consolidar múltiplos documentos
+6. **`/technical/reverse-consolidate`** - Reverter consolidação de documentos
+
+**Testes Avançados:**
+7. **`/technical/e2e`** - Executar/criar testes end-to-end
+
+**Git Workflows (Feature):**
+8. **`/technical/feature-start`** - Iniciar branch de feature (gitflow)
+9. **`/technical/feature-finish`** - Finalizar branch de feature
+10. **`/technical/feature-publish`** - Publicar feature em remote
+
+**Git Workflows (Hotfix):**
+11. **`/technical/hotfix-start`** - Iniciar hotfix
+12. **`/technical/hotfix-finish`** - Finalizar hotfix
+
+**Git Workflows (Release):**
+13. **`/technical/release-start`** - Iniciar release
+14. **`/technical/release-finish`** - Finalizar release
+
+---
+
+## 🚀 Próximos Passos
+
+### Se você é novo no Technical Context:
+
+1. **Comece pelos Starter Commands** (os 8 primeiros)
+   - Foque em `/technical/work` e `/technical/plan`
+   - Pratique criando uma sessão de desenvolvimento
+   - Tempo estimado: 20-30 minutos
+
+2. **Explore Intermediate Commands**
+   - Experimente `/technical/start` para workflow completo
+   - Use `/technical/pre-pr` para validar qualidade
+   - Tempo estimado: +40 minutos
+
+3. **Descubra Agentes Especializados**
+   ```bash
+   @react-developer            # Desenvolvimento React/Frontend
+   @nodejs-specialist          # Backend Node.js
+   @postgres-specialist        # Database PostgreSQL
+   @zen-engine-specialist      # ZenStack ORM
+   @test-engineer              # Testes automatizados
+   @code-reviewer              # Review de código
+   ```
+
+### Workflow Típico de Desenvolvimento:
+
+```bash
+# 1. Iniciar nova feature
+/technical/start "user-dashboard"
+
+# 2. Durante desenvolvimento
+/technical/work "task-id"
+
+# 3. Antes de finalizar
+/technical/pre-pr
+
+# 4. Criar Pull Request
+/technical/pr
+
+# 5. Após merge
+/technical/sync
+```
+
+### Pronto para Business Context?
+
+Para especificações e planejamento de produto:
+```bash
+/business/help               # Comandos de produto/negócio
+/business/spec "feature"     # Criar especificação
+```
+
+---
+
+## 📚 Documentação Relacionada
+
+- **Sistema de Níveis**: `docs/onion/levels-system.md`
+- **READMEs**: `.onion/contexts/technical/README.md`
+- **Agentes**: `.onion/contexts/technical/agents/`
+- **Configuração**: `.onion/contexts/technical/.context-config.yml`
+- **Sessions**: `.cursor/sessions/` (rastreamento de desenvolvimento)
+
+---
+
+## 💡 Dicas Úteis
+
+### Filosofia 80/15/5
+- **80%** do seu tempo: Use apenas comandos **starter**
+- **15%** do seu tempo: Use comandos **intermediate**
+- **5%** do seu tempo: Use comandos **advanced**
+
+### Descoberta Progressiva
+Cada comando inclui seção "🚀 Próximos Passos" sugerindo o que fazer em seguida.
+
+### Sessions & Context Management
+O Onion v4 rastreia suas sessões de desenvolvimento:
+- `.cursor/sessions/[feature]/` contém context.md, plan.md, architecture.md
+- Comandos `/work` e `/start` gerenciam automaticamente
+- Sessions são **CAMADA 5** do ciclo completo Onion
+
+### Flags e Opções
+```bash
+--level=starter       # Filtrar por nível
+--level=all          # Ver todos os níveis
+```
+
+---
+
+## 🎓 Onboarding Recomendado
+
+### Dia 1 (30 minutos)
+1. Execute `/technical/warm-up`
+2. Pratique `/technical/plan "test-feature"`
+3. Teste `/technical/work` em uma task real
+
+### Semana 1 (3 horas)
+- Domine os 8 starter commands
+- Experimente 4-5 intermediate commands
+- Crie sua primeira feature completa (start → work → pr)
+
+### Mês 1 (8 horas)
+- Explore todos os intermediate commands
+- Teste gitflow (feature/hotfix/release)
+- Integre no workflow diário da equipe
+
+---
+
+## 🔄 Integração com Business Context
+
+O Technical Context trabalha em conjunto com Business:
+
+```bash
+# 1. Business: Criar especificação
+/business/spec "dashboard-analytics"
+
+# 2. Business: Estimar complexidade
+/business/estimate "dashboard-analytics"
+
+# 3. Business: Criar task
+/business/task "dashboard-analytics"
+
+# 4. Technical: Iniciar desenvolvimento
+/technical/start "dashboard-analytics"
+
+# 5. Technical: Desenvolver
+/technical/work "task-id"
+
+# 6. Technical: Finalizar
+/technical/pr
+```
+
+---
+
+**📊 Estatísticas do Technical Context:**
+- **Total**: 36 comandos (mais que business!)
+- **Starter**: 8 (22%)
+- **Intermediate**: 13 (36%)
+- **Advanced**: 14 (39%)
+- **Agentes**: 23 especializados
+- **Tempo total onboarding**: ~120 minutos (todos os níveis)
+
+---
+
+## 🏗️ Arquitetura de Sessions
+
+```
+.cursor/sessions/
+├── feature-x/
+│   ├── context.md       # Objetivo, requisitos, decisões
+│   ├── architecture.md  # Design técnico, trade-offs
+│   ├── plan.md          # Fases de implementação
+│   └── notes.md         # Notas de desenvolvimento
+└── feature-y/
+    └── ...
+```
+
+Comandos que gerenciam sessions automaticamente:
+- `/technical/start` - Cria nova session
+- `/technical/work` - Lê e atualiza session ativa
+- `/technical/pr` - Usa session para gerar descrição
+
+---
+
+## 🆘 Precisa de Ajuda?
+
+- **Help de outro contexto**: `/business/help`, `/customer-success/help`
+- **Help global**: `/help`
+- **Agente de ajuda**: `@onion` (orquestrador principal)
+- **Documentação**: `docs/onion/`
+- **Agentes especializados**: 
+  - `@cursor-specialist` - Problemas com IDE
+  - `@gitflow-specialist` - Workflows git
+  - `@nx-monorepo-specialist` - Monorepo NX
+
+---
+
+**Sistema Onion v4.0** - Multi-Context Development Orchestrator 🧅
+