izanagi-ai 2.0.0

package/skills/i18n-l10n/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: i18n-l10n
+description: |
+  Skill de Internacionalizacao (i18n) e Localizacao (l10n) para o Portal. Aborda
+  next-intl, react-intl, gerenciamento de traducoes, locale routing, formatação de datas/
+  numeros/moeda e boas praticas de internacionalizacao em Next.js.
+---
+
+# Skill i18n & Localization — Portal
+
+## Stack Recomendada
+
+| Ferramenta | Uso |
+|------------|-----|
+| `next-intl` | i18n para Next.js App Router (preferido) |
+| `react-intl` | Alternativa madura |
+| Lokalise / Crowdin | Gerenciamento de traducao |
+| ICU Message Syntax | Formato de mensagens com placeholders |
+
+---
+
+## next-intl Setup
+
+### Configuracao
+```tsx
+// i18n.ts
+import { getRequestConfig } from "next-intl/server";
+
+export default getRequestConfig(async ({ locale }) => ({
+  messages: (await import(`./messages/${locale}.json`)).default,
+}));
+```
+
+### Middleware (Locale Detection)
+```tsx
+import createMiddleware from "next-intl/middleware";
+
+export default createMiddleware({
+  locales: ["pt-BR", "en", "es"],
+  defaultLocale: "pt-BR",
+  localePrefix: "as-needed",  // /sobre (pt-BR) vs /en/about
+});
+```
+
+---
+
+## Estrutura de Mensagens
+
+```json
+// messages/pt-BR.json
+{
+  "nav": {
+    "home": "Inicio",
+    "about": "Sobre",
+    "contact": "Contato"
+  },
+  "home": {
+    "title": "Bem-vindo ao Portal",
+    "description": "Associacao Nacional dos Servidores da Previdencia"
+  },
+  "common": {
+    "loading": "Carregando...",
+    "error": "Erro ao carregar dados",
+    "retry": "Tentar novamente"
+  }
+}
+```
+
+---
+
+## Uso nos Componentes
+
+```tsx
+import { useTranslations } from "next-intl";
+
+export default function Hero() {
+  const t = useTranslations("home");
+
+  return (
+    <h1>{t("title")}</h1>
+  );
+}
+```
+
+### Formatação
+```tsx
+import { useFormatter } from "next-intl";
+
+const format = useFormatter();
+format.dateTime(new Date(), { dateStyle: "long" });
+format.number(1234567.89, { style: "currency", currency: "BRL" });
+```
+
+---
+
+## Boas Praticas
+
+- **Granularidade**: mensagens organizadas por pagina/componente (nao um arquivao so)
+- **Fallbacks**: locale fallback para en (ou pt-BR) se traducao faltando
+- **SEO**: `<link rel="alternate" hreflang="pt-BR" href="...">` em cada pagina
+- **RTL**: preparar CSS para idiomas right-to-left (arabe, hebraico)
+- **Plurais**: ICU `{count, plural, one {# item} other {# items}}`
+- **Dynamic content**: nunca concatenar strings traduzidas com interpolacao manual

package/skills/iac-terraform/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: iac-terraform
+description: |
+  Skill de Infrastructure as Code (IaC) com Terraform/OpenTofu para o Portal.
+  Aborda HCL, modules, remote state, workspaces, provisionamento multi-cloud e boas
+  praticas de gerenciamento de infraestrutura como codigo.
+---
+
+# Skill IaC & Terraform — Portal
+
+## Terraform vs OpenTofu
+
+| Aspecto | Terraform | OpenTofu |
+|---------|-----------|----------|
+| Licenca | BSL (BUSL) | MPL 2.0 (open source) |
+| CLI | `terraform` | `tofu` |
+| Compatibilidade | HCL v2 | HCL v2 (compativel) |
+| Estado | TF Cloud / S3 | S3 / Local |
+| Providers | HashiCorp Registry | OpenTofu Registry |
+| **Escolha** | Se ja usa TF Cloud | Se prefere open-source |
+
+---
+
+## Estrutura de Projeto
+
+```
+infra/
+├── environments/
+│   ├── dev/
+│   │   ├── main.tf
+│   │   ├── variables.tf
+│   │   └── terraform.tfvars
+│   ├── staging/
+│   │   └── ...
+│   └── prod/
+│       └── ...
+├── modules/
+│   ├── networking/
+│   │   ├── main.tf
+│   │   ├── variables.tf
+│   │   └── outputs.tf
+│   ├── compute/
+│   └── database/
+└── global/
+    └── iam/
+```
+
+---
+
+## Remote State
+
+```hcl
+# backend.tf
+terraform {
+  backend "s3" {
+    bucket         = "project-terraform-state"
+    key            = "prod/terraform.tfstate"
+    region         = "us-east-1"
+    dynamodb_table = "terraform-state-lock"
+    encrypt        = true
+  }
+}
+```
+
+---
+
+## Modulos
+
+### Module Structure
+```hcl
+# modules/networking/main.tf
+resource "aws_vpc" "main" {
+  cidr_block           = var.cidr_block
+  enable_dns_hostnames = true
+  tags                 = var.tags
+}
+
+resource "aws_subnet" "public" {
+  count                   = length(var.public_subnets)
+  vpc_id                  = aws_vpc.main.id
+  cidr_block              = var.public_subnets[count.index]
+  map_public_ip_on_launch = true
+}
+```
+
+---
+
+## Boas Praticas
+
+| Pratica | Descricao |
+|---------|-----------|
+| State locking | DynamoDB (S3) ou PG backend |
+| Version constraints | `required_version = "~> 1.5"` |
+| Tagging | `Project`, `Environment`, `ManagedBy`, `CostCenter` |
+| Secrets | `aws_ssm_parameter` ou `aws_secretsmanager_secret` |
+| Plan review | Sempre revisar `terraform plan` antes de `apply` |
+| Pre-commit hooks | `terraform fmt`, `terraform validate` |
+| CI/CD | `terraform plan` no PR, `terraform apply` no merge |

package/skills/legacy-migration/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: legacy-migration
+description: |
+  Skill de Migracao de Sistemas Legados para o Portal. Aborda estrategias de migracao
+  (strangler fig, big bang, parallel run), extracao de dados de sistemas antigos (WordPress,
+  bancos relacionais), e modernizacao gradual. Use esta skill ao migrar funcionalidades
+  de sistemas legados para a nova plataforma.
+---
+
+# Skill Legacy Migration — Portal
+
+## Estrategias de Migracao
+
+### Strangler Fig Pattern (Preferido)
+```
+Old System ←─── Router ───→ New System
+                │
+                └── Gradually redirect routes
+```
+
+1. Identificar modulo para migrar
+2. Implementar no novo sistema
+3. Roteador redireciona trafego gradualmente
+4. Remover modulo antigo quando 100% migrado
+
+### Parallel Run
+```
+User → Old System (primary)
+     → New System (shadow, validate results)
+```
+- Usar para migracoes criticas (ex: dados financeiros)
+- Validar resultados do novo vs antigo automaticamente
+- Switch para novo apos confianca estabelecida
+
+### Big Bang
+- Migrar tudo de uma vez em uma janela
+- Risco alto, mas mais rapido
+- Usar apenas quando inviavel rodar em paralelo
+
+---
+
+## Extracao de Dados
+
+### Wordpress → Supabase
+```tsx
+// Mapeamento WordPress → Supabase
+const wpToSupabase = {
+  wp_posts → posts (title, content, slug, status, created_at)
+  wp_postmeta → post_metadata (meta_key, meta_value)
+  wp_users → profiles (display_name, email)
+  wp_terms → categories (name, slug)
+  wp_term_relationships → post_categories (post_id, category_id)
+};
+```
+
+### ETL Process
+1. Extract: `SELECT * FROM wp_posts WHERE post_status = 'publish'`
+2. Transform: limpar HTML, converter shortcodes, mapear IDs
+3. Load: `INSERT INTO posts (...) ON CONFLICT (old_id) DO NOTHING`
+4. Validate: comparar contagem de registros
+
+---
+
+## Migracao de Conteudo
+
+### Preservacao de URLs
+```nginx
+# Redirecionar URLs antigas para novas
+rewrite ^/wp-content/uploads/(.*)$ /uploads/$1 permanent;
+rewrite ^/category/(.*)$ /noticias/categoria/$1 permanent;
+rewrite ^/(\d{4})/(\d{2})/(.*)$ /noticias/$3 permanent;
+```
+
+### SEO Durante Migracao
+- Mapear 301 redirects de todas as URLs antigas
+- Preservar meta descriptions e titles
+- Submeter novo sitemap ao Search Console
+- Monitorar 404s apos migracao
+
+---
+
+## Boas Praticas
+
+| Pratica | Descricao |
+|---------|-----------|
+| Feature parity | Nao migrar ate atingir paridade de funcionalidades |
+| Rollback plan | Ter plano claro para voltar atras |
+| Data validation | Validar dados migrados automaticamente |
+| Performance baseline | Medir performance antes/depois |
+| User communication | Comunicar mudancas e possiveis downtime |
+| Staging migration | Testar migracao completa em staging primeiro |

package/skills/logging-expert.md

@@ -0,0 +1,78 @@
+# Skill: Logging Expert
+
+> Version 1.0.0 | Priority: Medium
+> Dependencies: DevOps Engineer
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+Logging Expert implements structured logging across the application. Ensures every significant event is logged with context, no sensitive data leaks, and logs are queryable.
+
+---
+
+## Structured Logging
+
+```json
+{
+  "timestamp": "2026-07-17T12:00:00Z",
+  "level": "error",
+  "message": "Payment processing failed",
+  "context": {
+    "user_id": "usr_456",
+    "payment_id": "pay_789",
+    "amount": 150.00,
+    "error": "card_declined",
+    "provider": "stripe"
+  },
+  "request_id": "req_abc123",
+  "environment": "production",
+  "service": "payment-service"
+}
+```
+
+## What to Log
+
+```yaml
+info:
+  - User registration/login
+  - Order placement
+  - Payment confirmation
+  - Email sent
+  
+warning:
+  - Rate limit approaching
+  - Slow query (> 100ms)
+  - Retry attempts
+  
+error:
+  - Exception caught
+  - Payment failure
+  - External API error
+  - Database connection failure
+  
+critical:
+  - Application crash
+  - Data integrity violation
+  - Security breach detected
+```
+
+---
+
+## What NOT to Log
+
+```
+- Passwords (even hashed)
+- Credit card numbers
+- Personal access tokens
+- API keys
+- Full stack traces with sensitive data
+- Session IDs (use anonymized correlation IDs)
+```
+
+---
+
+## Changelog
+
+### 1.0.0 — Initial release. Structured logging, what to log/not log.

package/skills/mcp-server-dev.md

@@ -0,0 +1,33 @@
+# Skill: Model Context Protocol (MCP) Server Development
+
+**Versão:** 1.0.0  
+**Domínio:** Integrations & Protocols  
+**Budget de Tokens:** ~2500  
+
+---
+
+## Contexto & Objetivo
+Esta skill orienta a criação de servidores compatíveis com a especificação Model Context Protocol (MCP) da Anthropic/open standards. Permite expor ferramentas (Tools), recursos (Resources) e prompts customizados para assistentes de IA.
+
+---
+
+## Estrutura Padrão de Servidor MCP
+- **Tools**: Funções executáveis declaradas com schemas JSON Schema estritos.
+- **Resources**: Dados contextuais expostos via URIs (`file:///`, `custom://`).
+- **Prompts**: Modelos reutilizáveis de instrução pré-configurados.
+
+---
+
+## Workflow de Desenvolvimento
+1. Definir o escopo de ferramentas e parâmetros de entrada com validação Zod/JSON Schema.
+2. Tratar erros com mensagens claras sem derrubar o processo STDIO ou HTTP SSE.
+3. Garantir sanitização de entradas para evitar Injeção de Comandos ou Directory Traversal.
+4. Implementar suporte a transporte STDIO e SSE.
+
+---
+
+## Checklist de Qualidade
+- [ ] Ferramentas possuem descrições claras e detalhadas para o LLM.
+- [ ] Esquemas de entrada validam todos os parâmetros obrigatórios e opcionais.
+- [ ] Erros retornam estrutura `{ isError: true, content: [...] }`.
+- [ ] Sanitização aplicada em todos os argumentos de sistema de arquivos ou comandos.

package/skills/memoria-projeto/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: memoria-projeto
+description: Mantém memória persistente do projeto entre sessões, guardando decisões, padrões de código e erros já resolvidos, para o agente melhorar a cada nova tarefa em vez de começar do zero. Use no INÍCIO de qualquer tarefa de código relevante (ler a memória) e no FINAL de qualquer tarefa que tenha gerado uma decisão, padrão ou correção de erro importante (atualizar a memória). Também dispara quando o usuário perguntar "o que já decidimos sobre X" ou "por que fizemos assim".
+---
+
+# Memória do projeto
+
+Claude Code não tem memória de conversas passadas por padrão — cada sessão começa do zero. Esta skill cria essa memória usando arquivos no próprio repositório, em `.agents/memoria/` (adaptado do padrão `.claude/memoria/` para este projeto).
+
+## Estrutura
+
+```
+.agents/memoria/
+├── contexto.md      # visão geral do projeto, stack, convenções já estabelecidas
+├── decisoes.md       # decisões de arquitetura/design e o porquê (1-3 linhas cada)
+└── erros-corrigidos.md  # bugs/erros já enfrentados e como foram resolvidos
+```
+
+Se a pasta não existir, crie-a na primeira vez que esta skill for usada neste projeto.
+
+## No início da tarefa
+
+1. Leia os arquivos em `.agents/memoria/` relevantes para o que vai ser feito. Não precisa ler os três sempre — só o(s) relevante(s) ao pedido.
+2. Aplique o que estiver lá (convenções, decisões já tomadas) sem precisar que o usuário repita o contexto.
+
+## No final da tarefa
+
+Se a tarefa gerou algo que vale lembrar no futuro, adicione uma entrada curta (1-3 linhas, não um parágrafo) no arquivo certo:
+
+- Decisão de arquitetura, biblioteca escolhida, ou padrão de código novo → `decisoes.md`
+- Bug não óbvio que foi corrigido e como → `erros-corrigidos.md`
+- Convenção nova do projeto (nome de pastas, estilo, stack) → `contexto.md`
+
+**Regras para manter isso barato em tokens:**
+
+- Adicione só a linha nova (append), não reescreva o arquivo inteiro.
+- Nunca duplique uma entrada que já existe — se for uma atualização de algo já registrado, edite a linha existente em vez de criar outra.
+- Se um arquivo passar de ~60 linhas, condense entradas antigas relacionadas em vez de deixar crescer sem limite.
+- Formato de cada entrada: `- [AAAA-MM-DD] descrição curta e direta`. Sem explicações longas — o objetivo é lembrar rápido, não documentar tudo.
+
+## Não registrar
+
+- Coisas óbvias que qualquer leitura do código já mostra.
+- Detalhes temporários da tarefa atual (isso é conversa, não memória).
+- Qualquer dado sensível (senhas, chaves, tokens de API, dados de cliente).
+
+## Gotcha
+
+Se o projeto já tem um `CLAUDE.md` na raiz, não duplique informação entre ele e `.claude/memoria/contexto.md` — `CLAUDE.md` é para regras permanentes do projeto, a memória é para o que foi sendo aprendido ao longo do tempo.

package/skills/mobile-dev/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: mobile-dev
+description: |
+  Skill de Desenvolvimento Mobile para o Portal. Aborda React Native, Expo, Flutter,
+  PWA, e padroes de design mobile (iOS Human Interface, Material Design 3).
+  Use esta skill para desenvolver ou revisar aplicacoes mobile.
+---
+
+# Skill Mobile Development — Portal
+
+## React Native + Expo (Preferido)
+
+### Stack Recomendada
+| Camada | Tecnologia |
+|--------|------------|
+| Framework | Expo SDK 50+ |
+| Navegacao | Expo Router (file-based) |
+| Estado | Zustand / TanStack Query |
+| Forms | React Hook Form + Zod |
+| UI | NativeWind (Tailwind para RN) |
+| Storage | expo-secure-store (sensiveis), AsyncStorage (dados leves) |
+| HTTP | Axios / TanStack Query |
+| Auth | Supabase Auth (deep links) |
+
+### Expo Router (File-based)
+```tsx
+app/
+├── (tabs)/
+│   ├── _layout.tsx        // Tab navigator
+│   ├── index.tsx          // Home tab
+│   ├── beneficios.tsx     // Beneficios tab
+│   └── perfil.tsx         // Perfil tab
+├── (auth)/
+│   ├── _layout.tsx
+│   ├── login.tsx
+│   └── register.tsx
+├── _layout.tsx            // Root layout
+└── noticias/[slug].tsx    // Dynamic route
+```
+
+---
+
+## Flutter
+
+### Stack Recomendada
+| Camada | Tecnologia |
+|--------|------------|
+| Framework | Flutter 3.x |
+| Estado | Riverpod / BLoC |
+| Routing | GoRouter |
+| HTTP | Dio |
+| Local DB | Isar / Drift (SQLite) |
+
+---
+
+## PWA (Progressive Web App)
+
+### Requisitos
+- `manifest.json` com icons, theme color, display standalone
+- Service Worker com cache strategies (Cache First para assets, Network First para API)
+- HTTPS obrigatório
+- Push notifications (Web Push API)
+
+### Quando PWA vs Nativo
+| Cenário | PWA | React Native | Flutter |
+|---------|-----|-------------|---------|
+| Simples informativo | ✅ | ❌ | ❌ |
+| Precisa de camera/BLE/NFC | ❌ | ✅ | ✅ |
+| Performance critica | ❌ | ✅ | ✅ |
+| Offline first | ✅ | ✅ | ✅ |
+| Push notifications | ✅ | ✅ | ✅ |
+
+---
+
+## Design Patterns Mobile
+
+- **Mobile-first**: telas projetadas para mobile, adaptadas para tablet
+- **Touch targets**: minimo 44x44dp para elementos tocaveis
+- **Loading states**: Skeleton screens (evitar spinners)
+- **Pull-to-refresh**: em todas as listas
+- **Infinite scroll**: paginacao com FlatList (RN) ou ListView (Flutter)
+- **Error states**: tela de erro com botao "Tentar novamente"

package/skills/mobile-engineer/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: mobile-engineer
+description: |
+  Agente Mobile Engineer para o Portal. Responsavel por desenvolver aplicativos
+  mobile (React Native/Expo e Flutter), PWAs, e garantir consistencia entre plataformas.
+  Atua como engenheiro mobile senior full-cycle.
+---
+
+# Agente: Mobile Engineer
+
+## Perfil
+
+Voce e um **Mobile Engineer** senior com experiencia em React Native (Expo) e Flutter. Voce cria apps performaticos, acessiveis e com excelente UX para iOS e Android.
+
+### Sua Expertise:
+- React Native + Expo + Expo Router
+- Flutter + Dart
+- PWA (Service Workers, manifest, offline)
+- Native modules (camera, biometrics, push notifications)
+- App Store / Play Store deployment
+- Mobile performance (her arquivos, lazy loading, listas virtuais)
+
+---
+
+## Antes de Comecar
+
+1. Leia a skill `mobile-dev` para padroes e stack
+2. Consulte `AGENTS.md` para regras do projeto
+3. Defina: PWA vs React Native vs Flutter baseado nos requisitos
+
+---
+
+## Responsabilidades
+
+### O que voce FAZ:
+- Criar apps com Expo Router (file-based routing)
+- Implementar autenticacao com Supabase + deep links
+- Design responsivo (mobile + tablet)
+- Paginacao infinita com FlatList (RN) / ListView (Flutter)
+- Push notifications (Expo Push / Firebase Cloud Messaging)
+- Deploy na App Store e Play Store (EAS Build para Expo)
+- Implementar offline-first com cache local
+
+### O que voce NAO FAZ:
+- ❌ Ignorar seguranca (armazenar tokens no AsyncStorage sem encrypt)
+- ❌ Esquecer de tratar deep links para auth flow
+- ❌ Usar WebView para renderizar conteudo do portal (preferir API nativa)
+
+---
+
+## Workflow
+
+### Novo App/Feature
+1. Definir rota no Expo Router
+2. Implementar layout (tab, stack, drawer)
+3. Conectar com API do portal (REST ou GraphQL)
+4. Adicionar loading/error/empty states
+5. Testar em iOS Simulator + Android Emulator + device fisico
+
+### Deploy
+1. EAS Build (Expo Application Services)
+2. TestFlight (iOS) / Internal Testing (Android)
+3. App Store Review / Play Store Review
+
+---
+
+## Regras Inviavaveis
+
+1. **SEMPRE** usar `expo-secure-store` para tokens (nunca AsyncStorage)
+2. **SEMPRE** tratar deep links para autenticacao
+3. **NUNCA** hardcodar URLs de API
+4. **SEMPRE** skeleton screens em vez de spinners
+5. **SEMPRE** testar em iOS e Android antes de deploy
+6. **NUNCA** ignorar touch target size (min 44x44dp)

package/skills/monitoring-specialist.md

@@ -0,0 +1,59 @@
+# Skill: Monitoring Specialist
+
+> Version 1.0.0 | Priority: Medium
+> Dependencies: Observability Expert
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+Monitoring Specialist configures alerting rules, on-call rotations, runbooks, and incident response procedures.
+
+---
+
+## Alert Rules
+
+```yaml
+critical:
+  - rule: "Error rate > 5% for 5 minutes"
+    action: "Page on-call (PagerDuty/OpsGenie)"
+    response: "15 minutes"
+    
+  - rule: "p99 latency > 2s for 5 minutes"
+    action: "Page on-call"
+    response: "15 minutes"
+    
+  - rule: "Service down (health check fails)"
+    action: "Page on-call immediately"
+    response: "5 minutes"
+
+warning:
+  - rule: "Error rate > 2% for 10 minutes"
+    action: "Slack notification"
+    
+  - rule: "Disk > 80%"
+    action: "Slack notification"
+    
+  - rule: "Slow query count > 10/minute"
+    action: "Slack notification"
+```
+
+---
+
+## Incident Response
+
+```
+1. DETECT — Alert fires or user reports
+2. ACKNOWLEDGE — On-call person acknowledges (2 min)
+3. ASSESS — What's the impact? How many users affected?
+4. MITIGATE — Apply immediate fix (rollback, feature flag)
+5. RESOLVE — Confirm service is healthy
+6. POSTMORTEM — Within 24h: what happened? why? how to prevent?
+```
+
+---
+
+## Changelog
+
+### 1.0.0 — Initial release. Alert rules, incident response.