izanagi-ai 2.0.0

package/core/skill-resolver.json

@@ -0,0 +1,169 @@
+{
+  "resolver": "Mapeia short IDs para caminhos reais de skills. Usado nos agentes para reduzir tokens.",
+
+  "aliases": {
+    "architect": "skills/software-architect",
+    "clean-arch": "architecture/clean-architecture",
+    "hexagonal": "architecture/hexagonal-architecture",
+    "cqrs": "architecture/cqrs-specialist",
+    "event-driven": "architecture/event-driven-architect",
+    "ddd": "architecture/ddd-specialist",
+    "microservices": "architecture/microservices-expert",
+    "monolith": "architecture/monolith-expert",
+    "repository": "architecture/repository-pattern",
+    "uow": "architecture/unit-of-work",
+
+    "backend": "coding/backend-engineer",
+    "frontend": "coding/frontend-engineer",
+    "api": "coding/api-designer",
+    "laravel": "coding/laravel-specialist",
+    "php": "coding/php-specialist",
+    "js": "coding/javascript-specialist",
+    "ts": "coding/typescript-specialist",
+    "python": "coding/python-specialist",
+    "react": "coding/react-specialist",
+    "vue": "coding/vue-specialist",
+    "node": "coding/nodejs-specialist",
+    "java": "coding/java-specialist",
+    "csharp": "coding/csharp-specialist",
+
+    "security": "security/security-engineer",
+    "owasp": "security/owasp-auditor",
+    "pentest": "security/pentest-reviewer",
+
+    "reviewer": "skills/senior-code-reviewer",
+    "clean-code": "skills/clean-code-validator",
+    "solid": "skills/solid-validator",
+    "dry-kiss-yagni": "skills/dry-kiss-yagni-validator",
+    "complexity": "skills/complexity-analyzer",
+    "bug-prevention": "skills/bug-prevention",
+    "patterns": "skills/design-pattern-advisor",
+    "refactor": "skills/refactoring-specialist",
+    "tech-debt": "skills/technical-debt-analyzer",
+    "breaking-change": "skills/breaking-change-detector",
+    "perf": "skills/performance-optimizer",
+    "scalability": "skills/scalability-expert",
+
+    "unit-test": "testing/unit-test-engineer",
+    "integration-test": "testing/integration-test-engineer",
+    "e2e-test": "testing/e2e-test-engineer",
+    "mock": "testing/mocking-specialist",
+
+    "db": "database/database-engineer",
+    "sql": "database/sql-optimizer",
+    "postgres": "database/postgresql-specialist",
+    "mysql": "database/mysql-specialist",
+    "sqlserver": "database/sqlserver-specialist",
+    "redis": "database/redis-specialist",
+
+    "devops": "devops/devops-engineer",
+    "docker": "devops/docker-expert",
+    "k8s": "devops/kubernetes-specialist",
+    "git": "devops/git-expert",
+    "gitflow": "devops/git-flow-specialist",
+    "cicd": "devops/ci-cd-specialist",
+    "linux": "devops/linux-specialist",
+    "windows": "devops/windows-specialist",
+
+    "debug": "skills/debug-specialist",
+    "bug": "skills/bug-hunter",
+    "root-cause": "skills/root-cause-analyzer",
+
+    "professor": "teaching/professor-mode",
+    "mentor": "teaching/mentor-mode",
+    "explainer": "teaching/code-explainer",
+    "interactive": "teaching/interactive-teaching",
+    "adaptive": "teaching/adaptive-teaching",
+    "tracker": "teaching/learning-tracker",
+
+    "memory": "memory/memory-manager",
+    "session-compress": "memory/session-compression",
+    "summarizer": "memory/conversation-summarizer",
+    "recovery": "memory/context-recovery",
+    "recall": "memory/smart-recall",
+    "project-memory": "memory/long-term-project-memory",
+
+    "token-reduce": "optimization/token-reducer",
+    "prompt": "optimization/prompt-optimizer",
+    "cost": "optimization/cost-optimizer",
+
+    "requirements": "skills/requirement-analyzer",
+    "risk": "skills/risk-analyzer",
+    "deps": "skills/dependency-analyzer",
+    "tradeoff": "skills/tradeoff-analyzer",
+    "alternatives": "skills/alternative-solution-generator",
+
+    "docs": "skills/documentation-writer",
+    "tech-writer": "skills/technical-writer",
+    "readme": "skills/readme-generator",
+    "uml": "skills/uml-generator",
+    "sequence": "skills/sequence-diagram-builder",
+    "er": "skills/er-diagram-builder",
+
+    "pm": "skills/project-manager",
+    "planner": "skills/task-planner",
+    "release": "skills/release-planner",
+
+    "ux": "skills/ux-reviewer",
+    "a11y": "skills/accessibility-reviewer",
+    "logging": "skills/logging-expert",
+    "observability": "skills/observability-expert",
+    "monitoring": "skills/monitoring-specialist",
+
+    "self-fix": "skills/self-correction",
+    "self-critique": "skills/self-critique",
+    "improvement": "skills/continuous-improvement",
+    "hallucination": "skills/hallucination-detection",
+    "confidence": "skills/confidence-estimator",
+    "learning": "skills/continuous-learning-engine",
+
+    "principal": "skills/principal-engineer",
+    "staff": "skills/staff-engineer",
+    "techlead": "skills/tech-lead",
+    "cto": "skills/cto-advisor",
+    "quality-gates": "core/quality-gates",
+    "planning-engine": "core/planning-engine",
+    "context-engine": "core/context-engine",
+    "token-manager": "core/token-manager",
+    "compression-engine": "core/compression-engine",
+    "reflection-engine": "core/reflection-engine",
+    "evolution-engine": "core/evolution-engine",
+    "decision-engine": "core/decision-engine",
+
+    "ai-agent": "skills/ai-agent/SKILL",
+    "ai-agent-dev": "skills/ai-agent-dev/SKILL",
+    "architecture-patterns": "skills/architecture-patterns/SKILL",
+    "chaos-engineering": "skills/chaos-engineering/SKILL",
+    "cloud-architect": "skills/cloud-architect/SKILL",
+    "cloud-infra": "skills/cloud-infra/SKILL",
+    "data-engineer": "skills/data-engineer/SKILL",
+    "data-engineering": "skills/data-engineering/SKILL",
+    "economia-tokens": "skills/economia-tokens/SKILL",
+    "feature-flags": "skills/feature-flags/SKILL",
+    "frontend-tokens": "skills/frontend/SKILL",
+    "frontend-dev": "skills/frontend-dev/SKILL",
+    "graphql": "skills/graphql/SKILL",
+    "handoff-sessao": "skills/handoff-sessao/SKILL",
+    "i18n-l10n": "skills/i18n-l10n/SKILL",
+    "iac-terraform": "skills/iac-terraform/SKILL",
+    "legacy-migration": "skills/legacy-migration/SKILL",
+    "memoria-projeto": "skills/memoria-projeto/SKILL",
+    "mobile-dev": "skills/mobile-dev/SKILL",
+    "mobile-engineer": "skills/mobile-engineer/SKILL",
+    "privacy-engineer": "skills/privacy-engineer/SKILL",
+    "professor-modo": "skills/professor-modo/SKILL",
+    "qa-checklist": "skills/qa/SKILL",
+    "qa-engineer": "skills/qa-engineer/SKILL",
+    "security-privacy": "skills/security-privacy/SKILL",
+    "serverless-edge": "skills/serverless-edge/SKILL",
+    "sre-reliability": "skills/sre-reliability/SKILL",
+    "wasm": "skills/wasm/SKILL",
+    "web-perf-engineer": "skills/web-perf-engineer/SKILL",
+    "web-perf-seo": "skills/web-perf-seo/SKILL",
+    "websocket-realtime": "skills/websocket-realtime/SKILL",
+    "agentic-coding": "skills/agentic-coding",
+    "mcp": "skills/mcp-server-dev",
+    "prompt-eng": "skills/prompt-engineering",
+    "code-auditor": "skills/code-auditor"
+  }
+}

package/core/token-manager.md

@@ -0,0 +1,152 @@
+# Core: Token Manager
+
+> Version 1.0.0
+> Priority: Critical
+> Dependencies: Context Engine, Compression Engine
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+The Token Manager monitors, budgets, and optimizes every token spent across the entire system. It enforces per-response limits, triggers compression when thresholds are breached, and logs token usage for cost analysis.
+
+---
+
+## Goals
+
+- Never exceed the hard token limit per response.
+- Trigger compression proactively at 70% usage.
+- Provide real-time token accounting per skill.
+- Log token usage for optimization and cost tracking.
+
+---
+
+## Budget Tiers
+
+| Tier | Limit | When Applied |
+|------|-------|-------------|
+| Soft | 2048 tokens | Normal response |
+| Hard | 4096 tokens | Complex response |
+| Context | 8192 tokens | Full context window |
+| Emergency | 512 tokens | Only for error recovery |
+
+---
+
+## Monitor
+
+```
+┌─────────────────────────────────────────────────┐
+│                  TOKEN MONITOR                  │
+│                                                 │
+│  Current Usage: 1,234 / 2,048 (60%)            │
+│  Budget Remaining: 814 tokens                  │
+│  Status: ✅ Normal                              │
+│                                                 │
+│  ┌──────────────┬──────────┬──────────┐        │
+│  │ Skill        │ Allocated│ Used     │        │
+│  ├──────────────┼──────────┼──────────┤        │
+│  │ Architect    │ 400      │ 380      │        │
+│  │ Security     │ 300      │ 290      │        │
+│  │ Backend      │ 800      │ 564      │        │
+│  └──────────────┴──────────┴──────────┘        │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## Triggers
+
+| Condition | Action |
+|-----------|--------|
+| Usage > 70% of soft limit | Activate Compression Engine |
+| Usage > 90% of soft limit | Force compression, reduce detail level |
+| Usage > 100% of soft limit | Drop lowest priority section |
+| Usage > 100% of hard limit | Emergency — truncate to essentials, notify Reflection |
+
+---
+
+## Allocation Algorithm
+
+```
+function allocate(skills, total_budget):
+    sum_priority = sum(skills.priority for skills)
+    
+    for skill in skills:
+        weight = skill.priority / sum_priority
+        skill.budget = floor(total_budget * weight)
+    
+    return skills
+```
+
+Priority weights: critical = 0.4, high = 0.3, medium = 0.2, low = 0.1
+
+---
+
+## Accounting
+
+Every response includes a token usage footer when debug mode is active:
+
+```
+---
+Token Usage: 1,234
+Budget: 2,048
+Remaining: 814
+Compression: none
+Skills: Architect(380), Security(290), Backend(564)
+---
+```
+
+---
+
+## Savings Techniques
+
+| Technique | Tokens Saved | Cost |
+|-----------|-------------|------|
+| Drop filler words | 5-10% | Zero |
+| Use abbreviations | 3-5% | Low (clarity risk) |
+| Summarize examples | 10-20% | Low |
+| Remove code comments | 15-25% | Medium (context loss) |
+| Use compact format | 20-30% | Low |
+| Skip redundant validation | 5-10% | Medium |
+
+---
+
+## Rules
+
+### Always
+
+- ✅ Track every token in every response.
+- ✅ Trigger compression proactively at 70%.
+- ✅ Log token usage per skill.
+- ✅ Respect hard limit unconditionally.
+
+### Never
+
+- ❌ Exceed hard limit.
+- ❌ Skip compression when triggered.
+- ❌ Compress security-critical information.
+
+---
+
+## Metrics
+
+| Metric | Target | How to Measure |
+|--------|--------|---------------|
+| Soft limit compliance | 100% | Responses within soft limit |
+| Hard limit breaches | 0 | Responses exceeding hard limit |
+| Compression trigger rate | ≥ 90% | Triggers vs actual breaches |
+| Average tokens per response | < 1500 | Running average |
+
+---
+
+## Changelog
+
+### 1.0.0 (2026-07-17)
+
+- Initial release
+- 4-tier budget system
+- Priority-based allocation algorithm
+- Real-time monitoring with status tracking
+- Compression triggers at 70% and 90%
+- Emergency truncation at hard limit

package/database/database-engineer.md

@@ -0,0 +1,244 @@
+# Database: Database Engineer
+
+> Version 1.0.0
+> Priority: High
+> Dependencies: Software Architect, SQL Optimizer
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+The Database Engineer designs, implements, and optimizes database schemas. It ensures data integrity through constraints, enforces relationships, optimizes queries with proper indexing, and plans for growth with partitioning and sharding strategies.
+
+---
+
+## Goals
+
+- Design normalized schemas (3NF minimum).
+- Enforce data integrity with constraints (PK, FK, CHECK, UNIQUE).
+- Optimize queries with proper indexing strategies.
+- Plan migrations that are safe and reversible.
+- Document schema with ER diagrams.
+
+---
+
+## Triggers
+
+| Condition | Action |
+|-----------|--------|
+| `task == "database"` or `task == "schema"` | Full database design |
+| `task == "migration"` | Create migration |
+| After architecture approved | Design data model |
+| Performance issue | Query optimization |
+
+---
+
+## Workflow
+
+```
+1. Analyze domain entities
+    ↓
+2. Design entity-relationship model
+    ↓
+3. Normalize to 3NF (or denormalize intentionally)
+    ↓
+4. Choose data types
+    ↓
+5. Define constraints (PK, FK, UNIQUE, CHECK)
+    ↓
+6. Design index strategy
+    ↓
+7. Create migration files
+    ↓
+8. Create seeders (if needed)
+    ↓
+9. Generate ER diagram documentation
+    ↓
+10. Validate with sample queries
+```
+
+---
+
+## Naming Conventions
+
+```yaml
+tables: snake_case, plural
+  - users, posts, comments, post_tags
+
+columns: snake_case, singular
+  - id, name, email, created_at, post_id
+
+primary_key: "id" (auto-increment or UUID)
+foreign_key: "{singular_table}_id"
+  - post_id, user_id, comment_id
+
+indexes: "{table}_{column}_index"
+  - posts_user_id_index, comments_post_id_index
+
+timestamps: created_at, updated_at
+soft_deletes: deleted_at
+```
+
+---
+
+## Data Type Selection
+
+```yaml
+integers:
+  id: bigIncrements or uuid
+  counters: integer (smallint if < 32768)
+  foreign_keys: unsignedBigInteger or uuid
+
+strings:
+  short: string(100)
+  medium: string(255)
+  long: text
+  very_long: longText
+
+booleans: boolean (not tinyint)
+
+temporal:
+  dates: date (not datetime if time isn't needed)
+  timestamps: datetime or timestampTz
+  duration: integer (seconds)
+
+financial: decimal(10, 2) — never float
+
+binary: uuid (not string)
+```
+
+---
+
+## Migration Template (Laravel)
+
+```php
+Schema::create('posts', function (Blueprint $table) {
+    $table->id();
+    $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+    $table->string('title', 200);
+    $table->string('slug', 255)->unique();
+    $table->text('content');
+    $table->string('status', 20)->default('draft'); // draft, published, archived
+    $table->timestampTz('published_at')->nullable();
+    $table->timestamps();
+    $table->softDeletes();
+
+    $table->index('status');
+    $table->index('published_at');
+});
+```
+
+---
+
+## Index Strategy
+
+```yaml
+primary_key: always indexed (PK)
+unique: for columns with unique constraint
+foreign_key: always index FK columns
+where: index columns used in WHERE clauses
+order: index columns used in ORDER BY
+join: index columns used in JOIN conditions
+
+composite_indexes:
+  - table: posts
+    columns: [status, published_at]
+    reason: "WHERE status = 'published' ORDER BY published_at DESC"
+    
+  - table: comments
+    columns: [post_id, created_at]
+    reason: "WHERE post_id = ? ORDER BY created_at DESC"
+
+partial_indexes:
+  - table: posts
+    columns: [published_at]
+    condition: "WHERE status = 'published'"
+    
+avoid:
+  - indexing boolean columns (low cardinality)
+  - indexing text/blob columns
+  - over-indexing (write performance impact)
+```
+
+---
+
+## Normalization Levels
+
+| Level | Rules | When to Break |
+|-------|-------|--------------|
+| **1NF** | Atomic columns, unique rows | Never skip |
+| **2NF** | 1NF + full PK dependency | Never skip |
+| **3NF** | 2NF + transitive dependency removed | Default target |
+| **Denormalize** | Intentionally add redundancy | For read performance (reports, analytics) |
+
+---
+
+## Migration Safety
+
+```yaml
+safe:
+  - Adding a new table
+  - Adding a nullable column
+  - Adding an index (concurrently in production)
+  - Adding a default value to an existing column
+
+requires_care:
+  - Adding a NOT NULL column (need default first)
+  - Renaming a column (2-step: add + drop)
+  - Changing column type (check data compatibility)
+  - Adding a foreign key (lock risk on large tables)
+
+unsafe:
+  - Dropping a column (data loss)
+  - Dropping a table (data loss)
+  - Changing a column to NOT NULL without default
+  - Running on production without review
+```
+
+---
+
+## Rules
+
+### Always
+
+- ✅ Design schema before writing code.
+- ✅ Use migrations for all schema changes.
+- ✅ Add indexes for FK, WHERE, ORDER BY, and JOIN.
+- ✅ Normalize to 3NF by default.
+- ✅ Make migrations reversible (up + down).
+- ✅ Document relationships and constraints.
+
+### Never
+
+- ❌ Use `float` for currency (use `decimal`).
+- ❌ Skip indexes on foreign keys.
+- ❌ Run unsafe migrations on production without review.
+- ❌ Store serialized data in columns (use JSON or related tables).
+- ❌ Use `*` in SELECT (always specify columns).
+- ❌ Forget soft deletes where appropriate.
+
+---
+
+## Metrics
+
+| Metric | Target | How to Measure |
+|--------|--------|---------------|
+| Normalization level | ≥ 3NF | Schema review |
+| Index coverage | 100% of FK + WHERE | Query analysis |
+| Migration reversibility | 100% | Check down() methods exist |
+| Query performance | < 100ms p95 | Query log analysis |
+
+---
+
+## Changelog
+
+### 1.0.0 (2026-07-17)
+
+- Initial release
+- Naming conventions for tables, columns, indexes
+- Data type selection guide
+- Migration template with comments (Laravel)
+- Index strategy (PK, FK, WHERE, ORDER, JOIN, composite, partial)
+- Normalization guide with break conditions
+- Migration safety levels (safe, careful, unsafe)

package/database/mysql-specialist.md

@@ -0,0 +1,61 @@
+# Database: MySQL Specialist
+
+> Version 1.0.0 | Priority: Medium
+> Dependencies: Database Engineer, SQL Optimizer
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+MySQL Specialist optimizes for MySQL 8+ specific features: InnoDB, full-text indexes, window functions, CTEs, JSON, and EXPLAIN FORMAT=JSON.
+
+---
+
+## MySQL-Specific Features
+
+```yaml
+engine: InnoDB only (never MyISAM)
+charset: utf8mb4 (full Unicode, including emoji)
+collation: utf8mb4_unicode_ci
+json: native JSON type with virtual columns
+fulltext: FULLTEXT index on CHAR/VARCHAR/TEXT
+window: ROW_NUMBER(), RANK() (MySQL 8+)
+CTE: WITH ... AS (MySQL 8+)
+spatial: SPATIAL index for geometry
+```
+
+---
+
+## EXPLAIN Analysis
+
+```sql
+EXPLAIN FORMAT=JSON
+SELECT * FROM posts WHERE status = 'published'\G
+
+-- Look for:
+-- type: ALL (full scan) → needs index
+-- type: index (full index scan) → better, but still slow
+-- type: ref/range → good, index used
+-- type: const → best (PK/UNIQUE lookup)
+-- Extra: Using filesort → needs index on ORDER BY
+-- Extra: Using temporary → needs index on GROUP BY
+```
+
+---
+
+## InnoDB Tuning
+
+```ini
+innodb_buffer_pool_size = 70% of RAM
+innodb_log_file_size = 1GB
+innodb_flush_log_at_trx_commit = 2 (balance)
+innodb_file_per_table = 1
+innodb_autoinc_lock_mode = 2
+```
+
+---
+
+## Changelog
+
+### 1.0.0 — Initial release. InnoDB, EXPLAIN FORMAT=JSON, tuning.

package/database/postgresql-specialist.md

@@ -0,0 +1,70 @@
+# Database: PostgreSQL Specialist
+
+> Version 1.0.0 | Priority: High
+> Dependencies: Database Engineer, SQL Optimizer
+> Compatibility: ">=1.0.0"
+
+---
+
+## Identity
+
+PostgreSQL Specialist leverages PG-specific features: JSONB, full-text search (tsvector), partial indexes, CTEs, window functions, partitioning, and extensions.
+
+---
+
+## PG-Specific Features
+
+```yaml
+jsonb: use for flexible schemas, with GIN index for @> queries
+fulltext: tsvector/tsquery with GIN index
+partitioning: LIST/RANGE/HASH for large tables
+CTE: WITH ... AS for recursive queries, materialized
+window: ROW_NUMBER(), RANK(), LAG(), LEAD()
+partial_index: index with WHERE clause
+exclusion: for overlap/adjacency constraints
+extensions: pgcrypto, uuid-ossp, postgis, pg_stat_statements
+```
+
+---
+
+## JSONB Patterns
+
+```sql
+-- Table
+CREATE TABLE events (
+    id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
+    payload JSONB NOT NULL,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Index
+CREATE INDEX idx_events_payload ON events USING GIN (payload jsonb_path_ops);
+
+-- Queries
+SELECT * FROM events WHERE payload @> '{"type": "user_created"}';
+SELECT * FROM events WHERE payload->>'email' LIKE '%@example.com';
+UPDATE events SET payload = jsonb_set(payload, '{status}', '"processed"');
+```
+
+---
+
+## Full-Text Search
+
+```sql
+-- Add tsvector column
+ALTER TABLE posts ADD COLUMN search_vector TSVECTOR
+    GENERATED ALWAYS AS (to_tsvector('portuguese', title || ' ' || content)) STORED;
+
+-- Index
+CREATE INDEX idx_posts_search ON posts USING GIN (search_vector);
+
+-- Query
+SELECT title FROM posts
+WHERE search_vector @@ plainto_tsquery('portuguese', 'como criar login');
+```
+
+---
+
+## Changelog
+
+### 1.0.0 — Initial release. JSONB, fulltext, partitioning, CTEs.