# 📚 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