up-cc 0.14.0 → 0.16.0

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "up-cc",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Simplified spec-driven development for Claude Code, Gemini, OpenCode and OpenAI Codex.",
   "bin": {
-    "up-cc": "bin/install.js"
+    "up-cc": "up/bin/install.js"
   },
   "files": [
-    "bin",
-    "agents",
-    "commands",
-    "workflows",
-    "templates",
-    "references",
-    "hooks"
+    "up/bin",
+    "up/agents",
+    "up/commands",
+    "up/workflows",
+    "up/templates",
+    "up/references",
+    "up/hooks"
   ],
   "keywords": [
     "claude",

package/{agents → up/agents}/up-architecture-supervisor.md

@@ -21,7 +21,7 @@ Leitura obrigatoria do disco:
 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.
+Leitura sob demanda: `references/governance-rules-compressed.md` ou `references/engineering-principles-compressed.md` se precisar de detalhe.
 </role>
 
 <criteria>

package/{agents → up/agents}/up-audit-supervisor.md

@@ -23,7 +23,7 @@ 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`
+- `references/production-requirements-compressed.md`
 
 Estas references SAO grandes — so carregue se precisar fazer cross-check rigoroso. Para validacao normal, basta o relatorio do auditor.
 </role>

package/{agents → up/agents}/up-backend-specialist.md

@@ -29,10 +29,20 @@ Os 6 principios sao injetados em forma comprimida no prompt do workflow (~400 to
 
 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.
+**Sob demanda apenas:** Se precisa de exemplo detalhado, use Read em `$HOME/.claude/up/references/engineering-principles-compressed.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.
+**CRITICO: Pre-inline context (v0.11+)**
+O orquestrador pode injetar contexto direto no prompt via blocos:
+- `<plan_inlined>` — conteudo do PLAN.md (use direto, NAO refaca Read)
+- `<state_inlined>` — STATE.md (use direto)
+- `<config_inlined>` — config.json (use direto)
+- `<engineering_principles_compressed>` — principios (use direto)
+
+**Regra:** Se um bloco `*_inlined` ou `*_compressed` esta no prompt, USE direto.
+NUNCA faca Read do arquivo correspondente. Use Read SO em arquivos NAO presentes
+nesses blocos (ex: codigo a editar, AGENTS.md se relevante).
+
+**Fallback:** Se prompt contem `<files_to_read>` SEM inline equivalente, ai sim use Read.
 </role>
 
 <backend_rules>

package/{agents → up/agents}/up-chief-architect.md

@@ -19,7 +19,7 @@ Voce NAO trabalha no detalhe — o architecture-supervisor faz isso. Voce olha o
 Voce tem poder de **mandar refazer tudo** se a arquitetura esta fundamentalmente errada.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
+1. `$HOME/.claude/up/references/governance-rules-compressed.md`
 2. `.plano/BRIEFING.md`
 3. `.plano/OWNER.md`
 4. `.plano/PROJECT.md`

package/{agents → up/agents}/up-chief-engineer.md

@@ -21,7 +21,7 @@ Seu trabalho NAO e revisar cada linha de codigo (execution-supervisor faz isso).
 Voce age APOS cada fase completa (nao cada tarefa).
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
+1. `$HOME/.claude/up/references/governance-rules-compressed.md`
 2. `.plano/SYSTEM-DESIGN.md`
 3. `.plano/ROADMAP.md`
 4. SUMMARYs das fases completadas

package/{agents → up/agents}/up-chief-operations.md

@@ -19,8 +19,8 @@ Seu trabalho: garantir que o projeto esta pronto pra ir pra producao. Nao do pon
 - Env vars estao documentadas?
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
-2. `$HOME/.claude/up/references/production-requirements.md`
+1. `$HOME/.claude/up/references/governance-rules-compressed.md`
+2. `$HOME/.claude/up/references/production-requirements-compressed.md`
 3. Dockerfile, docker-compose, CI/CD configs
 4. README, CHANGELOG, docs
 5. .env.example

package/{agents → up/agents}/up-chief-product.md

@@ -13,7 +13,7 @@ Supervisiona: product-supervisor.
 Seu trabalho: garantir que o produto sendo construido **resolve o problema real** do dono, nao so "segue o briefing literalmente".
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
+1. `$HOME/.claude/up/references/governance-rules-compressed.md`
 2. `.plano/BRIEFING.md`
 3. `.plano/OWNER.md`
 4. `.plano/PROJECT.md`

package/{agents → up/agents}/up-chief-quality.md

@@ -15,7 +15,7 @@ Seu trabalho e CONSOLIDAR os scores de qualidade do projeto inteiro e decidir se
 Voce tem poder de **veto** — mesmo que todos supervisores aprovem, voce pode bloquear se o score global esta fraco.
 
 **CRITICO: Leitura Inicial Obrigatoria**
-1. `$HOME/.claude/up/references/governance-rules.md`
+1. `$HOME/.claude/up/references/governance-rules-compressed.md`
 2. `.plano/CHECKLIST.md`
 3. Todos os relatorios de verificacao, DCRV, security, melhorias, QA
 4. Todos os reviews dos supervisores de qualidade

package/{agents → up/agents}/up-code-reviewer.md

@@ -20,7 +20,7 @@ Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read
 
 ## 1. Production Requirements Compliance
 
-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`.
+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-compressed.md`.
 
 Verifique:
 
@@ -87,7 +87,7 @@ Para cada violacao: anotar arquivo, linha, requisito violado, e sugestao de fix.
 
 ## 7. Engineering Principles Compliance
 
-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`).
+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-compressed.md`).
 
 Verifique:
 

package/{agents → up/agents}/up-database-specialist.md

@@ -28,10 +28,20 @@ Os 6 principios sao injetados em forma comprimida no prompt do workflow (~400 to
 
 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.
+**Sob demanda apenas:** Use Read em `$HOME/.claude/up/references/engineering-principles-compressed.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.
+**CRITICO: Pre-inline context (v0.11+)**
+O orquestrador pode injetar contexto direto no prompt via blocos:
+- `<plan_inlined>` — conteudo do PLAN.md (use direto, NAO refaca Read)
+- `<state_inlined>` — STATE.md (use direto)
+- `<config_inlined>` — config.json (use direto)
+- `<engineering_principles_compressed>` — principios (use direto)
+
+**Regra:** Se um bloco `*_inlined` ou `*_compressed` esta no prompt, USE direto.
+NUNCA faca Read do arquivo correspondente. Use Read SO em arquivos NAO presentes
+nesses blocos (ex: codigo a editar, AGENTS.md se relevante).
+
+**Fallback:** Se prompt contem `<files_to_read>` SEM inline equivalente, ai sim use Read.
 </role>
 
 <database_rules>

package/{agents → up/agents}/up-execution-supervisor.md

@@ -32,10 +32,10 @@ Voce DEVE ler do disco apenas:
 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
+- `$HOME/.claude/up/references/engineering-principles-compressed.md` — exemplos completos dos 6 principios
+- `$HOME/.claude/up/references/governance-rules-compressed.md` — hierarquia completa, poderes por nivel
+- `$HOME/.claude/up/references/rework-limits-compressed.md` — fluxos de ciclo completos
+- `$HOME/.claude/up/references/production-requirements-compressed.md` — IDs e descricao de cada um dos 71 requisitos
 
 Default: NAO carregue references full. Use as versoes comprimidas injetadas no prompt.
 </role>

package/{agents → up/agents}/up-executor.md

@@ -22,10 +22,22 @@ Os 6 principios sao injetados em forma comprimida no prompt do workflow (~400 to
 
 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.
+**Sob demanda apenas:** Se precisa de exemplo detalhado, use Read em `$HOME/.claude/up/references/engineering-principles-compressed.md`. Default: NAO carregue.
+
+**CRITICO: Pre-inline context (v0.11+)**
+O orquestrador pode injetar contexto direto no prompt via blocos:
+- `<plan_inlined>` — conteudo do PLAN.md (use direto, NAO refaca Read)
+- `<state_inlined>` — STATE.md (use direto)
+- `<config_inlined>` — config.json (use direto)
+- `<engineering_principles_compressed>` — principios (use direto)
+- `<governance_compressed>` — regras (use direto)
+- `<requirements_slice_inlined>` — REQUIREMENTS-SLICE.md da fase
+
+**Regra:** Se um bloco `*_inlined` ou `*_compressed` esta no prompt, USE direto.
+NUNCA faca Read do arquivo correspondente — desperdiça tokens. Use Read SO em
+arquivos NAO presentes nesses blocos (ex: codigo a editar, AGENTS.md se relevante).
+
+**Fallback:** Se prompt contem `<files_to_read>` SEM inline equivalente, ai sim use Read.
 </role>
 
 <project_context>
@@ -37,23 +49,26 @@ Antes de executar, descubra o contexto do projeto:
 1. Liste skills disponiveis (subdiretorios)
 2. Leia `SKILL.md` de cada skill
 3. Carregue `rules/*.md` conforme necessario durante implementacao
-4. Carregue `AGENTS.md` quando necessario (com 1M de contexto, 100KB e aceitavel)
+4. Carregue `AGENTS.md` APENAS se relevante a tarefa atual. Prefira ler so as secoes relevantes via Grep/offset.
 5. Siga regras das skills relevantes a sua tarefa atual
 </project_context>
 
 <execution_flow>
 
 <step name="load_project_state" priority="first">
-Carregue o contexto de execucao:
+Carregue o contexto de execucao.
+
+**Se prompt tem `<state_inlined>` e `<config_inlined>`:** USE direto. Pular Read.
+**Caso contrario:** Read STATE.md e config.json:
 
 ```bash
 INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init executar-fase "${PHASE}")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 
-Extraia do JSON init: `executor_model`, `commit_docs`, `phase_dir`, `plans`, `incomplete_plans`.
+Extraia do JSON init (ou do `<config_inlined>`): `executor_model`, `commit_docs`, `phase_dir`, `plans`, `incomplete_plans`.
 
-Leia STATE.md para posicao, decisoes, bloqueios:
+Leia STATE.md (so se nao inlineado):
 ```bash
 cat .plano/STATE.md 2>/dev/null
 ```
@@ -63,7 +78,8 @@ Se .plano/ ausente: Erro — projeto nao inicializado.
 </step>
 
 <step name="load_plan">
-Leia o arquivo do plano fornecido no contexto do prompt.
+**Se prompt tem `<plan_inlined>`:** USE direto. NAO faca Read do arquivo.
+**Caso contrario:** Leia o arquivo do plano fornecido no contexto do prompt.
 
 Parse: frontmatter (phase, plan, type, autonomous, wave, depends_on), objetivo, contexto (referencias @), tarefas com tipos, criterios de verificacao/sucesso, spec de output.
 
@@ -74,7 +90,89 @@ Parse: frontmatter (phase, plan, type, autonomous, wave, depends_on), objetivo,
 ```bash
 PLAN_START_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
 PLAN_START_EPOCH=$(date +%s)
+
+# Wave 3 (v0.12+) — timeout supervisor + stuck detector
+mkdir -p .plano/runtime
+ACTIVITY_LOG=".plano/runtime/agent-activity-${PHASE:-current}.log"
+echo "${PLAN_START_TIME}|start|${PHASE:-current}" >> "$ACTIVITY_LOG"
+LAST_ACTIVITY_EPOCH=$PLAN_START_EPOCH
+
+# Defaults: 20m soft, 30m hard, 10m idle. Override via env if needed.
+TIMEOUT_SOFT=${UP_TIMEOUT_SOFT:-1200}
+TIMEOUT_HARD=${UP_TIMEOUT_HARD:-1800}
+TIMEOUT_IDLE=${UP_TIMEOUT_IDLE:-600}
+```
+</step>
+
+<step name="timeout_check_protocol">
+**Wave 3 (v0.12+) — Timeout & Stuck Detection**
+
+**Apos cada tarefa do plano** (entre tarefas, NAO entre tool calls):
+
+1. Append activity log com a tarefa que acabou:
+```bash
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ)|task_complete|task_${TASK_NUMBER}" >> "$ACTIVITY_LOG"
+LAST_ACTIVITY_EPOCH=$(date +%s)
+```
+
+2. Check timeout:
+```bash
+TIMEOUT=$(node "$HOME/.claude/up/bin/up-tools.cjs" timeout \
+  --start $PLAN_START_EPOCH \
+  --soft $TIMEOUT_SOFT \
+  --hard $TIMEOUT_HARD \
+  --idle-since $LAST_ACTIVITY_EPOCH \
+  --idle $TIMEOUT_IDLE \
+  --raw)
+TIMEOUT_STATUS=$(echo "$TIMEOUT" | head -1 | cut -d'|' -f1 | xargs)
+```
+
+3. Check stuck pattern:
+```bash
+STUCK=$(node "$HOME/.claude/up/bin/up-tools.cjs" stuck-check \
+  --log "$ACTIVITY_LOG" \
+  --window 10 \
+  --threshold 3 \
+  --raw)
+STUCK_FLAG=$(echo "$STUCK" | grep -oE "STUCK|ok" | head -1)
+```
+
+4. **Decisao por status:**
+
+- `ok`: continuar normal
+- `soft_warning`: prosseguir mas acelerar — pular tarefas opcionais, simplificar implementacao
+- `idle_warning`: gerar log e tentar destravar; se proxima tarefa nao avanca, abortar
+- `hard_abort`: PARAR IMEDIATAMENTE, salvar parcial e retornar
+- `STUCK` detectado: PARAR IMEDIATAMENTE, salvar parcial e retornar
+
+5. **Se hard_abort ou STUCK:**
+
+```bash
+mkdir -p .plano/governance
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ)|phase-${PHASE}|executor|ABORTED_${TIMEOUT_STATUS:-STUCK}|elapsed=$((${$(date +%s)} - PLAN_START_EPOCH))s, last_task=${TASK_NUMBER}" >> .plano/governance/aborts.log
+
+# Salvar PARTIAL-SUMMARY com tarefas completas e onde parou
+cat > "${PHASE_DIR}/PARTIAL-SUMMARY.md" <<EOF
+---
+phase: ${PHASE}
+status: aborted
+reason: ${TIMEOUT_STATUS:-stuck}
+elapsed_secs: $(( $(date +%s) - PLAN_START_EPOCH ))
+last_completed_task: ${TASK_NUMBER}
+EOF
 ```
+
+Retornar mensagem estruturada:
+```
+ABORTED: Fase {phase} abortada por {timeout|stuck}
+Tarefas completas: {N}/{TOTAL}
+Tempo decorrido: {elapsed}s
+Ultima tarefa: {task_id}
+Estado parcial salvo em: .plano/fases/{phase}/PARTIAL-SUMMARY.md
+Log de atividade: .plano/runtime/agent-activity-{phase}.log
+```
+
+NAO continuar trabalho apos abort. Orquestrador decide proximo passo.
 </step>
 
 <step name="determine_execution_pattern">

package/{agents → up/agents}/up-frontend-specialist.md

@@ -28,10 +28,20 @@ Os 6 principios sao injetados em forma comprimida no prompt do workflow (~400 to
 
 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.
+**Sob demanda apenas:** Se precisa de exemplo detalhado de algum principio, use Read em `$HOME/.claude/up/references/engineering-principles-compressed.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.
+**CRITICO: Pre-inline context (v0.11+)**
+O orquestrador pode injetar contexto direto no prompt via blocos:
+- `<plan_inlined>` — conteudo do PLAN.md (use direto, NAO refaca Read)
+- `<state_inlined>` — STATE.md (use direto)
+- `<config_inlined>` — config.json (use direto)
+- `<engineering_principles_compressed>` — principios (use direto)
+
+**Regra:** Se um bloco `*_inlined` ou `*_compressed` esta no prompt, USE direto.
+NUNCA faca Read do arquivo correspondente. Use Read SO em arquivos NAO presentes
+nesses blocos (ex: codigo a editar, AGENTS.md se relevante).
+
+**Fallback:** Se prompt contem `<files_to_read>` SEM inline equivalente, ai sim use Read.
 </role>
 
 <frontend_rules>

package/{agents → up/agents}/up-operations-supervisor.md

@@ -19,7 +19,7 @@ Governance rules + production requirements vem injetados no prompt do workflow e
 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.
+Leitura sob demanda: `references/production-requirements-compressed.md` se precisar de IDs especificos da categoria SEC ou DEPLOY.
 </role>
 
 <criteria>

package/{agents → up/agents}/up-planejador.md

@@ -87,7 +87,7 @@ Antes de planejar, descubra o contexto do projeto:
 1. Liste skills disponiveis (subdiretorios)
 2. Leia `SKILL.md` de cada skill (indice leve ~130 linhas)
 3. Carregue arquivos `rules/*.md` especificos conforme necessario durante o planejamento
-4. Carregue `AGENTS.md` quando necessario para entender padroes do projeto (com 1M de contexto, 100KB e aceitavel)
+4. Carregue `AGENTS.md` APENAS se relevante a tarefa atual. Prefira ler so as secoes relevantes via Grep/offset.
 5. Garanta que planos considerem padroes e convencoes das skills do projeto
 </project_context>
 
@@ -286,6 +286,22 @@ Apos criar PLAN.md, rode este checklist antes de retornar:
 - [ ] Cada tarefa tem files, action, verify, done?
 - [ ] Verificacao automatizada definida (regra Nyquist)?
 
+**Iron Rule (Wave 6+) — validar tamanho/decomposicao:**
+
+Para CADA PLAN.md gerado, rode:
+```bash
+node "$HOME/.claude/up/bin/up-tools.cjs" validate-plan {plan-path}
+```
+
+Limites: max 25kB, max 12 tarefas, frontmatter completo, criterios de verificacao.
+
+Se `pass=false`: NAO retorne. Analise as `suggestions` e refaca o plano:
+- Tamanho excede → quebrar em 2 planos por dominio (schema separado de API separado de UI)
+- Tarefas demais → mesma quebra
+- Sem frontmatter ou verification → adicionar antes de retornar
+
+Iron rule: "uma task DEVE caber em uma janela de contexto". Se o plano viola, executor vai falhar.
+
 Se qualquer item falhar, corrija ANTES de retornar. Nao dependa de checker externo.
 </self_check>
 

package/{agents → up/agents}/up-planning-supervisor.md

@@ -27,9 +27,9 @@ Leitura obrigatoria do disco:
 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
+- `references/engineering-principles-compressed.md` — exemplos completos
+- `references/governance-rules-compressed.md` — hierarquia detalhada
+- `references/rework-limits-compressed.md` — fluxos por ciclo
 </role>
 
 <criteria>

package/{agents → up/agents}/up-product-supervisor.md

@@ -21,7 +21,7 @@ Leitura obrigatoria do disco:
 2. `.plano/OWNER.md`
 3. Outputs do agente em avaliacao
 
-Leitura sob demanda: `references/governance-rules.md` se precisar de hierarquia detalhada.
+Leitura sob demanda: `references/governance-rules-compressed.md` se precisar de hierarquia detalhada.
 </role>
 
 <criteria>

package/{agents → up/agents}/up-project-ceo.md

@@ -24,7 +24,7 @@ Voce conhece o dono pelo arquivo `~/.claude/up/owner-profile.md` (global) e `.pl
 No inicio de qualquer trabalho, voce DEVE ler:
 1. `~/.claude/up/owner-profile.md` (para saber seu nome, tom e perfil do dono)
 2. `.plano/OWNER.md` se existir (para contexto do projeto atual)
-3. `$HOME/.claude/up/references/governance-rules.md` (suas regras)
+3. `$HOME/.claude/up/references/governance-rules-compressed.md` (suas regras)
 4. `$HOME/.claude/up/references/severity-levels.md` (quando interromper)
 </role>
 
@@ -288,7 +288,7 @@ Voce NAO modifica owner-profile.md global diretamente. Isso e feito via `/up:onb
 ```bash
 cat ~/.claude/up/owner-profile.md
 cat .plano/OWNER.md 2>/dev/null  # pode nao existir se projeto novo
-cat $HOME/.claude/up/references/governance-rules.md
+cat $HOME/.claude/up/references/governance-rules-compressed.md
 cat $HOME/.claude/up/references/severity-levels.md
 ```
 

package/{agents → up/agents}/up-quality-supervisor.md

@@ -23,7 +23,7 @@ Leitura obrigatoria do disco:
 4. QA-REPORT.md (se rodou)
 5. `.plano/DESIGN-TOKENS.md`
 
-Leitura sob demanda: `references/governance-rules.md` se precisar de detalhe.
+Leitura sob demanda: `references/governance-rules-compressed.md` se precisar de detalhe.
 </role>
 
 <criteria>

package/{agents → up/agents}/up-system-designer.md

@@ -12,7 +12,7 @@ Voce recebe:
 - PRODUCT-ANALYSIS.md (do Product Analyst) — features, personas, modulos
 - BRIEFING.md — stack e credenciais do usuario
 - Blueprints de producao (references/blueprints/) — features obrigatorias por tipo
-- Production requirements (references/production-requirements.md) — requisitos universais
+- Production requirements (references/production-requirements-compressed.md) — requisitos universais
 
 Voce produz:
 - SYSTEM-DESIGN.md — design tecnico completo (modulos, roles, schema, rotas, permissoes)
@@ -62,7 +62,7 @@ Ler cada blueprint selecionado.
 
 **Tambem carregar SEMPRE:**
 ```bash
-cat $HOME/.claude/up/references/production-requirements.md
+cat $HOME/.claude/up/references/production-requirements-compressed.md
 ```
 
 ## Passo 3: Definir Roles e Permissoes

package/{agents → up/agents}/up-verification-supervisor.md

@@ -23,7 +23,7 @@ Leitura obrigatoria do disco:
 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.
+Leitura sob demanda: `references/governance-rules-compressed.md` se precisar de detalhe.
 </role>
 
 <criteria>

package/{agents → up/agents}/up-visual-critic.md

@@ -151,7 +151,7 @@ Score por pagina: soma / 14 * 10 (escala 0-10)
 cat .plano/DESIGN-TOKENS.md 2>/dev/null
 
 # Production requirements (secao POLISH)
-cat $HOME/.claude/up/references/production-requirements.md
+cat $HOME/.claude/up/references/production-requirements-compressed.md
 ```
 
 Se DESIGN-TOKENS.md existe: usar como referencia de cores, fontes, spacing, radius.