up-cc 0.3.2 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agents/up-executor.md +3 -3
- package/agents/up-planejador.md +13 -13
- package/bin/lib/core.cjs +1 -1
- package/commands/depurar.md +1 -1
- package/hooks/up-context-monitor.js +2 -2
- package/package.json +1 -1
- package/templates/state.md +2 -2
- package/workflows/executar-fase.md +2 -2
- package/workflows/rapido.md +1 -1
package/agents/up-executor.md
CHANGED
|
@@ -23,7 +23,7 @@ Antes de executar, descubra o contexto do projeto:
|
|
|
23
23
|
1. Liste skills disponiveis (subdiretorios)
|
|
24
24
|
2. Leia `SKILL.md` de cada skill
|
|
25
25
|
3. Carregue `rules/*.md` conforme necessario durante implementacao
|
|
26
|
-
4.
|
|
26
|
+
4. Carregue `AGENTS.md` quando necessario (com 1M de contexto, 100KB e aceitavel)
|
|
27
27
|
5. Siga regras das skills relevantes a sua tarefa atual
|
|
28
28
|
</project_context>
|
|
29
29
|
|
|
@@ -144,13 +144,13 @@ So auto-corrija issues DIRETAMENTE causados pelas mudancas da tarefa atual. Warn
|
|
|
144
144
|
- NAO re-execute builds esperando que se resolvam
|
|
145
145
|
|
|
146
146
|
**LIMITE DE TENTATIVAS:**
|
|
147
|
-
Registre tentativas de auto-correcao por tarefa. Apos
|
|
147
|
+
Registre tentativas de auto-correcao por tarefa. Apos 7 tentativas em uma unica tarefa:
|
|
148
148
|
- PARE de corrigir — documente issues restantes em SUMMARY.md sob "Issues Adiados"
|
|
149
149
|
- Continue para a proxima tarefa
|
|
150
150
|
</deviation_rules>
|
|
151
151
|
|
|
152
152
|
<analysis_paralysis_guard>
|
|
153
|
-
**Durante execucao de tarefa, se voce fizer
|
|
153
|
+
**Durante execucao de tarefa, se voce fizer 12+ chamadas Read/Grep/Glob consecutivas sem nenhuma acao Edit/Write/Bash:**
|
|
154
154
|
|
|
155
155
|
PARE. Declare em uma frase por que nao escreveu nada ainda. Entao:
|
|
156
156
|
1. Escreva codigo (voce tem contexto suficiente), ou
|
package/agents/up-planejador.md
CHANGED
|
@@ -15,7 +15,7 @@ Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read
|
|
|
15
15
|
|
|
16
16
|
**Responsabilidades principais:**
|
|
17
17
|
- **PRIMEIRO: Analisar e honrar decisoes do usuario de CONTEXT.md** (decisoes travadas sao INEGOCIAVEIS)
|
|
18
|
-
- Decompor fases em planos otimizados para paralelismo com
|
|
18
|
+
- Decompor fases em planos otimizados para paralelismo com 5-8 tarefas cada
|
|
19
19
|
- Construir grafos de dependencia e atribuir ondas de execucao
|
|
20
20
|
- Derivar must-haves usando metodologia goal-backward
|
|
21
21
|
- Lidar com planejamento padrao e modo de fechamento de gaps
|
|
@@ -32,7 +32,7 @@ Antes de planejar, descubra o contexto do projeto:
|
|
|
32
32
|
1. Liste skills disponiveis (subdiretorios)
|
|
33
33
|
2. Leia `SKILL.md` de cada skill (indice leve ~130 linhas)
|
|
34
34
|
3. Carregue arquivos `rules/*.md` especificos conforme necessario durante o planejamento
|
|
35
|
-
4.
|
|
35
|
+
4. Carregue `AGENTS.md` quando necessario para entender padroes do projeto (com 1M de contexto, 100KB e aceitavel)
|
|
36
36
|
5. Garanta que planos considerem padroes e convencoes das skills do projeto
|
|
37
37
|
</project_context>
|
|
38
38
|
|
|
@@ -82,12 +82,12 @@ PLAN.md E o prompt (nao um documento que vira prompt). Contem:
|
|
|
82
82
|
|
|
83
83
|
| Uso de Contexto | Qualidade | Estado do Claude |
|
|
84
84
|
|-----------------|-----------|------------------|
|
|
85
|
-
| 0-
|
|
86
|
-
|
|
|
87
|
-
|
|
|
88
|
-
|
|
|
85
|
+
| 0-40% | PICO | Minucioso, abrangente |
|
|
86
|
+
| 40-60% | BOM | Confiante, trabalho solido |
|
|
87
|
+
| 60-80% | DEGRADANDO | Modo eficiencia comeca |
|
|
88
|
+
| 80%+ | RUIM | Apressado, minimo |
|
|
89
89
|
|
|
90
|
-
**Regra:** Planos devem completar dentro de ~
|
|
90
|
+
**Regra:** Planos devem completar dentro de ~70% do contexto. Mais planos, escopo menor, qualidade consistente. Cada plano: 5-8 tarefas max.
|
|
91
91
|
|
|
92
92
|
## Envie Rapido
|
|
93
93
|
|
|
@@ -168,10 +168,10 @@ Cada tarefa tem quatro campos obrigatorios:
|
|
|
168
168
|
|
|
169
169
|
## Dimensionamento de Tarefa
|
|
170
170
|
|
|
171
|
-
Cada tarefa: **
|
|
172
|
-
- Se >
|
|
173
|
-
- Se <
|
|
174
|
-
-
|
|
171
|
+
Cada tarefa: **5-180 minutos** tempo de execucao do Claude.
|
|
172
|
+
- Se > 180 min: Divida em subtarefas
|
|
173
|
+
- Se < 5 min: Combine com tarefa adjacente
|
|
174
|
+
- 5-8 tarefas por plano (max)
|
|
175
175
|
</task_breakdown>
|
|
176
176
|
|
|
177
177
|
<wave_assignment>
|
|
@@ -268,7 +268,7 @@ Se o dominio envolver bibliotecas/APIs desconhecidas:
|
|
|
268
268
|
|
|
269
269
|
### Passo 4: Decompor em Tarefas
|
|
270
270
|
|
|
271
|
-
- Crie
|
|
271
|
+
- Crie 5-8 tarefas por plano
|
|
272
272
|
- Atribua ondas de execucao
|
|
273
273
|
- Defina depends_on entre planos
|
|
274
274
|
- Derive must-haves (goal-backward)
|
|
@@ -377,7 +377,7 @@ Plano esta completo quando:
|
|
|
377
377
|
- [ ] Contexto do projeto descoberto (CLAUDE.md, skills)
|
|
378
378
|
- [ ] Decisoes do usuario honradas (context_fidelity)
|
|
379
379
|
- [ ] Research inline executada (se necessario)
|
|
380
|
-
- [ ] Fase decomposta em planos com
|
|
380
|
+
- [ ] Fase decomposta em planos com 5-8 tarefas cada
|
|
381
381
|
- [ ] Ondas de execucao atribuidas
|
|
382
382
|
- [ ] Dependencias entre planos definidas
|
|
383
383
|
- [ ] Must-haves derivados (goal-backward)
|
package/bin/lib/core.cjs
CHANGED
|
@@ -20,7 +20,7 @@ function output(result, raw, rawValue) {
|
|
|
20
20
|
process.stdout.write(String(rawValue));
|
|
21
21
|
} else {
|
|
22
22
|
const json = JSON.stringify(result, null, 2);
|
|
23
|
-
if (json.length >
|
|
23
|
+
if (json.length > 200000) {
|
|
24
24
|
const tmpPath = path.join(require('os').tmpdir(), `up-${Date.now()}.json`);
|
|
25
25
|
fs.writeFileSync(tmpPath, json, 'utf-8');
|
|
26
26
|
process.stdout.write('@file:' + tmpPath);
|
package/commands/depurar.md
CHANGED
|
@@ -14,7 +14,7 @@ Depurar problemas usando metodo cientifico com isolamento em subagente.
|
|
|
14
14
|
|
|
15
15
|
**Papel do orquestrador:** Coletar sintomas, spawnar agente up-depurador, lidar com checkpoints, spawnar continuacoes.
|
|
16
16
|
|
|
17
|
-
**Por que subagente:** Investigacao consome contexto rapidamente (lendo arquivos, formando hipoteses, testando). Contexto fresco de
|
|
17
|
+
**Por que subagente:** Investigacao consome contexto rapidamente (lendo arquivos, formando hipoteses, testando). Contexto fresco de 800k por investigacao. Contexto principal permanece enxuto para interacao com usuario.
|
|
18
18
|
</objective>
|
|
19
19
|
|
|
20
20
|
<context>
|
|
@@ -7,8 +7,8 @@ const fs = require('fs');
|
|
|
7
7
|
const os = require('os');
|
|
8
8
|
const path = require('path');
|
|
9
9
|
|
|
10
|
-
const WARNING_THRESHOLD =
|
|
11
|
-
const CRITICAL_THRESHOLD =
|
|
10
|
+
const WARNING_THRESHOLD = 15;
|
|
11
|
+
const CRITICAL_THRESHOLD = 8;
|
|
12
12
|
const STALE_SECONDS = 60;
|
|
13
13
|
const DEBOUNCE_CALLS = 5;
|
|
14
14
|
|
package/package.json
CHANGED
package/templates/state.md
CHANGED
|
@@ -119,10 +119,10 @@ Enables instant resumption:
|
|
|
119
119
|
|
|
120
120
|
<size_constraint>
|
|
121
121
|
|
|
122
|
-
Keep STATE.md under
|
|
122
|
+
Keep STATE.md under 150 lines.
|
|
123
123
|
|
|
124
124
|
It's a DIGEST, not an archive. If accumulated context grows too large:
|
|
125
|
-
- Keep only
|
|
125
|
+
- Keep only 10-15 recent decisions in summary (full log in PROJECT.md)
|
|
126
126
|
- Keep only active blockers, remove resolved ones
|
|
127
127
|
|
|
128
128
|
The goal is "read once, know where we are" -- if it's too long, that fails.
|
|
@@ -76,7 +76,7 @@ Executar cada wave em sequencia. Dentro de uma wave: paralelo se `PARALLELIZATIO
|
|
|
76
76
|
|
|
77
77
|
2. **Spawn agentes executores:**
|
|
78
78
|
|
|
79
|
-
Passar apenas caminhos -- executores leem arquivos eles mesmos com contexto limpo de
|
|
79
|
+
Passar apenas caminhos -- executores leem arquivos eles mesmos com contexto limpo de 800k.
|
|
80
80
|
|
|
81
81
|
```
|
|
82
82
|
Task(
|
|
@@ -263,7 +263,7 @@ node "$HOME/.claude/up/bin/up-tools.cjs" commit "docs(fase-{X}): completar execu
|
|
|
263
263
|
</process>
|
|
264
264
|
|
|
265
265
|
<context_efficiency>
|
|
266
|
-
Orquestrador: ~10-15% contexto. Subagentes:
|
|
266
|
+
Orquestrador: ~10-15% contexto. Subagentes: 800k limpo cada. Sem polling (Task bloqueia). Sem vazamento de contexto.
|
|
267
267
|
</context_efficiency>
|
|
268
268
|
|
|
269
269
|
<failure_handling>
|
package/workflows/rapido.md
CHANGED
|
@@ -81,7 +81,7 @@ Task(
|
|
|
81
81
|
- Criar UM UNICO plano com 1-3 tarefas focadas
|
|
82
82
|
- Tarefas rapidas devem ser atomicas e autocontidas
|
|
83
83
|
- Sem fase de pesquisa
|
|
84
|
-
- Alvo ~
|
|
84
|
+
- Alvo ~10% uso de contexto (simples, focado)
|
|
85
85
|
</constraints>
|
|
86
86
|
|
|
87
87
|
<output>
|