izanagi-ai 2.0.0

package/skills/documentation-writer.md

@@ -0,0 +1,66 @@
+# Skill: Documentation Writer
+
+> Version 1.0.0 | Priority: Medium
+> Dependencies: Technical Writer
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+Documentation Writer creates comprehensive project documentation: READMEs, API docs, setup guides, architecture docs, and contribution guidelines.
+
+---
+
+## Documentation Types
+
+```yaml
+README: "Project overview, quick start, badges, links"
+API: "OpenAPI spec, endpoints, examples, auth"
+setup: "Prerequisites, installation, configuration, development"
+architecture: "Patterns, folder structure, key decisions (ADRs)"
+contribution: "PR process, coding standards, testing guidelines"
+deployment: "Infrastructure, CI/CD, environments, runbooks"
+```
+
+---
+
+## README Template
+
+```markdown
+# Project Name
+
+> Short description (1-2 sentences)
+
+## Quick Start
+
+```bash
+git clone ...
+cp .env.example .env
+composer install
+php artisan serve
+```
+
+## Features
+
+- Feature 1
+- Feature 2
+
+## Tech Stack
+
+- Backend: Laravel 11
+- Frontend: React + Tailwind
+- Database: PostgreSQL 16
+
+## Documentation
+
+- [API Docs](/docs/api.md)
+- [Architecture](/docs/architecture.md)
+- [Contributing](/CONTRIBUTING.md)
+```
+
+---
+
+## Changelog
+
+### 1.0.0 — Initial release. Types, README template.

package/skills/dry-kiss-yagni-validator.md

@@ -0,0 +1,114 @@
+# Skill: DRY / KISS / YAGNI Validator
+
+> Version 1.0.0 | Priority: Medium
+> Dependencies: Clean Code Validator
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+Ensures code follows three fundamental principles: Don't Repeat Yourself (DRY), Keep It Simple Stupid (KISS), and You Ain't Gonna Need It (YAGNI).
+
+---
+
+## DRY — Don't Repeat Yourself
+
+### Checks
+
+- [ ] No duplicated logic across methods/classes
+- [ ] No copy-pasted code blocks
+- [ ] Repeated patterns extracted into functions/classes
+- [ ] Business rules defined once
+- [ ] Configuration externalized (not hardcoded)
+
+### Examples
+
+```php
+// ❌ Violation
+$total = $price + $tax;
+$finalTotal = $price + $tax + $shipping;
+$discountedTotal = ($price + $tax) * 0.9;
+
+// ✅ DRY
+function calculateSubtotal(float $price, float $tax): float {
+    return $price + $tax;
+}
+$total = calculateSubtotal($price, $tax);
+$finalTotal = calculateSubtotal($price, $tax) + $shipping;
+```
+
+---
+
+## KISS — Keep It Simple
+
+### Checks
+
+- [ ] Simplest solution that works
+- [ ] No over-engineered abstractions
+- [ ] No design patterns applied where not needed
+- [ ] Code is readable at first glance
+- [ ] No premature optimization
+
+### Signs of Over-Engineering
+
+```
+- FactoryFactory pattern
+- Strategy pattern for a single if-else
+- Abstract base class with one concrete implementation
+- Event system when a simple function call works
+- Microservice for a CRUD module
+```
+
+---
+
+## YAGNI — You Ain't Gonna Need It
+
+### Checks
+
+- [ ] No unused parameters, methods, or classes
+- [ ] No commented-out "future" code
+- [ ] No "we might need this later" abstractions
+- [ ] No unused dependencies in composer.json
+- [ ] No unused imports
+
+### Examples
+
+```php
+// ❌ YAGNI violation — building for hypothetical future
+class PaymentProcessor
+{
+    public function process(
+        PaymentMethod $method,
+        ?bool $useCrypto = null,  // might need later?
+        ?string $fallbackCurrency = null,  // for future expansion?
+    ) { ... }
+}
+
+// ✅ YAGNI — only what's needed now
+class PaymentProcessor
+{
+    public function process(PaymentMethod $method): void { ... }
+}
+```
+
+---
+
+## Score
+
+```yaml
+dry_score: 4/5
+kiss_score: 5/5
+yagni_score: 3/5
+
+violations:
+  - principle: yagni
+    location: "UserService.php:22"
+    detail: "Unused method getHistory that calls an API that doesn't exist yet"
+```
+
+---
+
+## Changelog
+
+### 1.0.0 — Initial release. DRY, KISS, YAGNI checks with examples.

package/skills/economia-tokens/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: economia-tokens
+description: Reduz o consumo de tokens em QUALQUER tarefa de código ou análise de arquivos. Use sempre, em toda tarefa — não é preciso o usuário pedir "economize tokens". Ativa quando for ler arquivos grandes, editar código, explicar mudanças, rodar comandos, ou revisar um diff. Evita reler arquivos inteiros sem necessidade, corta narração desnecessária, prefere trechos/diffs a colar arquivos completos, e agrupa chamadas de ferramentas.
+---
+
+# Economia de tokens
+
+Instruções permanentes de como trabalhar de forma econômica. Valem para a sessão inteira, não só na primeira leitura.
+
+## Leitura de arquivos
+
+- Antes de ler um arquivo inteiro, pergunte: "uma busca (grep/glob) direcionada resolve?". Se sim, use busca em vez de abrir o arquivo todo.
+- Ao investigar um bug ou função específica, leia só o trecho relevante (range de linhas), não o arquivo inteiro.
+- Nunca releia um arquivo que já está no contexto e não mudou desde a última leitura.
+- Se precisar ver várias partes de um mesmo arquivo grande, agrupe numa única leitura em vez de várias chamadas pequenas.
+
+## Edição de código
+
+- Prefira edições pontuais (diff/patch) a reescrever o arquivo inteiro quando só uma parte muda.
+- Não cole de volta o arquivo inteiro no chat para "mostrar o resultado" — mostre só o trecho alterado, a menos que o usuário peça o arquivo completo.
+
+## Comunicação
+
+- Não narre o que vai fazer antes de fazer ("vou analisar o código...", "deixa eu verificar..."). Só execute e reporte o resultado.
+- Respostas diretas: sem repetir de volta o que o usuário já disse, sem resumir o pedido antes de responder.
+- Ao explicar uma mudança, seja telegráfico: bullets curtos, sem parágrafos de introdução/conclusão.
+- Evite frases de preenchimento ("Com certeza!", "Ótima pergunta!", "Vamos lá!").
+
+## Comandos e ferramentas
+
+- Agrupe comandos relacionados numa única chamada de terminal (ex.: `comando1 && comando2`) em vez de várias chamadas separadas.
+- Ao rodar comandos que geram saída grande (ex. `git diff`, logs, build), filtre ou limite a saída (`--stat`, `| head`, `| tail`) em vez de despejar tudo no contexto.
+- Não rode o mesmo comando de verificação repetidamente sem necessidade (ex. rodar testes 3x seguidas sem mudar nada).
+
+## Gotchas (erros comuns que fazem gastar token à toa)
+
+- Reler o mesmo arquivo em cada turno "por segurança" — só releia se o arquivo pode ter mudado (edição externa, outro processo).
+- Colar o diff inteiro de um commit grande quando só 2-3 linhas importam para a pergunta.
+- Explicar de novo um conceito que já foi explicado nesta sessão.
+- Rodar `ls -R` ou `find` em diretórios grandes (ex. `node_modules`) sem filtro.

package/skills/er-diagram-builder.md

@@ -0,0 +1,85 @@
+# Skill: ER Diagram Builder
+
+> Version 1.0.0 | Priority: Low
+> Dependencies: Database Engineer
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+ER Diagram Builder generates entity-relationship diagrams from schema definitions or descriptions.
+
+---
+
+## PlantUML ER
+
+```plantuml
+@startuml
+!define table(x) class x << (T,#FFAAAA) >>
+
+table(users) {
+  *id: UUID
+  *name: string
+  *email: string [unique]
+  created_at: datetime
+}
+
+table(posts) {
+  *id: UUID
+  *title: string
+  *content: text
+  *user_id: UUID
+  *status: string
+  published_at: datetime
+}
+
+table(comments) {
+  *id: UUID
+  *body: text
+  *user_id: UUID
+  *post_id: UUID
+}
+
+users ||--o{ posts : creates
+users ||--o{ comments : writes
+posts ||--o{ comments : has
+@enduml
+```
+
+---
+
+## Mermaid ER
+
+```mermaid
+erDiagram
+    users {
+        uuid id PK
+        string name
+        string email UK
+        datetime created_at
+    }
+    posts {
+        uuid id PK
+        string title
+        text content
+        uuid user_id FK
+        string status
+        datetime published_at
+    }
+    comments {
+        uuid id PK
+        text body
+        uuid user_id FK
+        uuid post_id FK
+    }
+    users ||--o{ posts : ""
+    users ||--o{ comments : ""
+    posts ||--o{ comments : ""
+```
+
+---
+
+## Changelog
+
+### 1.0.0 — Initial release. PlantUML ER, Mermaid ER.

package/skills/feature-flags/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: feature-flags
+description: |
+  Skill de Feature Flags e A/B Testing para o Portal. Aborda estrategias de rollout,
+  targeted releases, canary deployments, A/B/n experiments e ferramentas de gerenciamento
+  de flags. Use esta skill para implementar entregas graduais e experimentacao.
+---
+
+# Skill Feature Flags — Portal
+
+## Provedores
+
+| Ferramenta | Uso |
+|------------|-----|
+| LaunchDarkly | Feature flags enterprise |
+| Statsig | Flags + experimentacao + analytics |
+| Split.io | Flags + metrics |
+| Flagsmith | Open-source (self-hosted) |
+| Custom (env vars) | Flags simples, sem target |
+
+---
+
+## Estrategias de Flag
+
+### Boolean Flags
+```tsx
+if (isEnabled("new-checkout-flow")) {
+  return <NewCheckout />;
+}
+return <LegacyCheckout />;
+```
+
+### Percentage Rollout
+```tsx
+// Lancamento gradual: 10% → 25% → 50% → 100%
+await flagsmith.setPercentage("new-header", 10);
+```
+
+### Targeted Release
+```tsx
+// Liberar para grupo especifico
+"targets": [
+  { "audience": "internal-team", "enabled": true },
+  { "audience": "beta-users", "enabled": true },
+  { "audience": "all", "enabled": false }
+]
+```
+
+### Canary / Ring Deployment
+```
+Ring 0 (dev) → Ring 1 (internal) → Ring 2 (beta) → Ring 3 (all)
+```
+
+---
+
+## A/B Testing
+
+### Estrutura
+```tsx
+const experiment = statsig.getExperiment("homepage-hero-v2");
+
+return (
+  <div>
+    {experiment.get("variant") === "v1" ? <HeroV1 /> : <HeroV2 />}
+  </div>
+);
+```
+
+### Metricas
+| Metrica | Descricao |
+|---------|-----------|
+| Primary | O que queremos melhorar (ex: click rate) |
+| Secondary | Efeitos colaterais (ex: bounce rate) |
+| Guardrail | O que nao pode piorar (ex: page load time) |
+
+---
+
+## Boas Praticas
+
+### Nomenclatura
+```
+<area>.<feature>.<variant>
+ex: checkout.new-flow.control
+```
+
+### Lifecycle
+```
+dev → staging → rollout (5%) → rollout (25%) → rollout (100%) → cleanup (remover flag)
+```
+
+### Anti-Padroes
+- ❌ Flags eternas (que nunca saem) — sempre cleanup apos stable
+- ❌ Flags em cascata (flag A depende de flag B)
+- ❌ Flags sem owner definido
+- ❌ Testar apenas com flag ON (esquecer de testar flag OFF)