feat: biblioteca inteligente libs/ + 5 novas skills (20 skills total)

NOVAS SKILLS:
- next-best-practices      v0.1.0  (CLEAN) — Next.js App Router, RSC, caching, data
- nextjs-patterns          v1.0.0  (CLEAN) — Next.js 15: Server Actions, route handlers
- vite                     v1.0.0  (CLEAN) — env vars, aliases, proxy, CJS compat
- uncle-bob                v1.0.0  (CLEAN) — Clean Code, SOLID, Clean Architecture
- clean-code-review        v1.0.0  (CLEAN) — naming, guard clauses, anti-patterns, refactoring
- vue                      v1.0.0  (CLEAN) — Vue framework
- vue-composition-api-best-practices v1.0.0 (CLEAN) — composables, Pinia, reactivity

BIBLIOTECA INTELIGENTE libs/ (10 dominios, 11 arquivos):
- typescript/ — TS safe + generics gotchas
- react/ — Next.js App Router + Vite config
- vue/ — Composition API + Pinia
- linux/ — System diagnostic cheatsheet
- database/ — PostgreSQL + MySQL patterns
- browser/ — Chromium CLI + E2E testing
- security/ — SAST audit (OWASP Top 10)
- best-practices/ — Clean Code + SOLID + Clean Architecture
- deploy/ — Docker multi-stack + OpenClaw ops
- + INDEX.md como guia de navegacao

.learnings/ — LRN-20260519-003 criado (biblioteca compartilhada)
This commit is contained in:
Pulse
2026-05-19 21:03:25 -03:00
parent 22d9f5b21d
commit ae39e45460
83 changed files with 13349 additions and 1 deletions
+91
View File
@@ -0,0 +1,91 @@
# Browser Automation — Chromium CLI (agent-browser)
> CLI headless Chromium para navegação, login, raspagem e screenshots.
## Fluxo Padrão
```bash
agent-browser open https://exemplo.com/form
agent-browser snapshot -i # Descobre elementos → @e1, @e2, @e3
agent-browser fill @e1 "user@exemplo.com"
agent-browser fill @e2 "senha123"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i # Re-snapshot após mudança de DOM
```
## Comandos Essenciais
```bash
# Navegação
agent-browser open <url>
agent-browser close
# Snapshot (sempre primeiro)
agent-browser snapshot -i # Elementos interativos + @refs
agent-browser snapshot -i -C # + cursor-interactive elements
# Interação com @refs
agent-browser click @e1
agent-browser fill @e2 "text" # Clear + type
agent-browser type @e2 "text" # Type sem limpar
agent-browser select @e1 "option"
agent-browser check @e1
agent-browser press Enter
agent-browser scroll down 500
agent-browser hover @e1
# Extração
agent-browser get text @e1
agent-browser get text body > page.txt
agent-browser get html @e1
agent-browser get url
agent-browser get title
# Espera
agent-browser wait @e1
agent-browser wait --load networkidle
agent-browser wait --url "**/dashboard"
# Captura
agent-browser screenshot page.png
agent-browser screenshot --full # Página inteira
agent-browser pdf relatorio.pdf
# Download
agent-browser download @e1 ./file.pdf
agent-browser wait --download ./output.zip
```
## 🔐 Login + Persistência de Sessão
```bash
# Login
agent-browser open https://app.exemplo.com/login
agent-browser fill @e1 "$USERNAME" && agent-browser fill @e2 "$PASSWORD"
agent-browser click @e3
agent-browser wait --url "**/dashboard"
agent-browser state save ~/auth.json # Salva cookies + sessão
# Reutilizar
agent-browser state load ~/auth.json
agent-browser open https://app.exemplo.com/dashboard
```
## 🔒 Segurança (ambiente)
```bash
export AGENT_BROWSER_ALLOWED_DOMAINS="exemplo.com"
export AGENT_BROWSER_MAX_OUTPUT=50000
export AGENT_BROWSER_CONTENT_BOUNDARIES=1
```
## ⚠️ Ref Lifecycle
> Refs (`@e1`, `@e2`) são **invalidados** após qualquer mudança de DOM.
> Sempre faça `snapshot -i` de novo após:
> - Cliques que navegam
> - Submissão de formulário
> - Conteúdo dinâmico (dropdowns, modais)
## Sessões Paralelas
```bash
agent-browser --session site1 open https://site-a.com
agent-browser --session site2 open https://site-b.com
agent-browser session list
```
+37
View File
@@ -0,0 +1,37 @@
# E2E Testing — Pirâmide e Padrões
> Extraído de `e2e-testing-patterns` v1.0.0
## 🏔️ Test Pyramid
```
/\ ← POUCOS: Critical paths (E2E)
/E2E\ ← MAIS: Component/API integration
/─────\
/Integr\ ← MUITOS: Unit tests (rápidos, isolados)
/────────\
/Unit Tests\
/────────────\
```
## O que E2E Tests DEVEM cobrir
| ✅ E2E | ❌ Não E2E |
|--------|-----------|
| Critical journeys (auth → dashboard → logout) | Lógica unitária → use unit tests |
| Multi-step flows (checkout, onboarding) | API contracts → use integration |
| Cross-browser | Edge cases (muito lento) |
| Real API integration | Internal implementation |
| Auth flows | Visual states → use Storybook |
## Core Principles
| Princípio | Como |
|-----------|------|
| **Test behavior, not implementation** | Assert em outcomes visíveis, não estrutura DOM |
| **Independent tests** | Cada teste cria próprios dados e limpa |
| **Deterministic waits** | Esperar por condição, não timeout fixo |
| **Stable selectors** | Usar `data-testid`, roles, labels — nunca CSS classes |
| **Fast feedback** | Mockar serviços externos, paralelizar, shard |
## Selector Priority
```
data-testid → data-cy → role → text → id → class (último recurso)
```