ae39e45460
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)
94 lines
3.7 KiB
Markdown
94 lines
3.7 KiB
Markdown
# 📚 Biblioteca Inteligente — Índice Completo
|
|
|
|
> Biblioteca dinâmica para compartilhar entre todos os projetos. Conhecimento extraído
|
|
> automaticamente das skills instaladas, organizado por domínio.
|
|
|
|
---
|
|
|
|
## 🗂️ Estrutura
|
|
|
|
```
|
|
libs/
|
|
├── README.md ← Este arquivo
|
|
├── typescript/ ← TS seguro: narrowing, generics, satisfies
|
|
├── react/ ← Next.js, Vite, App Router, RSC, Server Actions
|
|
├── vue/ ← Vue 3 Composition API, Pinia, Router
|
|
├── linux/ ← Diagnóstico de sistema, logs, rede, SSH
|
|
├── database/ ← PostgreSQL, MySQL — schemas, queries, EXPLAIN
|
|
├── browser/ ← Agent-browser (Chromium) + E2E testing
|
|
├── security/ ← SAST: OWASP Top 10, prompt injection, secrets
|
|
├── best-practices/ ← Clean Code, SOLID, Clean Architecture
|
|
├── deploy/ ← Docker multi-stack, xCloud, OpenClaw Gateway
|
|
└── docs/ ← Templates de documentação
|
|
```
|
|
|
|
---
|
|
|
|
## 📁 Typescript — 2 arquivos
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `typescript/TYPESCRIPT_SAFE_PATTERNS.md` | narrowing, satisfies, discriminated unions, literais |
|
|
| `typescript/GENERICS_UTILITY_GOTCHAS.md` | Armadilhas de generics & utility types `Partial<T>`, `Omit`, `Pick` |
|
|
|
|
## 📁 React — 2 arquivos
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `react/NEXTJS_BEST_PRACTICES.md` | App Router, RSC, Server Actions, caching, data fetching |
|
|
| `react/VITE_CONFIG.md` | Env vars, path aliases, Dev Server proxy, CJS compat |
|
|
|
|
## 📁 Vue — 1 arquivo
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `vue/VUE3_COMPOSITION_API.md` | `<script setup>`, composables, Pinia, reactivity, Router traps |
|
|
|
|
## 📁 Linux — 1 arquivo
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `linux/SYSTEM_DIAGNOSTIC.md` | Processes, disk, network, logs, SSH, shell scripts, permissions |
|
|
|
|
## 📁 Database — 2 arquivos
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `database/POSTGRESQL.md` | UUID, JSONB, GIN indexes, CTEs, window functions, EXPLAIN ANALYZE |
|
|
| `database/MYSQL.md` | AUTO_INCREMENT, JSON, InnoDB, diferenças vs PostgreSQL |
|
|
|
|
## 📁 Browser — 2 arquivos
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `browser/BROWSER_AUTOMATION.md` | Chromium: navegação, login, persists, screenshot, @refs, dev server proxy |
|
|
| `browser/E2E_TESTING.md` | Pirâmide de testes, selectors estáveis, princípios de determinismo |
|
|
|
|
## 📁 Security — 1 arquivo
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `security/SAST_AUDIT.md` | OWASP Top 10, prompt injection, hardcoded secrets, IDOR, SSRF |
|
|
|
|
## 📁 Best Practices — 1 arquivo
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `best-practices/CLEAN_CODE.md` | Naming, functions, SRP, SOLID, Clean Architecture dependency rule |
|
|
|
|
## 📁 Deploy — 2 arquivos
|
|
| Arquivo | Conteúdo |
|
|
|---------|----------|
|
|
| `deploy/DOCKER_DEPLOY.md` | Stack router, 3 cenários, Dockerfiles pré-prontos, composes template |
|
|
| `deploy/OPENCLAW_OPS.md` | CLI cheatsheet, $include modular, Telegram, env vars |
|
|
|
|
---
|
|
|
|
## 🔄 Como Usar
|
|
|
|
### Em cada novo projeto:
|
|
1. Copiar `libs/` → `projeto/docs/dev-standards/`
|
|
2. Selecionar pastas relevantes ao stack
|
|
3. Consulte antes de implementar cada camada
|
|
|
|
### Quando o agente codifica:
|
|
1. `libs/best-practices/CLEAN_CODE.md` — sempre primeiro
|
|
2. `libs/<stack>/` — padrões específicos
|
|
3. Aplica automaticamente — não precisa lembrar de cor
|
|
|
|
### Quando atualizar:
|
|
- Nova skill instalada → ler SKILL.md → extrair conhecimento → atualizar `libs/`
|
|
- Após cada projeto → feedback → atualizar padrões
|