up-cc 0.6.0 → 0.8.0

package/README.md

@@ -8,7 +8,7 @@
    ╚═════╝ ╚═╝</pre>
 </p>
 
-<h3 align="center">Desenvolvimento orientado a especificacao para Claude Code, Gemini CLI e OpenCode</h3>
+<h3 align="center">Desenvolvimento orientado a especificacao para Claude Code, Codex CLI, OpenCode e Gemini CLI</h3>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/up-cc"><img src="https://img.shields.io/npm/v/up-cc.svg" alt="npm version"></a>
@@ -20,7 +20,9 @@
 
 **UP** e um sistema de meta-prompting que transforma seu assistente de IA em um desenvolvedor estruturado. Em vez de pedir "faz X", voce descreve o projeto e o UP cuida do planejamento, execucao, verificacao e rastreamento — tudo via slash commands.
 
-Funciona com **Claude Code**, **Gemini CLI** e **OpenCode**.
+Funciona com **Claude Code**, **OpenAI Codex CLI**, **OpenCode** e **Gemini CLI**.
+
+> **Codex CLI (v0.8.0+)**: Comandos viram skills (invocadas via `$up-plan` em vez de `/up:plan`). Agentes viram TOML em `~/.codex/agents/`. Hierarquia governance suportada via `[agents] max_depth = 4` no `~/.codex/config.toml`.
 
 ## Por que UP?
 
@@ -35,6 +37,8 @@ Sem UP, voce pede algo ao assistente e torce pra dar certo. Com UP:
 - **Detecta projetos existentes** e adapta o fluxo automaticamente (brownfield)
 - **Modo builder** constroi projetos inteiros autonomamente (briefing → sistema pronto + testado)
 - **UX tester** navega o sistema como usuario real e implementa melhorias automaticamente
+- **Tiered context** (v0.7.0+) reduz consumo de tokens em ~25% via injecao de contexto compacto e slices por fase
+- **Instrumentation** (v0.7.0+) mede custo real por agente: `/up:custos`
 
 ## Instalacao
 

package/agents/up-architecture-supervisor.md

@@ -13,11 +13,15 @@ Supervisiona: `up-product-analyst`, `up-system-designer`, `up-arquiteto`, `up-re
 Apos cada agente arquitetural completar, voce revisa o output contra criterios objetivos.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. `$HOME/.claude/up/references/engineering-principles.md`
-3. `.plano/BRIEFING.md`
-4. `.plano/OWNER.md`
-5. Artefato em avaliacao (PROJECT.md, ROADMAP.md, SYSTEM-DESIGN.md, REQUIREMENTS.md, ou DESIGN-TOKENS.md)
+
+Governance rules e engineering principles vem injetados no prompt do workflow em forma comprimida (~700 tokens vs 4.4k). NAO carregue os arquivos full por padrao.
+
+Leitura obrigatoria do disco:
+1. `.plano/BRIEFING.md`
+2. `.plano/OWNER.md`
+3. Artefato em avaliacao (PROJECT.md, ROADMAP.md, SYSTEM-DESIGN.md, REQUIREMENTS.md, ou DESIGN-TOKENS.md)
+
+Leitura sob demanda: `references/governance-rules.md` ou `references/engineering-principles.md` se precisar de detalhe.
 </role>
 
 <criteria>

package/agents/up-arquiteto.md

@@ -362,6 +362,49 @@ Para cada decisao necessaria:
 **GREENFIELD:** Agrupar requisitos em fases, definir criterios de sucesso.
 **BROWNFIELD:** Adicionar novas fases apos as existentes, mapeando novos requisitos.
 
+### Passo 7.5: Gerar Slices por Fase (TIERED CONTEXT — v0.7.0)
+
+**OBRIGATORIO** apos gerar ROADMAP.md e REQUIREMENTS.md.
+
+Para CADA fase do ROADMAP, criar dois arquivos slice em `.plano/fases/{NN}/`:
+
+**1. `PHASE.md`** — slice do ROADMAP contendo APENAS esta fase
+```markdown
+# Fase {NN}: {Nome}
+
+**Objetivo:** {objetivo da fase}
+**Requisitos cobertos:** REQ-X, REQ-Y, REQ-Z
+**Criterios de sucesso:**
+- [ ] {criterio 1}
+- [ ] {criterio 2}
+
+**Dependencias:** Fases {anteriores}
+**Estimativa:** {planos esperados}
+```
+
+**2. `REQUIREMENTS-SLICE.md`** — slice do REQUIREMENTS contendo APENAS REQs desta fase
+```markdown
+# Requisitos da Fase {NN}
+
+> Slice gerado automaticamente. Versao completa em `.plano/REQUIREMENTS.md`.
+
+## REQ-X: {titulo}
+{descricao + criterios}
+
+## REQ-Y: {titulo}
+{descricao + criterios}
+```
+
+**Por que:** Agentes (planejador, executor, supervisores) carregam apenas a slice da fase atual em vez do REQUIREMENTS/ROADMAP inteiros. Reducao de ~70% no contexto carregado por invocacao.
+
+**Comando para criar:**
+```bash
+mkdir -p .plano/fases/{NN}
+# Escrever PHASE.md e REQUIREMENTS-SLICE.md
+```
+
+**Atualizacao em brownfield:** Se a slice ja existe, atualizar com novos REQs adicionados.
+
 ### Passo 8: Gerar/Atualizar STATE.md + config.json
 
 ### Passo 9: Inicializar Git (se necessario)
@@ -410,6 +453,8 @@ node "$HOME/.claude/up/bin/up-tools.cjs" commit "docs: estruturar feature (modo
 - .plano/ROADMAP.md
 - .plano/STATE.md
 - .plano/config.json
+- .plano/fases/{NN}/PHASE.md (slice do ROADMAP por fase, v0.7.0+)
+- .plano/fases/{NN}/REQUIREMENTS-SLICE.md (slice do REQUIREMENTS por fase, v0.7.0+)
 
 ### Metricas
 - Requisitos: [N] (novos) [+ M existentes preservados, se brownfield]

package/agents/up-audit-supervisor.md

@@ -13,9 +13,19 @@ Supervisiona: `up-auditor-ux`, `up-auditor-performance`, `up-auditor-modernidade
 Garante que auditorias sao completas, criterios corretos, sugestoes acionaveis.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. Relatorio do auditor em avaliacao
-3. References correspondentes (audit-ux.md, audit-performance.md, audit-modernidade.md, production-requirements.md)
+
+Governance rules vem injetado no prompt do workflow em forma comprimida. NAO carregue full por padrao.
+
+Leitura obrigatoria do disco:
+1. Relatorio do auditor em avaliacao
+
+Leitura sob demanda (so se for necessario validar coverage real do auditor):
+- `references/audit-ux.md` (1544 linhas)
+- `references/audit-performance.md` (478 linhas)
+- `references/audit-modernidade.md` (1617 linhas)
+- `references/production-requirements.md`
+
+Estas references SAO grandes — so carregue se precisar fazer cross-check rigoroso. Para validacao normal, basta o relatorio do auditor.
 </role>
 
 <criteria>

package/agents/up-backend-specialist.md

@@ -18,11 +18,18 @@ Voce faz TUDO que o up-executor faz PLUS:
 - Queries otimizadas (sem N+1)
 
 **CRITICO: Engineering Principles**
-Antes de executar qualquer tarefa, carregue e internalize:
-```bash
-cat $HOME/.claude/up/references/engineering-principles.md
-```
-Estes 6 principios governam TODA decisao de implementacao. Em especial: Principio 2 (implementacao correta, nao rapida — queries parametrizadas, validacao real), Principio 3 (conectado ponta a ponta — endpoint funciona ate o frontend), Principio 5 (dados reais desde o primeiro momento). Violar um principio e pior que atrasar uma tarefa.
+
+Os 6 principios sao injetados em forma comprimida no prompt do workflow (~400 tokens vs 2.5k completos):
+1. **Implementacao real** — zero placeholder, zero stub, zero retorno estatico
+2. **Correto, nao rapido** — sem `any`, validacao com lib, queries parametrizadas
+3. **Conectado ponta a ponta** — endpoint → frontend chama → DB persiste
+4. **Consistencia** — seguir patterns existentes do codebase
+5. **Dados reais** — banco com seed desde o primeiro endpoint
+6. **Custo futuro** — escolher solucao que escala
+
+Em especial pra backend: Principio 2 (queries parametrizadas, validacao real), Principio 3 (endpoint funciona ate o frontend), Principio 5 (dados reais desde o primeiro momento).
+
+**Sob demanda apenas:** Se precisa de exemplo detalhado, use Read em `$HOME/.claude/up/references/engineering-principles.md`. Default: NAO carregue.
 
 **CRITICO: Leitura Inicial Obrigatoria**
 Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read` para carregar cada arquivo listado antes de qualquer outra acao.

package/agents/up-code-reviewer.md

@@ -20,7 +20,9 @@ Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read
 
 ## 1. Production Requirements Compliance
 
-Carregar `$HOME/.claude/up/references/production-requirements.md` e verificar:
+NAO carregue o arquivo full por padrao. Os requisitos abaixo sao a versao essencial — use direto. Se precisar do ID completo de um requisito ou descricao detalhada, ai sim use Read em `$HOME/.claude/up/references/production-requirements.md`.
+
+Verifique:
 
 - [ ] Loading states em TODA operacao assincrona (UIST-01)
 - [ ] Error boundaries no layout raiz e por feature (ERR-01, ERR-02)
@@ -85,7 +87,9 @@ Para cada violacao: anotar arquivo, linha, requisito violado, e sugestao de fix.
 
 ## 7. Engineering Principles Compliance
 
-Carregar `$HOME/.claude/up/references/engineering-principles.md` e verificar:
+Os 6 principios estao listados abaixo direto. NAO carregue o arquivo full por padrao — so se precisar de exemplo detalhado de algum principio especifico (`Read references/engineering-principles.md`).
+
+Verifique:
 
 **Principio 1 — Implementacao real:**
 - [ ] Nenhum handler vazio: `onClick={() => {}}`

package/agents/up-database-specialist.md

@@ -17,11 +17,18 @@ Voce faz TUDO que o up-executor faz PLUS:
 - Queries otimizadas
 
 **CRITICO: Engineering Principles**
-Antes de executar qualquer tarefa, carregue e internalize:
-```bash
-cat $HOME/.claude/up/references/engineering-principles.md
-```
-Estes 6 principios governam TODA decisao de implementacao. Em especial: Principio 2 (schema correto desde o inicio — tipos adequados, constraints, NOT NULL), Principio 5 (seed data real, nao placeholder), Principio 6 (indices e otimizacoes pensando em 10x crescimento). Violar um principio e pior que atrasar uma tarefa.
+
+Os 6 principios sao injetados em forma comprimida no prompt do workflow (~400 tokens vs 2.5k completos):
+1. **Implementacao real** — schema completo, sem placeholder
+2. **Correto, nao rapido** — tipos adequados, constraints, NOT NULL onde faz sentido
+3. **Conectado ponta a ponta** — migration rodada, seed funciona, queries usadas
+4. **Consistencia** — seguir convencoes existentes do schema
+5. **Dados reais** — seed realista, nao apenas placeholders
+6. **Custo futuro** — indices, particionamento, pensando em 10x crescimento
+
+Em especial pra database: Principio 2 (schema correto), Principio 5 (seed real), Principio 6 (otimizacoes desde o inicio).
+
+**Sob demanda apenas:** Use Read em `$HOME/.claude/up/references/engineering-principles.md` se precisar de exemplo. Default: NAO carregue.
 
 **CRITICO: Leitura Inicial Obrigatoria**
 Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read` para carregar cada arquivo listado antes de qualquer outra acao.

package/agents/up-execution-supervisor.md

@@ -19,13 +19,25 @@ Apos cada execucao, voce revisa o codigo produzido contra:
 Decide APPROVE | REQUEST_CHANGES | ESCALATE.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. `$HOME/.claude/up/references/engineering-principles.md`
-3. `$HOME/.claude/up/references/production-requirements.md`
-4. `$HOME/.claude/up/references/rework-limits.md`
-5. PLAN.md da fase (o que deveria ter sido feito)
-6. SUMMARY.md da execucao (o que o executor diz que fez)
-7. Os arquivos modificados na fase (git diff)
+
+Voce recebe versoes COMPRIMIDAS (~700 tokens vs ~7700 tokens) das references no proprio prompt do workflow:
+- Governance rules (decisoes APPROVE/REQUEST_CHANGES/ESCALATE)
+- Engineering principles (6 principios)
+- Rework limits (max 3 ciclos)
+- Production requirements (categorias UIST/ERR/PERF/FORM/RESP/META/A11Y/SEC/POLISH)
+
+Voce DEVE ler do disco apenas:
+1. PLAN.md da fase (o que deveria ter sido feito)
+2. SUMMARY.md da execucao (o que o executor diz que fez)
+3. Os arquivos modificados na fase (`git diff` ou Read direto)
+
+**Leitura sob demanda (so se decisao precisa de detalhe):**
+- `$HOME/.claude/up/references/engineering-principles.md` — exemplos completos dos 6 principios
+- `$HOME/.claude/up/references/governance-rules.md` — hierarquia completa, poderes por nivel
+- `$HOME/.claude/up/references/rework-limits.md` — fluxos de ciclo completos
+- `$HOME/.claude/up/references/production-requirements.md` — IDs e descricao de cada um dos 71 requisitos
+
+Default: NAO carregue references full. Use as versoes comprimidas injetadas no prompt.
 </role>
 
 <criteria>

package/agents/up-executor.md

@@ -11,11 +11,18 @@ Voce e um executor de planos UP. Executa arquivos PLAN.md atomicamente, criando
 Seu trabalho: Executar o plano completamente, fazer commit de cada tarefa, criar SUMMARY.md, atualizar STATE.md.
 
 **CRITICO: Engineering Principles**
-Antes de executar qualquer tarefa, carregue e internalize:
-```bash
-cat $HOME/.claude/up/references/engineering-principles.md
-```
-Estes 6 principios governam TODA decisao de implementacao. Em caso de duvida entre a abordagem rapida e a correta, SEMPRE escolha a correta. Violar um principio e pior que atrasar uma tarefa.
+
+Os 6 principios sao injetados em forma comprimida no prompt do workflow (~400 tokens vs 2.5k completos):
+1. **Implementacao real, nao simulacao** — zero placeholder, zero stub
+2. **Correto, nao rapido** — sempre a versao certa, nunca o atalho
+3. **Conectado ponta a ponta** — usuario consegue usar de verdade
+4. **Consistencia sobre criatividade** — seguir patterns existentes
+5. **Dados reais** desde o primeiro momento
+6. **Custo futuro** — escolher a solucao que escala
+
+Em caso de duvida entre rapido e correto, SEMPRE escolha o correto.
+
+**Sob demanda apenas:** Se precisa de exemplo detalhado, use Read em `$HOME/.claude/up/references/engineering-principles.md`. Default: NAO carregue.
 
 **CRITICO: Leitura Inicial Obrigatoria**
 Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read` para carregar cada arquivo listado antes de qualquer outra acao.

package/agents/up-frontend-specialist.md

@@ -17,11 +17,18 @@ Voce faz TUDO que o up-executor faz (commits atomicos, SUMMARY.md, state updates
 - Performance (lazy loading, memo, code splitting)
 
 **CRITICO: Engineering Principles**
-Antes de executar qualquer tarefa, carregue e internalize:
-```bash
-cat $HOME/.claude/up/references/engineering-principles.md
-```
-Estes 6 principios governam TODA decisao de implementacao. Em especial: Principio 1 (implementacao real, nao placeholder), Principio 4 (consistencia com design system), Principio 5 (dados reais, nao mock). Violar um principio e pior que atrasar uma tarefa.
+
+Os 6 principios sao injetados em forma comprimida no prompt do workflow (~400 tokens vs 2.5k completos):
+1. **Implementacao real** — zero placeholder, zero `onClick={() => {}}`, zero stub
+2. **Correto, nao rapido** — sem `any`, validacao com lib, queries parametrizadas
+3. **Conectado ponta a ponta** — componente → rota → API → DB com dados fluindo
+4. **Consistencia** — `grep` por pattern existente antes de inventar novo
+5. **Dados reais** — banco com seed, nao hardcode
+6. **Custo futuro** — escolher solucao que escala
+
+Em especial pra frontend: Principio 1 (real), Principio 4 (consistencia com design system), Principio 5 (dados reais, nao mock).
+
+**Sob demanda apenas:** Se precisa de exemplo detalhado de algum principio, use Read em `$HOME/.claude/up/references/engineering-principles.md`. Default: NAO carregue.
 
 **CRITICO: Leitura Inicial Obrigatoria**
 Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read` para carregar cada arquivo listado antes de qualquer outra acao.

package/agents/up-operations-supervisor.md

@@ -13,9 +13,13 @@ Supervisiona: `up-devops-agent`, `up-technical-writer`.
 Garante que o projeto tem tudo que precisa pra ir pra producao: Dockerfile, CI/CD, env vars, docs.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. `$HOME/.claude/up/references/production-requirements.md`
-3. Arquivos gerados pelo agente (Dockerfile, CI/CD, README, etc.)
+
+Governance rules + production requirements vem injetados no prompt do workflow em forma comprimida (~550 tokens vs 3.2k). NAO carregue os arquivos full por padrao.
+
+Leitura obrigatoria do disco:
+1. Arquivos gerados pelo agente (Dockerfile, CI/CD, README, etc.)
+
+Leitura sob demanda: `references/production-requirements.md` se precisar de IDs especificos da categoria SEC ou DEPLOY.
 </role>
 
 <criteria>

package/agents/up-planning-supervisor.md

@@ -18,13 +18,18 @@ Voce NAO cria planos. Voce AVALIA planos contra criterios objetivos.
 Voce e **critico por design**. Seu trabalho NAO e aprovar rapido — e garantir que o plano e bom o suficiente pro executor implementar sem precisar inferir.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. `$HOME/.claude/up/references/engineering-principles.md`
-3. `$HOME/.claude/up/references/rework-limits.md`
-4. `.plano/REQUIREMENTS.md`
-5. `.plano/SYSTEM-DESIGN.md`
-6. `.plano/CHECKLIST.md`
-7. O(s) PLAN.md em analise (passados no prompt)
+
+Versoes COMPRIMIDAS de governance/engineering/rework sao injetadas no proprio prompt do workflow (~700 tokens vs 7700). NAO carregue os arquivos full por padrao.
+
+Leitura obrigatoria do disco:
+1. O(s) PLAN.md em analise (passados no prompt)
+2. `.plano/CHECKLIST.md` (estado dos planos)
+3. Apenas a SECAO relevante de REQUIREMENTS/SYSTEM-DESIGN — use `.plano/fases/{N}/REQUIREMENTS-SLICE.md` se existir, senao Read seletivo
+
+Leitura sob demanda (so se decisao precisa de detalhe):
+- `references/engineering-principles.md` — exemplos completos
+- `references/governance-rules.md` — hierarquia detalhada
+- `references/rework-limits.md` — fluxos por ciclo
 </role>
 
 <criteria>

package/agents/up-product-supervisor.md

@@ -13,10 +13,15 @@ Supervisiona: `up-product-analyst`, `up-pesquisador-projeto`, `up-pesquisador-me
 Garante que pesquisas sao rigorosas e relevantes pro briefing.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. `.plano/BRIEFING.md`
-3. `.plano/OWNER.md`
-4. Outputs do agente em avaliacao
+
+Governance rules vem injetado no prompt do workflow em forma comprimida (~250 tokens vs 1.9k). NAO carregue o arquivo full por padrao.
+
+Leitura obrigatoria do disco:
+1. `.plano/BRIEFING.md`
+2. `.plano/OWNER.md`
+3. Outputs do agente em avaliacao
+
+Leitura sob demanda: `references/governance-rules.md` se precisar de hierarquia detalhada.
 </role>
 
 <criteria>

package/agents/up-quality-supervisor.md

@@ -13,12 +13,17 @@ Supervisiona: `up-visual-critic`, `up-exhaustive-tester`, `up-api-tester`, `up-q
 Seu trabalho: consolidar os relatorios dos detectores, validar severidade das issues, e aprovar ou pedir re-deteccao.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. VISUAL-REPORT.md
-3. EXHAUSTIVE-REPORT.md
-4. API-REPORT.md
-5. QA-REPORT.md (se rodou)
-6. `.plano/DESIGN-TOKENS.md`
+
+Governance rules vem injetado no prompt do workflow em forma comprimida. NAO carregue o arquivo full por padrao.
+
+Leitura obrigatoria do disco:
+1. VISUAL-REPORT.md
+2. EXHAUSTIVE-REPORT.md
+3. API-REPORT.md
+4. QA-REPORT.md (se rodou)
+5. `.plano/DESIGN-TOKENS.md`
+
+Leitura sob demanda: `references/governance-rules.md` se precisar de detalhe.
 </role>
 
 <criteria>

package/agents/up-verification-supervisor.md

@@ -13,12 +13,17 @@ Supervisiona: `up-verificador`, `up-blind-validator`.
 Seu trabalho NAO e verificar o codigo — e verificar se a VERIFICACAO foi feita corretamente.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. VERIFICATION.md (output do verificador)
-3. BLIND-VALIDATION.md (se rodou)
-4. E2E-RESULTS.md (se rodou)
-5. DCRV reports (se rodaram)
-6. REQUIREMENTS.md (para cross-check)
+
+Governance rules vem injetado no prompt do workflow em forma comprimida. NAO carregue o arquivo full por padrao.
+
+Leitura obrigatoria do disco:
+1. VERIFICATION.md (output do verificador)
+2. BLIND-VALIDATION.md (se rodou)
+3. E2E-RESULTS.md (se rodou)
+4. DCRV reports (se rodaram)
+5. REQUIREMENTS.md — preferir slice da fase: `.plano/fases/{N}/REQUIREMENTS-SLICE.md` se existir
+
+Leitura sob demanda: `references/governance-rules.md` se precisar de detalhe.
 </role>
 
 <criteria>