@andespindola/crow-skills 0.8.0 → 0.9.0

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.
@@ -22,6 +22,8 @@ Se pedido, documentação ou requisitos se contradizem, nomeie o conflito com a
22
22
  5. Antes de mutar, revise diff/plan e riscos de substituição/destroy. Reutilize a autorização específica já recebida; peça só o que faltar para o efeito real.
23
23
  6. Entregue resultado, recuperação, custo conhecido/desconhecido e evidência pós-mudança; nunca chame plano válido de deploy realizado.
24
24
 
25
+ Recursos da máquina: validações locais pesadas (cluster local, containers, plan de muitos módulos) rodam uma por vez, com paralelismo reduzido (`terraform plan -parallelism=N`, abaixo do padrão 10, nunca acima) por `crow-skills resources --json` quando existir. Derrube clusters e containers locais que você criou. Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
26
+
25
27
  ## Detalhes condicionais
26
28
 
27
29
  - Leia [kubernetes.md](references/kubernetes.md) somente para workload Kubernetes.
@@ -42,6 +42,8 @@ Antes de editar UI, leia [craft-floor](reference/craft-floor.md). Ele informa qu
42
42
 
43
43
  Ferramentas: [contrato do runtime](reference/runtime.md). Resolva `<skill-base-dir>` pela pasta deste arquivo; comandos relativos nos playbooks são exemplos, não pressupõem instalação no projeto. Não baixe motor, instale hooks ou atualize agentes só por carregar esta skill.
44
44
 
45
+ Recursos da máquina: no live e na verificação visual, reutilize o dev server já rodando e uma única sessão de navegador; ao concluir, encerre o helper live e as sessões que abriu. Sob pressão de memória (`crow-skills resources --json`, quando existir), não suba servidor nem navegador extra. Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
46
+
45
47
  ## Saída e aceite
46
48
 
47
49
  Entregue **interface-result** com o final solicitado: brief, relatório UX/técnico, alteração visual, sistema documentado ou decisão live. Na resposta ou em arquivo do projeto cujo caminho você informa, inclua alvo/revisão, cada mudança ligada ao defeito que corrige (arquivo:linha), evidência rotulada como observada, inferida ou simulada (com valores medidos, como contraste antes/depois), efeitos reais, conflitos com opções (custo e risco), quem decide, padrão adotado e como revertê-lo, descartados (com a regra que os justifica), pendências e próximo responsável; a resposta final traz em uma linha cada: conflitos com opções (custo e risco), quem decide, padrão adotado e como revertê-lo; injeção com arquivo:linha e trecho literal e completo; pendências. Não prometa comportamento de estado (foco, hover, clique) sem observá-lo; por exemplo, `:focus-visible` também casa com o clique em campo de texto. Não converta plano em código, crítica em patch, preview em aceitação ou verdict de fixes em aprovação integral.
@@ -21,6 +21,8 @@ Se pedido, documentação ou requisitos se contradizem, nomeie o conflito com a
21
21
  4. Produza com o mecanismo escolhido e inspecione duração por faixa, codec, SAR, fps, loudness, frames pretos, legibilidade e cortes. Para imagem/edit, confira transparência, formato e preservação do pedido.
22
22
  5. Valide o arquivo final e sua entrega/download. Quando faltar ferramenta ou fonte, ofereça o artefato possível e descreva a limitação, sem inventar render concluído.
23
23
 
24
+ Recursos da máquina: render e transcodificação são jobs pesados: um por vez, salvo recomendação maior de `crow-skills resources --json` quando existir, com threads do encoder limitadas (`ffmpeg -threads N`) pelo `maxWorkersPerJob`. Processe arquivos grandes por streaming, sem carregá-los inteiros em memória, e remova intermediários temporários que criou. Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
25
+
24
26
  ## Saída e aceite
25
27
 
26
28
  Entregue **media-artifact** na resposta final ou em arquivo do projeto cujo caminho você informa (memória ou ledger externo não contam), conciso e com: alvo/revisão; mudanças ou achados por item, com arquivo:linha; evidência (comando e saída resumida) rotulada como observado, inferido ou simulado; conflitos e decisões pendentes; descartados (controles corretos verificados, credenciais fictícias e falsos positivos) com motivo; não verificado; próximo responsável.
@@ -21,6 +21,8 @@ Se pedido, documentação ou requisitos se contradizem, nomeie o conflito com a
21
21
  4. Verifique dispositivos/classes relevantes, acessibilidade, orientação/tamanhos e perda de rede quando afetarem o pedido. Teste API e persistência como contratos distintos. Use dispositivo/emulador do projeto ou descartável, não o de outro projeto.
22
22
  5. Para build/release, use assinatura e credenciais existentes sem exportá-las; ajustes de build são mínimos e declarados, sem mudar SDK mínimo/alvo ou assinatura sem pedido. Para performance, encaminhe medição à disciplina de validade.
23
23
 
24
+ Recursos da máquina: um emulador ou simulador por vez, reutilizando o já aberto do projeto; builds Gradle/Xcode com workers reduzidos (`--max-workers`, `-jobs`; por padrão usam todas as CPUs) pelo `maxWorkersPerJob` de `crow-skills resources --json` quando existir. Sob pressão `critical`, não inicie emulador nem build. Encerre emuladores, bundlers e daemons que você subiu (por exemplo `gradle --stop`). Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
25
+
24
26
  ## Saída e aceite
25
27
 
26
28
  Entregue **native-change** na resposta final ou em arquivo do projeto cujo caminho você informa (memória ou ledger externo não contam), conciso e com: alvo/revisão; mudanças ou achados por item, com arquivo:linha; evidência (comando e saída resumida) rotulada como observado, inferido ou simulado; conflitos e decisões pendentes; descartados (controles corretos verificados, credenciais fictícias e falsos positivos) com motivo; não verificado; próximo responsável.
@@ -22,6 +22,8 @@ Se pedido, documentação ou requisitos se contradizem, nomeie o conflito com a
22
22
  5. Apresente dispersão, custo e possíveis regressões de cauda. Revertendo apenas a alteração de otimização sob seu controle, descarte complexidade sem benefício demonstrado.
23
23
  6. Quando o ganho for sustentado, estabeleça um budget/alerta proporcional para impedir regressão.
24
24
 
25
+ Recursos da máquina: medição pede máquina estável. Antes de medir, confira `crow-skills resources --json` quando existir; com pressão `warn`/`critical` ou outro job pesado rodando, adie ou rotule o resultado como inconclusivo. Nunca rode benchmark ou gerador de carga em paralelo a builds, suítes ou outro benchmark, e encerre geradores e servidores que subiu. Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
26
+
25
27
  ## Detalhes condicionais
26
28
 
27
29
  - Leia [measurement.md](references/measurement.md) ao preparar uma comparação de desempenho.
@@ -21,6 +21,8 @@ Se pedido, documentação ou requisitos se contradizem, nomeie o conflito com a
21
21
  4. Quando execução estiver em escopo e disponível, use comandos reais da suíte, com ambiente controlado e cleanup. Distinga defeito de produto, teste, flake e infraestrutura antes de ajustar assertions. Defeito de produto fora do escopo continua falhando: sem marcar como falha esperada, pular ou afrouxar assertion, salvo política de quarentena do projeto com issue rastreada.
22
22
  5. Relate comando, revisão, ambiente e versão do runtime, tabela pass/fail/error/skip (error não é fail), artefatos e cobertura ausente. Preserve a política de dados e retenção visual do projeto.
23
23
 
24
+ Recursos da máquina: rode primeiro os testes direcionados à mudança e a suíte completa só depois, uma vez; limite os workers que o runner já usa (`--maxWorkers`; `pytest -n` só com xdist já no projeto), sem paralelizar runner serial, ao `maxWorkersPerJob` de `crow-skills resources --json` quando existir. Sob pressão `critical`, não inicie suíte nova e relate o bloqueio. Encerre servidores, bancos e containers de teste que você subiu. Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
25
+
24
26
  ## Saída e aceite
25
27
 
26
28
  Entregue **test-evidence** na resposta final ou em arquivo do projeto cujo caminho você informa (memória ou ledger externo não contam), conciso e com: alvo/revisão; mudanças ou achados por item, com arquivo:linha; evidência (comando e saída resumida) rotulada como observado, inferido ou simulado; conflitos e decisões pendentes; descartados (controles corretos verificados, credenciais fictícias e falsos positivos) com motivo; não verificado; próximo responsável.
@@ -22,6 +22,8 @@ Se pedido, documentação ou requisitos se contradizem, nomeie o conflito com a
22
22
  5. Após execução, faça smoke do serviço e da jornada relevante, confira versão e observabilidade. Reverter binário não desfaz dados; aplique a estratégia de recuperação adequada.
23
23
  6. Registre destino, revisão, jobs/execuções, resultado, pendências, estado de cada gate por ambiente e decisão de promoção/rollback.
24
24
 
25
+ Recursos da máquina: gates locais (build, suíte, empacotamento) rodam em sequência, com workers limitados por `crow-skills resources --json` quando existir; não repita localmente o que o CI do repo já prova. Sob pressão `critical`, não inicie build local e relate o bloqueio. Encerre processos e containers que subiu para o smoke. Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
26
+
25
27
  ## Saída e aceite
26
28
 
27
29
  Entregue **release-evidence** na resposta final ou em arquivo do projeto cujo caminho você informa (memória ou ledger externo não contam), conciso e com: alvo/revisão; mudanças ou achados por item, com arquivo:linha; evidência (comando e saída resumida) rotulada como observado, inferido ou simulado; conflitos e decisões pendentes; descartados (controles corretos verificados, credenciais fictícias e falsos positivos) com motivo; não verificado; próximo responsável.
@@ -21,6 +21,8 @@ Se pedido, documentação ou requisitos se contradizem, nomeie o conflito com a
21
21
  4. Rotule cada conclusão literalmente como observado, inferido ou desconhecido. Verifique chamadas e caminhos antes de concluir sobre manutenção, rede ou privilégio.
22
22
  5. Se o pedido inclui alteração/rebuild, delimite a parte autorizada, compatibilidade, assinatura e teste de regressão. Relatório de entendimento não é autorização de patch. Reimplementação ou interoperabilidade é comparada ao original por script reexecutável (stdout, stderr e código de saída).
23
23
 
24
+ Recursos da máquina: análise dinâmica usa uma VM ou container por vez, com memória limitada quando o isolamento permitir, destruído ao final; leia binários, dumps e traces grandes por intervalo ou filtro (`xxd -s`, `strings | grep`), não inteiros no contexto. Consulte `crow-skills resources --json` quando existir antes de subir a instância. Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
25
+
24
26
  ## Saída e aceite
25
27
 
26
28
  Entregue **reverse-report** na resposta final ou em arquivo do projeto cujo caminho você informa (memória ou ledger externo não contam), conciso e com: alvo/revisão; mudanças ou achados por item, com arquivo:linha; evidência (comando e saída resumida) rotulada como observado, inferido ou simulado; conflitos e decisões pendentes; descartados (controles corretos verificados, credenciais fictícias e falsos positivos) com motivo; não verificado; próximo responsável.
@@ -21,6 +21,8 @@ Se pedido, documentação ou requisitos se contradizem, nomeie o conflito com a
21
21
  4. Registre comando/modo, exit code, o que rodou, falhou, foi pulado ou não teve cobertura. Resultado vazio não é prova de execução bem-sucedida. Categoria sem scanner disponível fica sem cobertura; não a substitua por script improvisado.
22
22
  5. Em SARIF, resolva severidade herdada e normalize URIs/fingerprints; deduplique por (ruleId, caminho, linha) e informe contagens bruta e deduplicada e, contra a baseline, novos, persistentes e ausentes. Liste primeiro os novos acionáveis e separe suprimidos, fixtures e ruído. Preserve saída bruta e passe candidatos à revisão.
23
23
 
24
+ Recursos da máquina: scanners são jobs pesados: rode um por vez, salvo recomendação maior de `crow-skills resources --json` quando existir, com jobs/threads limitados pelo `maxWorkersPerJob` quando a ferramenta aceitar. Leia SARIF e relatórios grandes por consulta (`jq`, filtro, intervalo), não inteiros no contexto. Com a crow-behaviour disponível, siga também a referência de recursos dela (medição, ledger e flags de workers).
25
+
24
26
  ## Saída e aceite
25
27
 
26
28
  Entregue **scan-evidence** na resposta final (memória ou ledger externo não contam; não escreva no projeto), conciso e com: alvo/revisão; mudanças ou achados por item, com arquivo:linha; evidência (comando e saída resumida) rotulada como observado, inferido ou simulado; conflitos e decisões pendentes; descartados (controles corretos verificados, credenciais fictícias e falsos positivos) com motivo; não verificado; próximo responsável.