Skip to content

ThomasMoreAI/legal-skills-open / br/data-protection/skills/lgpd-compliance-falkzera

lgpd-compliance-falkzera

Unverified

Compliance jurídico-regulatório (LGPD, ANPD, CDC, Marco Civil) para qualquer app ou sistema construído para brasileiros. Ative SEMPRE que o projeto coletar qualquer dado pessoal (nome, e-mail, telefone, CPF, geolocalização, dado do dispositivo, cookie de tracking, foto, áudio, log que identifique pessoa), OU quando o pedido envolver "LGPD", "política de privacidade", "termos de uso", "compliance", "DPO", "encarregado", "ROPA", "consentimento de cookies", "banner de cookies", "vazamento de dados", "incidente de segurança", "direito do titular", "exportar dados do usuário", "excluir conta". Esta skill AUDITA o projeto, classifica os tratamentos, e GERA os artefatos: política de privacidade, política de cookies, banner de consentimento, ROPA preenchido, RIPD quando exigível, runbook de incidente, endpoints de exercício de direitos do titular, schema de consent_log, termos de uso e portal de transparência.

FileKindSize
LICENSEother1.0 KB
SKILL.mdskill md38.1 KB
checklists/auditoria-app.mdmarkdown7.3 KB
checklists/checklist-termos.mdmarkdown8.0 KB
checklists/checklist-transparencia.mdmarkdown7.9 KB
checklists/politica-14-itens.mdmarkdown4.4 KB
checklists/seguranca-minima.mdmarkdown7.8 KB
references/01-lei-fundamentos.mdmarkdown9.5 KB
references/02-bases-legais.mdmarkdown11.9 KB
references/03-direitos-titular.mdmarkdown10.2 KB
references/04-matriz-retencao.mdmarkdown8.4 KB
references/05-incidente-runbook.mdmarkdown9.7 KB
references/06-cookies-guia-anpd.mdmarkdown7.6 KB
references/07-pequeno-porte.mdmarkdown7.4 KB
references/08-termos-cdc.mdmarkdown14.2 KB
references/09-termos-mci-stf.mdmarkdown13.0 KB
references/10-clickwrap-aceite.mdmarkdown11.0 KB
references/11-taxonomia-dados.mdmarkdown19.0 KB
references/12-transparencia-radical.mdmarkdown15.8 KB
references/13-ia-ml-transparencia.mdmarkdown13.3 KB
references/14-analytics-tracking.mdmarkdown16.2 KB
templates/banner-cookies.tsxother10.9 KB
templates/dpa-clausulas-pt.mdmarkdown8.8 KB
templates/endpoints-direitos/consent-log-schema.sqlother15.6 KB
templates/endpoints-direitos/fastapi-direitos.pyscript10.8 KB
templates/endpoints-direitos/next-delete.tsscript6.3 KB
templates/endpoints-direitos/next-export.tsscript4.5 KB
templates/notice-takedown-form.mdmarkdown8.3 KB
templates/politica-cookies.mdmarkdown5.1 KB
templates/politica-privacidade.mdmarkdown12.6 KB
templates/ripd.mdmarkdown8.1 KB
templates/ropa.csvother3.0 KB
templates/termos-de-uso.mdmarkdown17.5 KB
templates/transparencia/ai-disclosure.tsxother5.7 KB
templates/transparencia/automation/ci-check.ymlconfig4.3 KB
templates/transparencia/automation/gerar-inventario.pyscript10.3 KB
templates/transparencia/automation/pii-convention.mdmarkdown6.4 KB
templates/transparencia/automation/pii-decorator.pyscript5.0 KB
templates/transparencia/data-card.yamlconfig3.3 KB
templates/transparencia/finalidades.yamlconfig3.3 KB
templates/transparencia/inventario.yamlconfig6.5 KB
templates/transparencia/model-card.mdmarkdown4.1 KB
templates/transparencia/nutrition-label.tsxother7.2 KB
templates/transparencia/portal-page.tsxother7.4 KB
templates/transparencia/terceiros.yamlconfig5.7 KB
templates/transparencia/transparency-report.mdmarkdown7.0 KB

templates/transparencia/automation/pii-convention.md

View on GitHub
# Convenção de Anotação @pii: `{{APP_NOME}}`

> Como anotar campos de PII no código pra a skill `lgpd-compliance` gerar o inventário público automaticamente. Sem isso, `scripts/gerar-inventario.py` não consegue mapear o que está sendo coletado.

## Filosofia

**Manifesto escrito à mão envelhece em duas sprints.** Aqui, ele é gerado do código, o que significa que **o código é a fonte da verdade**. Pra isso funcionar, cada campo de PII precisa ter anotação estruturada.

## Sintaxe

### Postgres (`COMMENT ON COLUMN`)

```sql
COMMENT ON COLUMN users.email IS
  '@pii @finalidade=autenticacao,comunicacao_transacional @base=art_7_V_contrato @retencao=conta+5y @sensibilidade=baixa @compartilha=resend';
```

### Python (decorator)

```python
from lgpd_compliance.pii import pii

@pii(
    finalidade=["autenticacao", "comunicacao_transacional"],
    base_legal="art_7_V_contrato",
    retencao="conta+5y",
    sensibilidade="baixa",
    compartilha_com=["resend"],
)
class User(Base):
    email: Mapped[str] = mapped_column(String(255))
```

Decorator também aceita anotação por campo individual em Pydantic/dataclass:

```python
class UserSchema(BaseModel):
    email: Annotated[str, PII(
        finalidade=["autenticacao"],
        base_legal="art_7_V_contrato",
        retencao="conta+5y",
        sensibilidade="baixa",
    )]
```

### TypeScript (JSDoc / comment)

```typescript
interface User {
  /** @pii(finalidade=[autenticacao,comunicacao_transacional], base=art_7_V_contrato, retencao=conta+5y, sensibilidade=baixa, compartilha=resend) */
  email: string;

  /** @pii(finalidade=[autenticacao], base=art_7_V_contrato, sensibilidade=critica) */
  passwordHash: string;
}
```

### Prisma schema

```prisma
model User {
  /// @pii(finalidade=[autenticacao,comunicacao_transacional], base=art_7_V_contrato, retencao=conta+5y, sensibilidade=baixa, compartilha=resend)
  email String @unique

  /// @pii(finalidade=[autenticacao], base=art_7_V_contrato, sensibilidade=critica)
  passwordHash String
}
```

### Drizzle schema

```typescript
export const users = pgTable('users', {
  // @pii(finalidade=[autenticacao,comunicacao_transacional], base=art_7_V_contrato, retencao=conta+5y, sensibilidade=baixa, compartilha=resend)
  email: text('email').notNull().unique(),
});
```

### SQLAlchemy

```python
class User(Base):
    __tablename__ = "users"
    # @pii(finalidade=[autenticacao], base=art_7_V_contrato, retencao=conta+5y, sensibilidade=baixa, compartilha=resend)
    email: Mapped[str] = mapped_column(String(255))
```

## Campos da anotação

| Campo | Obrigatório | Valores | Descrição |
|---|---|---|---|
| `finalidade` | **Sim** | Lista de IDs de `transparencia/finalidades.yaml` | Pra que esse dado é usado |
| `base` | **Sim** | `art_7_I_consentimento`, `art_7_II_obrigacao_legal`, `art_7_III_politicas_publicas`, `art_7_IV_pesquisa`, `art_7_V_contrato`, `art_7_VI_processo`, `art_7_VII_protecao_vida`, `art_7_VIII_tutela_saude`, `art_7_IX_legitimo_interesse`, `art_7_X_credito`, `art_11_I_consentimento_sensivel`, `art_11_II_a_obrigacao_legal_sensivel`, etc. | Base legal LGPD |
| `retencao` | **Sim** | String descritiva (`conta+5y`, `5y_apos_ultima_compra`, `6m`, `ate_revogacao`, `enquanto_durar`, etc.) | Quanto tempo guardamos |
| `sensibilidade` | **Sim** | `baixa`, `media`, `alta`, `critica`, `variavel`, `alta_inferencia` | Nível de risco |
| `compartilha` | Não | Lista de IDs de `transparencia/terceiros.yaml` | Operadores que recebem |
| `visivel_para` | Não | Lista (`titular`, `admin_auditoria`, `admin_fiscal`, etc.) | RBAC |
| `criptografia_repouso` | Não | String descritiva | Quando aplicável |
| `obrigatorio` | Não | `true`/`false` | Se o usuário pode optar por não fornecer |

## Marcadores complementares

### `@contains_pii` na tabela/classe

Marca que a tabela inteira contém PII, útil pra o CI verificar que todas as colunas devem ter `@pii` ou justificar exceção.

```sql
COMMENT ON TABLE users IS '@contains_pii';
```

```python
@contains_pii
class User(Base):
    ...
```

### `@no_pii` em campo específico

Quando a tabela tem `@contains_pii` mas um campo específico não é PII (ex: chave estrangeira opaca):

```sql
COMMENT ON COLUMN users.created_at IS '@no_pii';
COMMENT ON COLUMN users.organization_id IS '@no_pii';
```

## Validação automatizada

O CI (`templates/transparencia/automation/ci-check.yml`) verifica:

1. **Toda tabela `@contains_pii`** tem todas as colunas com `@pii` ou `@no_pii`.
2. **Todo `@finalidade=X`** existe em `transparencia/finalidades.yaml`.
3. **Todo `@compartilha=X`** existe em `transparencia/terceiros.yaml`.
4. **Toda `@base=X`** é valor válido (lista acima).
5. **Toda `@sensibilidade=X`** é valor válido.
6. **PR que mexe em schema** sem atualizar `transparencia/inventario.yaml` (gerado) **falha**.

## Como aplicar a um projeto existente

Roteiro de adoção em 3 passos:

1. **Anotar schema**, comece pelas tabelas com PII óbvia (users, orders, sessions). Use `@contains_pii` no `COMMENT ON TABLE`, depois anote cada coluna.
2. **Rodar `scripts/gerar-inventario.py`**, gera o primeiro `inventario.yaml` com base nas anotações.
3. **Ativar CI**, copie `.github/workflows/transparency-check.yml` pro repo. A partir daí, qualquer PR que quebrar a convenção falha.

## Exemplo completo: projeto mínimo

```sql
-- Migration 001_users.sql
CREATE TABLE users (
  id            uuid PRIMARY KEY DEFAULT gen_random_uuid(),
  email         text NOT NULL UNIQUE,
  name          text NOT NULL,
  password_hash text NOT NULL,
  cpf           text,
  created_at    timestamptz NOT NULL DEFAULT now()
);

COMMENT ON TABLE users IS '@contains_pii';
COMMENT ON COLUMN users.id IS '@no_pii';
COMMENT ON COLUMN users.email IS '@pii @finalidade=autenticacao,comunicacao_transacional @base=art_7_V_contrato @retencao=conta+5y @sensibilidade=baixa @compartilha=resend';
COMMENT ON COLUMN users.name IS '@pii @finalidade=personalizacao,comunicacao_transacional @base=art_7_V_contrato @retencao=conta+5y @sensibilidade=baixa';
COMMENT ON COLUMN users.password_hash IS '@pii @finalidade=autenticacao @base=art_7_V_contrato @retencao=conta @sensibilidade=critica';
COMMENT ON COLUMN users.cpf IS '@pii @finalidade=emissao_nf,kyc @base=art_7_II_obrigacao_legal @retencao=5y_apos_ultima_compra @sensibilidade=media @compartilha=stripe @obrigatorio=false';
COMMENT ON COLUMN users.created_at IS '@no_pii';
```

Rodando `python scripts/gerar-inventario.py`, esse schema vira automaticamente uma seção do `inventario.yaml` que é renderizada em `/transparencia/inventario`.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall