vibes-plug 2.5.0 → 2.14.1

package/skills/accessibility-testing-expert/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: accessibility-testing-expert
+description: "Expert guide for automated and manual Web Accessibility (a11y) testing — axe-core, Pa11y, Playwright a11y, screen reader testing, and WCAG 2.2 Level AA/AAA compliance / Panduan ahli pengujian aksesibilitas web."
+author: "Roedy Rustam"
+---
+
+# Accessibility Testing Expert (2026 Edition)
+
+[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
+
+---
+
+<a name="english"></a>
+## English
+
+### Orchestration & Integration
+- **`global-a11y-i18n-expert`**: Core WCAG rules, ARIA patterns, and internationalization standards.
+- **`e2e-testing-expert`**: Integrating automated accessibility assertions into Playwright/Vitest CI suites.
+- **`ui-components-expert`**: Accessible component primitives (Radix UI, Base UI, ARIA patterns).
+- **`visual-qa-vision-agent`**: Visual audits for focus rings, contrast ratios, and layout flow.
+
+### Description
+Production guide for automated, semi-automated, and manual web accessibility (a11y) testing. Covers WCAG 2.2 Level AA/AAA compliance validation using `@axe-core/playwright`, Pa11y, Google Lighthouse CI, screen reader verification (NVDA, VoiceOver), keyboard navigation audits, focus management, and color contrast compliance.
+
+### Trigger Conditions
+- Running automated accessibility test suites in CI/CD pipelines.
+- Auditing web apps for WCAG 2.1 / 2.2 Level AA compliance and legal accessibility requirements (ADA, EAA).
+- Debugging keyboard traps, missing ARIA labels, or broken screen reader navigation.
+- Writing test cases for focus trapping in modals and custom dialogs.
+
+---
+
+### Core Testing Workflows
+
+#### 1. Automated A11y Testing with Playwright & Axe-Core
+```typescript
+import { test, expect } from '@playwright/test';
+import AxeBuilder from '@axe-core/playwright';
+
+test.describe('Accessibility Automated Audits', () => {
+  test('homepage should have zero critical or serious a11y violations', async ({ page }) => {
+    await page.goto('/');
+
+    const accessibilityScanResults = await new AxeBuilder({ page })
+      .withTags(['wcag2a', 'wcag2aa', 'wcag22aa'])
+      .disableRules(['color-contrast']) // If tested separately
+      .analyze();
+
+    expect(accessibilityScanResults.violations).toEqual([]);
+  });
+
+  test('modal dialog should trap focus and pass a11y audit', async ({ page }) => {
+    await page.goto('/dashboard');
+    await page.click('button#open-modal');
+
+    // Verify modal is open and focused
+    const modal = page.locator('[role="dialog"]');
+    await expect(modal).toBeVisible();
+
+    const modalAudit = await new AxeBuilder({ page })
+      .include('[role="dialog"]')
+      .analyze();
+
+    expect(modalAudit.violations).toEqual([]);
+
+    // Verify keyboard escape closes modal
+    await page.keyboard.press('Escape');
+    await expect(modal).toBeHidden();
+  });
+});
+```
+
+#### 2. Automated Pa11y CI Configuration (`.pa11yci.json`)
+```json
+{
+  "defaults": {
+    "standard": "WCAG2AA",
+    "timeout": 15000,
+    "runners": ["axe", "htmlcs"],
+    "ignore": [
+      "WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.Abs"
+    ]
+  },
+  "urls": [
+    "http://localhost:3000/",
+    "http://localhost:3000/login",
+    "http://localhost:3000/pricing",
+    "http://localhost:3000/docs"
+  ]
+}
+```
+
+#### 3. Keyboard & Screen Reader Verification Checklist
+- **Tab Navigation**: All interactive elements (`<button>`, `<a>`, `<input>`) can receive focus in logical reading order.
+- **Focus Indicators**: Visible, high-contrast focus rings (`outline: 2px solid var(--focus-color)` with `outline-offset`).
+- **No Keyboard Traps**: Focus can enter and leave components using only `Tab`, `Shift+Tab`, and `Esc`.
+- **Landmarks**: Proper semantic tags (`<header>`, `<nav>`, `<main>`, `<footer>`, `<aside>`).
+- **ARIA Attributes**: `aria-expanded`, `aria-controls`, `aria-haspopup`, and `aria-live` updated dynamically.
+
+---
+
+<a name="bahasa-indonesia"></a>
+## Bahasa Indonesia
+
+### Integrasi Orkestrasi
+- **`global-a11y-i18n-expert`**: Pedoman standar WCAG, pola ARIA, dan aksesibilitas internasional.
+- **`e2e-testing-expert`**: Integrasi pengujian aksesibilitas otomatis ke pipeline Playwright CI.
+- **`ui-components-expert`**: Validasi aksesibilitas komponen headless dan desain UI.
+
+### Deskripsi
+Panduan produksi untuk pengujian aksesibilitas web (a11y) otomatis dan manual. Memastikan kepatuhan terhadap standar WCAG 2.2 Level AA/AAA menggunakan `@axe-core/playwright`, Pa11y, Lighthouse CI, pengujian screen reader, navigasi keyboard, dan kontras warna.
+
+### Kondisi Pemicu
+- Menjalankan audit aksesibilitas otomatis di pipeline CI/CD.
+- Memverifikasi kepatuhan hukum aksesibilitas (WCAG 2.2, ADA, EAA).
+- Menguji alur keyboard dan pembaca layar (screen reader) pada komponen kompleks seperti modal dan dropdown.

package/skills/ai-llm-integration-expert/SKILL.md

@@ -1,180 +1,194 @@
----
-name: ai-llm-integration-expert
-description: "Expert guide for integrating Large Language Models (LLMs), Model Context Protocol (MCP), RAG architecture, vector databases, and AI agents / Panduan ahli untuk integrasi LLM, Model Context Protocol (MCP), arsitektur RAG, vector database, dan agen AI."
-author: vibes-plug-swarm
----
-
-# AI & LLM Integration Expert (2026 Edition)
-
-[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
-
----
-
-<a name="english"></a>
-## English
-
-### Description
-Production-grade guidelines for integrating AI, Model Context Protocol (MCP), and Large Language Models (LLMs) into modern applications. Covers RAG pipelines, vector embeddings, real-time token streaming, agentic tool execution, memory architectures, prompt caching, and multi-model orchestration.
-
-### Trigger Conditions
-- Integrating frontier models: **OpenAI GPT-4o / GPT-4.1 / GPT-5**, **Anthropic Claude 3.7 / Claude 4 Sonnet/Opus**, **Google Gemini 3.1 Pro/Flash/Ultra**, or open-source models (DeepSeek-V3/R2, Llama 4, Qwen 3).
-- Implementing **Model Context Protocol (MCP)** server or client integrations (MCP 1.9+).
-- Building AI chatbots, copilots, or **autonomous AI agent workflows** (LangGraph, OpenAI Agents SDK, Google ADK, Mastra.ai, Vercel AI SDK 4.x/5.x).
-- Building **agentic memory** systems (short-term, long-term, episodic) using Mem0, MemGPT, or Supabase-backed memory stores.
-- Implementing RAG with vector databases (Supabase `pgvector` HNSW, Qdrant, Pinecone, Weaviate).
-- Handling real-time AI token streaming via **SSE**, **Web Streams**, or **WebSockets**.
-- Designing AI agents with **tool-calling**, **computer use** (browser/OS automation), or **code interpreter** capabilities.
-
-### Model Capability Matrix (2026)
-
-| Provider | Model | Context | Strengths |
-|---|---|---|---|
-| OpenAI | GPT-4o / GPT-4.1 | 128K | Multimodal, tool-calling, speed |
-| OpenAI | GPT-5 | 1M+ | Reasoning, agentic tasks |
-| Anthropic | Claude 4 Sonnet | 200K | Coding, long documents, Computer Use |
-| Anthropic | Claude 4 Opus | 200K | Complex reasoning, deep analysis |
-| Google | Gemini 3.1 Flash | 2M | Speed, cost efficiency, multimodal |
-| Google | Gemini 3.1 Pro | 2M | Code, reasoning, deep research |
-| Meta | Llama 4 Scout/Maverick | 512K | Open-source, self-hosted |
-| DeepSeek | V3 / R2 | 128K | Code, math, cost-efficient |
-
-### Core Architecture Guidelines
-
-#### 1. Model Context Protocol (MCP) Integration (v1.9+)
-Standardize agent-tool interactions using MCP. The 2026 standard adds **Streamable HTTP transport** alongside stdio/SSE:
-- **MCP Servers**: Expose tools, resources, and prompt templates over JSON-RPC 2.0.
-- **Streamable HTTP**: New default transport for cloud-hosted MCP servers — supports bidirectional streaming without long-polling.
-- **Security & Scope**: Validate all incoming parameters with Zod schemas. Enforce strict authorization boundaries before executing tool calls.
-- **Tool namespacing**: Use `domain/action` naming (`files/read`, `db/query`) to avoid collisions in multi-server environments.
-
-#### 2. AI Agents SDK Landscape (2026)
-Choose the right agentic framework based on your needs:
-
-| Framework | Best For | Key Feature |
-|---|---|---|
-| **OpenAI Agents SDK** | GPT-5 native agents | Handoffs, guardrails, tracing built-in |
-| **Google ADK** | Gemini-powered agents | Multi-agent, streaming, Vertex AI integration |
-| **LangGraph** | Complex stateful workflows | Graph-based, human-in-the-loop, any LLM |
-| **Mastra.ai** | TypeScript-first agents | Built-in memory, evals, RAG |
-| **Vercel AI SDK 5.x** | Streaming UI + agents | RSC streaming, multi-provider, tool-calling |
-
-#### 3. Agentic Memory Architecture
-Production AI agents require persistent memory across sessions:
-- **Short-term (In-context)**: Pass recent conversation turns in the prompt window.
-- **Long-term (Vector Store)**: Store user preferences and past interactions as embeddings in `pgvector` or Qdrant; retrieve with semantic similarity.
-- **Episodic (Episodic Memory)**: Use **Mem0** or **MemGPT** to give agents human-like recall — automatically summarizes and indexes past interactions.
-- **Structured (Knowledge Graph)**: Use a graph DB (Neo4j, Kuzu) for entity relationships and factual memory.
-
-#### 4. Advanced RAG (Retrieval-Augmented Generation) Pipeline
-Build a production-grade RAG pipeline with hybrid search:
-1. **Ingestion**: Chunk documents (500-1000 tokens, 10% overlap, respect semantic headings).
-2. **Embedding**: Use `text-embedding-3-large` (OpenAI), `gemini-embedding-004` (Google), or `nomic-embed-text` (open-source).
-3. **Storage & Hybrid Search**: PostgreSQL `pgvector` (HNSW index) or Qdrant. Combine vector cosine similarity with BM25 full-text search for hybrid retrieval.
-4. **Reranking**: Apply cross-encoder reranker (Cohere Rerank 3, FlashRank) on top-K results.
-5. **Generation**: Inject top contextual snippets into the system prompt with source citations.
-
-#### 5. Prompt Caching (Cost Optimization)
-Reduce costs by 80-90% on repeated long prompts using provider-native caching:
-- **Anthropic**: Automatic prompt caching for prompts > 1024 tokens (marked with `cache_control: {"type": "ephemeral"}`).
-- **OpenAI**: Automatic prefix caching for prompts > 1024 tokens in GPT-4o and later models.
-- **Google**: Context caching in Gemini API via `cachedContent` for large system prompts or documents.
-
-#### 6. Streaming Responses & Vercel AI SDK 5.x
-- **Backend (Next.js/Bun/FastAPI)**: Pipe stream chunks via Web Streams API or SSE.
-- **Frontend (React)**: Use Vercel AI SDK `useChat` / `useCompletion` for zero perceived latency.
-- **RSC Streaming**: Use AI SDK 5.x `streamUI` to stream React components from the server — agent-rendered UI.
-
-#### 7. Computer Use & Browser Agents
-Modern agents can control browsers and operating systems:
-- **Anthropic Computer Use**: Claude 4 can take screenshots and control mouse/keyboard (ideal for browser automation).
-- **Browser-Use**: Open-source library for browser-controlling agents with any LLM.
-- **Playwright MCP Server**: Expose a full browser to AI agents via MCP tools (`navigate`, `click`, `screenshot`).
-
-#### 8. Structured Output & Tool Calling
-- Use native Tool/Function Calling APIs with strict JSON schemas via Zod (`zodResponseFormat`).
-- Prefer **structured output mode** over prompt engineering for JSON — guaranteed schema conformance.
-- Support reasoning models (DeepSeek-R2, Gemini 3.1 Pro Thinking, Claude 4 extended thinking) by separating internal `<think>` tokens from client-facing output.
-
-#### 9. Cost & Rate Limit Management
-- Monitor token consumption per session; store metrics in telemetry tables.
-- Implement **semantic caching** using Redis + vector similarity to skip redundant model queries.
-- Use **batch APIs** (OpenAI Batch, Anthropic Message Batches) for async, high-volume workloads at 50% cost reduction.
-
-#### 10. Skill Orchestration & Handoff
-- **Upstream Orchestrator**: Executes during **Phase 4** of `zero-to-prod-orchestrator` or after AI decision lock in `brainstorming`.
-- **MCP Server Architecture**: Delegate custom MCP server creation to `mcp-server-architect` and payment tools to `doku-mcp-server`.
-- **Multi-Agent & Swarm Workflows**: Delegate complex agent state graphs to `multi-agent-orchestration` and Gemini long-context optimization to `gemini-agent-booster`.
-- **Vector DB & Hybrid Search**: Delegate pgvector indexing and hybrid search tuning to `vector-db-rag-expert`.
-- **Token Budget & FinOps**: Delegate API cost optimization and prompt caching strategies to `ai-cost-token-optimizer`.
-
----
-
-<a name="bahasa-indonesia"></a>
-## Bahasa Indonesia
-
-### Deskripsi
-Panduan tingkat produksi untuk mengintegrasikan AI, Model Context Protocol (MCP), dan LLM ke dalam aplikasi modern. Mencakup pipeline RAG, streaming token real-time, eksekusi tool agen AI, arsitektur memori, prompt caching, dan orkestrasi multi-model.
-
-### Kondisi Pemicu
-- Mengintegrasikan model frontier: GPT-4.1 / GPT-5, Claude 4 Sonnet/Opus, Gemini 3.1 Pro/Flash, atau model open-source (Llama 4, DeepSeek-V3/R2).
-- Mengimplementasikan server/klien MCP (v1.9+ dengan Streamable HTTP transport).
-- Membangun chatbot AI, copilot, atau alur kerja agen otonom (OpenAI Agents SDK, Google ADK, LangGraph, Mastra.ai).
-- Membangun sistem **memori agentik** (jangka pendek, jangka panjang, episodik) menggunakan Mem0 atau pgvector.
-- Mengimplementasikan RAG dengan vector database.
-- Merancang agen AI dengan tool-calling, Computer Use, atau code interpreter.
-
-### Panduan Arsitektur Inti
-
-#### 1. Integrasi MCP (v1.9+)
-Standarisasi interaksi agen-tool menggunakan MCP. Standar 2026 menambahkan **Streamable HTTP transport** — transport default baru untuk MCP server yang di-host di cloud, mendukung streaming dua arah tanpa long-polling.
-
-#### 2. Ekosistem Agents SDK (2026)
-- **OpenAI Agents SDK**: Handoffs, guardrails, dan tracing bawaan untuk agen berbasis GPT-5.
-- **Google ADK**: Multi-agen, streaming, integrasi Vertex AI untuk agen Gemini.
-- **LangGraph**: Alur kerja stateful berbasis graph dengan dukungan human-in-the-loop.
-- **Mastra.ai**: Framework TypeScript-first dengan memori, evaluasi, dan RAG bawaan.
-- **Vercel AI SDK 5.x**: Streaming UI + agen dengan dukungan multi-provider dan RSC.
-
-#### 3. Arsitektur Memori Agentik
-- **Jangka Pendek**: Riwayat percakapan recent dalam context window.
-- **Jangka Panjang (Vector Store)**: Preferensi dan interaksi masa lalu sebagai embedding di pgvector atau Qdrant.
-- **Episodik**: Gunakan Mem0 atau MemGPT untuk recall mirip manusia — otomatis merangkum dan mengindeks interaksi lalu.
-- **Terstruktur (Knowledge Graph)**: Gunakan graph DB (Neo4j, Kuzu) untuk relasi entitas dan memori faktual.
-
-#### 4. Pipeline RAG Lanjutan
-1. Chunking dokumen (500-1000 token, 10% overlap).
-2. Embedding dengan `text-embedding-3-large` atau `gemini-embedding-004`.
-3. Penyimpanan & pencarian hibrida: pgvector (HNSW) + BM25.
-4. Reranking dengan Cohere Rerank 3 atau FlashRank.
-5. Injeksi konteks terbaik ke system prompt.
-
-#### 5. Prompt Caching (Optimasi Biaya)
-Kurangi biaya 80-90% dengan caching prompt panjang:
-- **Anthropic**: Caching otomatis untuk prompt > 1024 token.
-- **OpenAI**: Prefix caching otomatis di GPT-4o ke atas.
-- **Google**: Context caching di Gemini API via `cachedContent`.
-
-#### 6. Streaming & Vercel AI SDK 5.x
-Gunakan `useChat` / `useCompletion` untuk zero perceived latency di sisi klien. Gunakan `streamUI` di AI SDK 5.x untuk stream komponen React dari server (agent-rendered UI).
-
-#### 7. Computer Use & Browser Agents
-Claude 4 dapat mengambil screenshot dan mengontrol mouse/keyboard. Gunakan **Browser-Use** atau **Playwright MCP Server** untuk memberi agen kontrol atas browser.
-
-#### 8. Output Terstruktur & Tool Calling
-Gunakan mode structured output (bukan prompt engineering) untuk jaminan kesesuaian skema JSON. Gunakan Zod (`zodResponseFormat`) untuk validasi type-safe.
-
-#### 9. Manajemen Biaya
-- Pantau konsumsi token per sesi di tabel telemetri.
-- Terapkan semantic caching dengan Redis + vektor.
-- Gunakan Batch API (OpenAI / Anthropic) untuk workload async volume tinggi dengan biaya 50% lebih hemat.
-
-#### 10. Orkestrasi Skill & Serah Terima
-- **Orkestrator Utama**: Dieksekusi pada **Fase 4** dari `zero-to-prod-orchestrator` atau setelah finalisasi arsitektur AI di `brainstorming`.
-- **Arsitektur MCP Server**: Delegasikan pembuatan MCP server ke `mcp-server-architect` dan integrasi pembayaran ke `doku-mcp-server`.
-- **Multi-Agent & Swarm Workflows**: Delegasikan alur state graph kompleks ke `multi-agent-orchestration` dan optimasi long-context Gemini ke `gemini-agent-booster`.
-- **Vector DB & Hybrid Search**: Delegasikan indeks pgvector dan pencarian hibrida ke `vector-db-rag-expert`.
-- **Token Budget & FinOps**: Delegasikan optimasi biaya API dan caching prompt ke `ai-cost-token-optimizer`.
-
+---
+name: ai-llm-integration-expert
+version: "2.8.0"
+description: "Expert guide for integrating Large Language Models (LLMs), Model Context Protocol (MCP v1.x), hybrid reasoning models, RAG architecture, vector databases, and AI agents / Panduan ahli untuk integrasi LLM, Model Context Protocol (MCP), model hybrid reasoning, arsitektur RAG, vector database, dan agen AI."
+author: "Roedy Rustam"
+---
+
+# AI & LLM Integration Expert (2026 Edition)
+
+[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
+
+---
+
+<a name="english"></a>
+## English
+
+### Description
+Production-grade guidelines for integrating AI, Model Context Protocol (MCP), hybrid reasoning models, and Large Language Models (LLMs) into modern software architectures. Covers hybrid reasoning token streaming, Streamable HTTP MCP transports, agentic memory architectures, native context caching, RAG pipelines, and multi-model orchestration.
+
+### Trigger Conditions
+- Integrating frontier reasoning models: Anthropic Claude 3.7 Sonnet (Hybrid/Extended Thinking), Google Gemini 3.8 Flash / 3.1 Pro (Thinking Mode), OpenAI o1 / o3 / o3-mini / GPT-4.5 / GPT-4o, DeepSeek-R1 / V3, or open-source weights (Llama 4, Qwen 2.5/3 Coder).
+- Implementing Model Context Protocol (MCP) server or client integrations with Streamable HTTP transport or MCP Sampling.
+- Building AI chatbots, copilots, or autonomous AI agent workflows (LangGraph, OpenAI Agents SDK, Google ADK, Mastra.ai, Vercel AI SDK 5.x/6.x).
+- Managing streaming reasoning tokens (`<think>` chunks) separately from final output in user interfaces.
+- Implementing hybrid RAG with vector databases (Supabase pgvector HNSW, Qdrant, Pinecone) and cross-encoder rerankers.
+- Building agentic memory systems (short-term, long-term semantic, episodic) using Mem0 or vector stores.
+- Implementing cost optimization with provider-native Context Caching (Gemini `cachedContent`, Anthropic ephemeral prompt cache, OpenAI prefix cache).
+
+### Model Capability Matrix (2026)
+
+| Provider | Model | Context | Reasoning Type | Primary Strength |
+|---|---|---|---|---|
+| Anthropic | Claude 3.7 Sonnet | 200K | Hybrid Thinking (Standard + Extended) | Code generation, complex reasoning, Computer Use |
+| Anthropic | Claude 3.5 / 4 Opus | 200K | Deep Deliberation | Deep architectural synthesis, policy analysis |
+| Google | Gemini 3.8 Flash | 1M–2M | Flash Thinking (Configurable Budget) | Ultra-low latency, multimodal live, high-frequency loops |
+| Google | Gemini 3.1 / 3.5 Pro | 2M | Extended Reasoning | Needle-in-a-haystack, long-context repos, deep research |
+| OpenAI | o3 / o3-mini | 200K | Native Test-Time Reasoning | Math, competitive coding, formal logic verification |
+| OpenAI | GPT-4.5 / GPT-4o | 128K | Direct Instruction & Fast Tooling | Low-latency voice, structured JSON, tool-calling |
+| DeepSeek | DeepSeek-R1 | 128K | Open Reasoning (Distill & MoE) | State-of-the-art open weights reasoning, math, coding |
+| DeepSeek | DeepSeek-V3 | 128K | General Multimodal / Text | High throughput, extremely cost-efficient coding |
+| Qwen | Qwen 2.5 / 3 Coder | 128K | Open Source Code Specialist | Self-hosted coding agent, local copilot integration |
+
+### Core Architecture Guidelines
+
+#### 1. Hybrid Reasoning & Streaming Token Handling
+Modern frontier models emit internal thinking/reasoning tokens during test-time compute:
+- **Thinking Token Separation**: Separate internal `<think>` or reasoning chunks from conversational output. Stream reasoning into collapsible UI accordion blocks while presenting clean output to the user.
+- **Vercel AI SDK 5.x/6.x Integration**:
+  ```typescript
+  import { streamText } from 'ai';
+  import { anthropic } from '@ai-sdk/anthropic';
+
+  const result = streamText({
+    model: anthropic('claude-3-7-sonnet-20250219'),
+    providerOptions: {
+      anthropic: {
+        thinking: { type: 'enabled', budgetTokens: 4096 },
+      },
+    },
+    prompt: 'Refactor this distributed consensus engine...',
+  });
+
+  // Access reasoning stream alongside main text
+  for await (const part of result.fullStream) {
+    if (part.type === 'reasoning') {
+      process.stdout.write(`[Thinking]: ${part.textDelta}`);
+    } else if (part.type === 'text-delta') {
+      process.stdout.write(part.textDelta);
+    }
+  }
+  ```
+
+#### 2. Model Context Protocol (MCP) — Streamable HTTP & Sampling
+Standardize all agent-tool and agent-host communications using MCP specifications:
+- **Streamable HTTP Transport**: Modern cloud deployments use Streamable HTTP (bidirectional JSON-RPC streaming over HTTP POST/SSE hybrid) instead of fragile stdio connections.
+- **MCP Sampling**: Allow MCP servers to request LLM completions back from the host client, enabling nested agentic tools without distributing API keys to tool servers.
+- **Authorization & Security**: Enforce OAuth 2.1 scoped bearer tokens on remote MCP endpoints. Validate all incoming tool inputs using strict Zod schemas.
+
+#### 3. Agentic Memory Architecture
+Production AI agents require multi-layered memory:
+- **In-Context Working Memory**: Pass recent turn messages within the prompt window.
+- **Long-Term Semantic Memory**: Embed user preferences and facts using pgvector (HNSW index) or Qdrant; perform cosine similarity searches.
+- **Episodic Memory (Mem0 / MemGPT)**: Automatically synthesize session checkpoints and index past user decisions for human-like recall.
+- **Knowledge Graph Memory**: Maintain structured entity-relationship triples (using Graph DB or relational junction tables) for multi-hop relationship retrieval.
+
+#### 4. Advanced RAG & Late Chunking Pipeline
+Build high-precision RAG pipelines:
+1. **Document Ingestion**: Chunk semantically (500–1000 tokens) with 10% overlap, or apply *Late Chunking* (chunking after full document contextual embedding).
+2. **Embeddings**: Utilize `text-embedding-3-large`, `gemini-embedding-004`, or local `bge-large-en-v1.5`.
+3. **Hybrid Search**: Combine dense vector cosine similarity with sparse BM25 / PostgreSQL `tsvector` queries.
+4. **Cross-Encoder Reranking**: Reorder top-K candidates using Cohere Rerank 3 or FlashRank before feeding into the prompt.
+5. **Context Window vs RAG Decision**: If document sets fit comfortably under 200k tokens and are queried repeatedly, prefer **Native Context Caching** over RAG chunking to eliminate retrieval boundary errors.
+
+#### 5. FinOps, Context Caching & Dynamic Model Routing
+- **Native Context Caching**: Store static system prompts or large codebases in cache (>32k tokens) to reduce costs by up to 90% (Anthropic ephemeral cache, OpenAI prefix cache, Gemini `cachedContent`).
+- **Dynamic Model Router**: Route queries based on complexity scoring (prompt length, required schema, reasoning requirements):
+  ```typescript
+  export function selectOptimalModel(promptLength: number, taskType: 'classification' | 'reasoning' | 'summary') {
+    if (taskType === 'classification' || promptLength < 500) {
+      return 'gemini-3.8-flash'; // High speed, minimal cost
+    }
+    return 'gemini-3.1-pro'; // Deep reasoning
+  }
+  ```
+- **Semantic Caching**: Hash query vector embeddings into Redis / vector DB to return cached completions for semantically identical questions before calling LLM APIs.
+- **Tenant Token Quotas**: Implement per-tenant token budgeting and alert thresholds to prevent cost overruns.
+
+#### 6. Structured Output & Guardrails
+- Utilize native Structured Outputs (`response_format: { type: "json_schema" }`) guaranteed by model token-level grammar masks.
+- Use Zod schemas to define tool parameters and final structured entities.
+- Implement rate limiting, circuit breakers, and semantic caching (Redis / Upstash vector cache) to prevent runaway recursive tool loops.
 
 ## Orchestration & Integration
-- Integrates with ai-cost-token-optimizer, multi-agent-orchestration, and vector-db-rag-expert.
+- **`mcp-server-architect`**: Delegate custom MCP server implementation, client consumption, schema definitions, and transport adapters.
+- **`multi-agent-orchestration`**: Delegate complex multi-agent state graphs, swarm workflows, and supervisor patterns.
+- **`gemini-agent-booster`**: Delegate Gemini 3.x long-context optimization, Multimodal Live API, and thinking budget controls.
+- **`ai-prompt-engineering-expert`**: Delegate advanced prompt design, few-shot calibration, automated Promptfoo evals, and system prompt testing.
+- **`vector-db-rag-expert`**: Delegate pgvector HNSW indexing and hybrid retrieval fine-tuning.
+- **`zero-to-prod-orchestrator`**: Executes this skill during Phase 4 architecture and implementation.
+
+---
+
+<a name="bahasa-indonesia"></a>
+## Bahasa Indonesia
+
+### Deskripsi
+Panduan tingkat produksi untuk mengintegrasikan AI, Model Context Protocol (MCP), model hybrid reasoning, dan Large Language Models (LLM) ke dalam arsitektur perangkat lunak modern. Mencakup penanganan streaming token penalaran, transport MCP Streamable HTTP, arsitektur memori agentik, context caching native, pipeline RAG, dan orkestrasi multi-model.
+
+### Kondisi Pemicu
+- Mengintegrasikan model frontier reasoning: Anthropic Claude 3.7 Sonnet (Hybrid/Extended Thinking), Google Gemini 3.8 Flash / 3.1 Pro (Thinking Mode), OpenAI o1 / o3 / o3-mini / GPT-4.5 / GPT-4o, DeepSeek-R1 / V3, atau bobot open-source (Llama 4, Qwen 2.5/3 Coder).
+- Mengimplementasikan server atau klien Model Context Protocol (MCP) dengan transport Streamable HTTP atau MCP Sampling.
+- Membangun chatbot AI, copilot, atau workflow agen otonom (LangGraph, OpenAI Agents SDK, Google ADK, Mastra.ai, Vercel AI SDK 5.x/6.x).
+- Mengelola streaming token penalaran (`<think>`) secara terpisah dari output akhir pada tampilan antarmuka pengguna.
+- Mengimplementasikan RAG hibrida dengan database vektor (Supabase pgvector HNSW, Qdrant, Pinecone) dan reranker cross-encoder.
+- Membangun sistem memori agentik (jangka pendek, semantik jangka panjang, episodik) menggunakan Mem0 atau vector store.
+- Menerapkan optimasi biaya dengan Context Caching native provider (Gemini `cachedContent`, Anthropic ephemeral prompt cache, OpenAI prefix cache).
+
+### Matriks Kapabilitas Model (2026)
+
+| Provider | Model | Konteks | Tipe Penalaran | Keunggulan Utama |
+|---|---|---|---|---|
+| Anthropic | Claude 3.7 Sonnet | 200K | Hybrid Thinking (Standar + Diperpanjang) | Generasi kode, penalaran kompleks, Computer Use |
+| Anthropic | Claude 3.5 / 4 Opus | 200K | Deliberasi Mendalam | Sintesis arsitektur mendalam, analisis kebijakan |
+| Google | Gemini 3.8 Flash | 1M–2M | Flash Thinking (Budget Terkonfigurasi) | Latensi ultra-rendah, multimodal live, loop cepat |
+| Google | Gemini 3.1 / 3.5 Pro | 2M | Extended Reasoning | Needle-in-a-haystack, repo konteks panjang, riset |
+| OpenAI | o3 / o3-mini | 200K | Test-Time Reasoning Native | Matematika, competitive coding, verifikasi logika |
+| OpenAI | GPT-4.5 / GPT-4o | 128K | Instruksi Langsung & Tooling Cepat | Suara latensi rendah, JSON terstruktur, tool calling |
+| DeepSeek | DeepSeek-R1 | 128K | Open Reasoning (Distill & MoE) | Penalaran open weights terdepan, matematika, koding |
+| DeepSeek | DeepSeek-V3 | 128K | Teks & Multimodal Umum | Throughput tinggi, sangat hemat biaya untuk coding |
+| Qwen | Qwen 2.5 / 3 Coder | 128K | Spesialis Kode Open Source | Agen coding mandiri / self-hosted, copilot lokal |
+
+### Panduan Arsitektur Inti
+
+#### 1. Hybrid Reasoning & Penanganan Token Streaming
+Model frontier modern menghasilkan token pemikiran (*thinking tokens*) selama proses penalaran:
+- **Pemisahan Token Pemikiran**: Pisahkan blok `<think>` dari output teks akhir. Alirkan proses pemikiran ke dalam accordion UI yang dapat dibuka/tutup, sementara output utama disajikan dengan bersih kepada user.
+- **Integrasi Vercel AI SDK 5.x/6.x**: Gunakan event listener `reasoning` pada stream untuk menangkap proses pemikiran model secara terpisah dari `text-delta`.
+
+#### 2. Model Context Protocol (MCP) — Streamable HTTP & Sampling
+Standarisasi seluruh komunikasi agen-ke-tool dan agen-ke-host menggunakan spesifikasi MCP:
+- **Streamable HTTP Transport**: Standar cloud modern yang mendukung streaming dua arah JSON-RPC via HTTP POST/SSE hybrid tanpa ketergantungan koneksi stdio lokal.
+- **MCP Sampling**: Memberikan izin kepada server MCP untuk meminta inferensi LLM kembali ke klien host, memungkinkan alat agentik modular tanpa membagikan API key sensitif.
+- **Keamanan & Otorisasi**: Wajibkan bearer token berbasis OAuth 2.1 pada endpoint MCP publik dan validasi skema input dengan Zod.
+
+#### 3. Arsitektur Memori Agentik
+- **Memori Kerja In-Context**: Teruskan histori interaksi terbaru di jendela konteks.
+- **Memori Semantik Jangka Panjang**: Simpan fakta dan preferensi pengguna di pgvector (indeks HNSW) atau Qdrant dengan pencarian kesamaan kosinus.
+- **Memori Episodik (Mem0 / MemGPT)**: Sintesiskan ringkasan sesi secara berkala agar agen memiliki daya ingat historis jangka panjang.
+- **Memori Graph Pengetahuan**: Hubungkan entitas relasional dalam basis data graf untuk kueri multi-langkah (*multi-hop reasoning*).
+
+#### 4. Pipeline RAG Lanjutan & Late Chunking
+1. **Ingesti Dokumen**: Bagi dokumen secara semantik (500–1000 token, 10% overlap) atau gunakan metode *Late Chunking*.
+2. **Embedding**: Gunakan `text-embedding-3-large` atau `gemini-embedding-004`.
+3. **Pencarian Hibrida**: Kombinasikan dense vector cosine similarity dengan sparse keyword BM25 / PostgreSQL full-text search.
+4. **Cross-Encoder Reranking**: Susun ulang kandidat terbaik menggunakan Cohere Rerank 3 atau FlashRank sebelum diteruskan ke system prompt.
+5. **Keputusan Cache vs RAG**: Jika dokumen stabil dan berada di bawah 200k token, utamakan **Context Caching Native** daripada RAG chunking untuk menghindari hilangnya konteks di perbatasan potongan teks.
+
+#### 5. FinOps, Context Caching & Routing Model Dinamis
+- **Context Caching Native**: Simpan prompt sistem atau repositori besar di cache (>32k token) via API `cachedContent` Gemini, ephemeral cache Anthropic, atau prefix cache OpenAI untuk menghemat hingga 90% biaya.
+- **Router Model Dinamis**: Arahkan kueri secara cerdas (tugas klasifikasi/parsing ke Flash, penalaran mendalam ke Pro/Opus).
+- **Semantic Caching**: Simpan embedding kueri di Redis / Vector DB untuk menyajikan jawaban cache pada pertanyaan identik tanpa memanggil ulang API LLM.
+- **Kuota & Anggaran Token**: Terapkan batas konsumsi token harian per pengguna/penyewa guna mencegah pembengkakan biaya.
+
+#### 6. Output Terstruktur & Guardrails
+- Manfaatkan mode Structured Outputs native model dengan skema Zod untuk menjamin integritas JSON.
+- Terapkan rate limiting, circuit breaker, dan semantic caching (Redis / Upstash) untuk mencegah pemanggilan tool secara rekursif tak berujung.
+
+## Integrasi Orkestrasi
+- **`mcp-server-architect`**: Delegasikan pembuatan server MCP kustom, konsumsi klien, definisi skema, dan transport adapter.
+- **`multi-agent-orchestration`**: Delegasikan alur kerja graph multi-agen, topologi swarm, dan pattern supervisor.
+- **`gemini-agent-booster`**: Delegasikan optimasi long-context Gemini 3.x, Multimodal Live API, dan kontrol thinking budget.
+- **`ai-prompt-engineering-expert`**: Delegasikan desain prompt lanjutan, kalibrasi few-shot, evaluasi Promptfoo, dan pengujian prompt.
+- **`vector-db-rag-expert`**: Delegasikan tuning indeks HNSW pgvector dan pencarian hibrida.
+- **`zero-to-prod-orchestrator`**: Mengeksekusi skill ini pada Fase 4 perancangan arsitektur dan implementasi.