@polymorphism-tech/morph-spec 4.8.19 → 4.9.0

package/framework/standards/STANDARDS.json

@@ -10,7 +10,13 @@
       "tags": [
         "ai-agents"
       ],
-      "aliases": ["Blazor AI", "AI chat UI", "streaming Blazor", "agent UI", "chat component"],
+      "aliases": [
+        "Blazor AI",
+        "AI chat UI",
+        "streaming Blazor",
+        "agent UI",
+        "chat component"
+      ],
       "anchors": {
         "streaming": "#streaming-responses",
         "state": "#ui-state-management",
@@ -27,7 +33,13 @@
       "tags": [
         "ai-agents"
       ],
-      "aliases": ["AI production", "agent reliability", "production AI", "agent safety", "autonomous systems"],
+      "aliases": [
+        "AI production",
+        "agent reliability",
+        "production AI",
+        "agent safety",
+        "autonomous systems"
+      ],
       "anchors": {
         "reliability": "#reliability-patterns",
         "safety": "#safety-guardrails",
@@ -44,7 +56,13 @@
       "tags": [
         "ai-agents"
       ],
-      "aliases": ["AI agent setup", "MCP configuration", "tool configuration", "Claude setup", "agent initialization"],
+      "aliases": [
+        "AI agent setup",
+        "MCP configuration",
+        "tool configuration",
+        "Claude setup",
+        "agent initialization"
+      ],
       "anchors": {
         "mcp": "#mcp-configuration",
         "tools": "#tool-definitions",
@@ -61,7 +79,12 @@
       "tags": [
         "ai-agents"
       ],
-      "aliases": ["team orchestration", "agent team", "multi-agent coordination", "squad dispatch"],
+      "aliases": [
+        "team orchestration",
+        "agent team",
+        "multi-agent coordination",
+        "squad dispatch"
+      ],
       "anchors": {
         "patterns": "#orchestration-patterns",
         "communication": "#inter-agent-communication"
@@ -77,7 +100,13 @@
       "tags": [
         "ai-agents"
       ],
-      "aliases": ["agent workflow", "multi-agent", "orchestration pattern", "agent chain", "parallel agents"],
+      "aliases": [
+        "agent workflow",
+        "multi-agent",
+        "orchestration pattern",
+        "agent chain",
+        "parallel agents"
+      ],
       "anchors": {
         "orchestration": "#orchestration-patterns",
         "parallel": "#parallel-execution",
@@ -95,7 +124,12 @@
         "architecture",
         "ddd"
       ],
-      "aliases": ["aggregate root", "DDD aggregate", "domain aggregate", "aggregate pattern"],
+      "aliases": [
+        "aggregate root",
+        "DDD aggregate",
+        "domain aggregate",
+        "aggregate pattern"
+      ],
       "anchors": {
         "root": "#aggregate-root-design",
         "invariants": "#enforcing-invariants",
@@ -113,7 +147,13 @@
         "architecture",
         "ddd"
       ],
-      "aliases": ["bounded context", "BC", "context map", "integration events", "domain boundary"],
+      "aliases": [
+        "bounded context",
+        "BC",
+        "context map",
+        "integration events",
+        "domain boundary"
+      ],
       "anchors": {
         "context-map": "#context-map",
         "integration": "#integration-events",
@@ -131,7 +171,13 @@
         "architecture",
         "ddd"
       ],
-      "aliases": ["DDD level", "domain complexity", "CRUD vs DDD", "complexity decision tree", "domain model level"],
+      "aliases": [
+        "DDD level",
+        "domain complexity",
+        "CRUD vs DDD",
+        "complexity decision tree",
+        "domain model level"
+      ],
       "anchors": {
         "decision-tree": "#decision-tree",
         "level1": "#level-1-crud",
@@ -150,7 +196,13 @@
         "architecture",
         "ddd"
       ],
-      "aliases": ["DDD entity", "domain entity", "entity class", "entity ID", "entity lifecycle"],
+      "aliases": [
+        "DDD entity",
+        "domain entity",
+        "entity class",
+        "entity ID",
+        "entity lifecycle"
+      ],
       "anchors": {
         "identity": "#entity-identity",
         "lifecycle": "#entity-lifecycle"
@@ -167,7 +219,12 @@
         "architecture",
         "ddd"
       ],
-      "aliases": ["ubiquitous language", "domain language", "shared vocabulary", "domain glossary"],
+      "aliases": [
+        "ubiquitous language",
+        "domain language",
+        "shared vocabulary",
+        "domain glossary"
+      ],
       "anchors": {
         "glossary": "#domain-glossary",
         "naming": "#naming-from-domain"
@@ -184,7 +241,13 @@
         "architecture",
         "ddd"
       ],
-      "aliases": ["value object", "VO", "immutable value", "domain value type", "strongly typed"],
+      "aliases": [
+        "value object",
+        "VO",
+        "immutable value",
+        "domain value type",
+        "strongly typed"
+      ],
       "anchors": {
         "equality": "#equality-by-value",
         "validation": "#value-object-validation",
@@ -202,7 +265,13 @@
         "architecture",
         "vertical-slice"
       ],
-      "aliases": ["vertical slice", "VSA", "slice architecture", "feature slice", "CQRS slice"],
+      "aliases": [
+        "vertical slice",
+        "VSA",
+        "slice architecture",
+        "feature slice",
+        "CQRS slice"
+      ],
       "anchors": {
         "structure": "#slice-structure",
         "rules": "#slice-rules",
@@ -220,7 +289,13 @@
         "backend",
         "api"
       ],
-      "aliases": ["minimal api", "minimal APIs", ".NET minimal API", "route handler", "MapGet"],
+      "aliases": [
+        "minimal api",
+        "minimal APIs",
+        ".NET minimal API",
+        "route handler",
+        "MapGet"
+      ],
       "anchors": {
         "endpoints": "#endpoint-registration",
         "grouping": "#route-groups"
@@ -237,7 +312,13 @@
         "backend",
         "api"
       ],
-      "aliases": ["REST API", "RESTful", "HTTP API", "resource API", "HTTP methods"],
+      "aliases": [
+        "REST API",
+        "RESTful",
+        "HTTP API",
+        "resource API",
+        "HTTP methods"
+      ],
       "anchors": {
         "resources": "#resource-design",
         "errors": "#error-responses"
@@ -254,7 +335,13 @@
         "backend",
         "api"
       ],
-      "aliases": ["FluentValidation", "input validation", "request validation", "API validation", "model validation"],
+      "aliases": [
+        "FluentValidation",
+        "input validation",
+        "request validation",
+        "API validation",
+        "model validation"
+      ],
       "anchors": {
         "fluent": "#fluentvalidation-setup",
         "rules": "#validation-rules"
@@ -271,7 +358,13 @@
         "backend",
         "authentication"
       ],
-      "aliases": ["passkeys", "WebAuthn", "FIDO2", "passwordless", "biometric auth"],
+      "aliases": [
+        "passkeys",
+        "WebAuthn",
+        "FIDO2",
+        "passwordless",
+        "biometric auth"
+      ],
       "anchors": {
         "registration": "#passkey-registration",
         "authentication": "#passkey-authentication"
@@ -288,7 +381,13 @@
         "backend",
         "database"
       ],
-      "aliases": ["Entity Framework", "EF Core", "DbContext", "LINQ queries", "ORM"],
+      "aliases": [
+        "Entity Framework",
+        "EF Core",
+        "DbContext",
+        "LINQ queries",
+        "ORM"
+      ],
       "anchors": {
         "dbcontext": "#dbcontext-patterns",
         "queries": "#query-optimization",
@@ -306,7 +405,13 @@
         "backend",
         "database"
       ],
-      "aliases": ["EF migrations", "database migration", "schema migration", "dotnet ef", "Add-Migration"],
+      "aliases": [
+        "EF migrations",
+        "database migration",
+        "schema migration",
+        "dotnet ef",
+        "Add-Migration"
+      ],
       "anchors": {
         "workflow": "#migration-workflow",
         "production": "#production-migrations"
@@ -324,7 +429,13 @@
         "database",
         "postgresql"
       ],
-      "aliases": ["PostgreSQL", "postgres", "pg", "database design", "SQL schema"],
+      "aliases": [
+        "PostgreSQL",
+        "postgres",
+        "pg",
+        "database design",
+        "SQL schema"
+      ],
       "anchors": {
         "schema": "#schema-design",
         "indexes": "#index-strategy"
@@ -341,7 +452,13 @@
         "backend",
         "database"
       ],
-      "aliases": ["repository", "IRepository", "Unit of Work", "data access", "repository pattern"],
+      "aliases": [
+        "repository",
+        "IRepository",
+        "Unit of Work",
+        "data access",
+        "repository pattern"
+      ],
       "anchors": {
         "pattern": "#repository-pattern",
         "uow": "#unit-of-work"
@@ -358,7 +475,13 @@
         "backend",
         "database"
       ],
-      "aliases": ["vector search", "RAG", "embeddings", "pgvector", "semantic search"],
+      "aliases": [
+        "vector search",
+        "RAG",
+        "embeddings",
+        "pgvector",
+        "semantic search"
+      ],
       "anchors": {
         "chunking": "#chunking-strategy",
         "retrieval": "#retrieval-patterns"
@@ -375,7 +498,13 @@
         "backend",
         "dotnet"
       ],
-      "aliases": ["async/await", "Task<T>", "CancellationToken", "ValueTask", "async programming"],
+      "aliases": [
+        "async/await",
+        "Task<T>",
+        "CancellationToken",
+        "ValueTask",
+        "async programming"
+      ],
       "anchors": {
         "cancellation": "#cancellation-token-pattern",
         "parallel": "#parallel-execution-patterns"
@@ -392,7 +521,13 @@
         "backend",
         "dotnet"
       ],
-      "aliases": [".NET core", "dotnet core", "C# patterns", "backend core", "dotnet standards"],
+      "aliases": [
+        ".NET core",
+        "dotnet core",
+        "C# patterns",
+        "backend core",
+        "dotnet standards"
+      ],
       "anchors": {
         "di": "#dependency-injection",
         "services": "#service-registration",
@@ -410,7 +545,13 @@
         "backend",
         "dotnet"
       ],
-      "aliases": ["dependency injection", "IoC", "DI container", "service registration", "inversion of control"],
+      "aliases": [
+        "dependency injection",
+        "IoC",
+        "DI container",
+        "service registration",
+        "inversion of control"
+      ],
       "anchors": {
         "patterns": "#di-patterns",
         "anti-patterns": "#di-anti-patterns"
@@ -427,7 +568,13 @@
         "backend",
         "dotnet"
       ],
-      "aliases": ["program.cs", "startup configuration", "NuGet packages", "package setup", "app bootstrap"],
+      "aliases": [
+        "program.cs",
+        "startup configuration",
+        "NuGet packages",
+        "package setup",
+        "app bootstrap"
+      ],
       "anchors": {
         "nuget": "#nuget-packages",
         "middleware": "#middleware-order"
@@ -445,7 +592,13 @@
         "integrations",
         "asaas"
       ],
-      "aliases": ["asaas", "payment", "PIX", "boleto", "Brazilian payment"],
+      "aliases": [
+        "asaas",
+        "payment",
+        "PIX",
+        "boleto",
+        "Brazilian payment"
+      ],
       "anchors": {
         "payments": "#payment-types",
         "webhooks": "#webhook-handling"
@@ -463,7 +616,13 @@
         "integrations",
         "clerk"
       ],
-      "aliases": ["clerk", "authentication", "OAuth", "JWT", "session management"],
+      "aliases": [
+        "clerk",
+        "authentication",
+        "OAuth",
+        "JWT",
+        "session management"
+      ],
       "anchors": {
         "setup": "#clerk-setup",
         "middleware": "#auth-middleware"
@@ -481,7 +640,14 @@
         "integrations",
         "hangfire"
       ],
-      "aliases": ["hangfire", "background jobs", "scheduled jobs", "recurring", "cron", "fire and forget"],
+      "aliases": [
+        "hangfire",
+        "background jobs",
+        "scheduled jobs",
+        "recurring",
+        "cron",
+        "fire and forget"
+      ],
       "anchors": {
         "jobs": "#job-types",
         "retry": "#retry-policies"
@@ -499,7 +665,13 @@
         "integrations",
         "resend"
       ],
-      "aliases": ["resend", "email", "transactional email", "SMTP", "email notification"],
+      "aliases": [
+        "resend",
+        "email",
+        "transactional email",
+        "SMTP",
+        "email notification"
+      ],
       "anchors": {
         "sending": "#send-email",
         "templates": "#email-templates"
@@ -515,7 +687,13 @@
       "tags": [
         "context"
       ],
-      "aliases": ["analytics", "GTM", "GA4", "event tracking", "data layer"],
+      "aliases": [
+        "analytics",
+        "GTM",
+        "GA4",
+        "event tracking",
+        "data layer"
+      ],
       "anchors": {
         "events": "#event-tracking",
         "setup": "#analytics-setup"
@@ -531,7 +709,12 @@
       "tags": [
         "context"
       ],
-      "aliases": ["context bundles", "bundled context", "spec bundles", "feature bundles"],
+      "aliases": [
+        "context bundles",
+        "bundled context",
+        "spec bundles",
+        "feature bundles"
+      ],
       "anchors": {
         "structure": "#bundle-structure",
         "loading": "#context-loading"
@@ -547,7 +730,12 @@
       "tags": [
         "context"
       ],
-      "aliases": ["context priming", "agent priming", "system prompt", "context injection"],
+      "aliases": [
+        "context priming",
+        "agent priming",
+        "system prompt",
+        "context injection"
+      ],
       "anchors": {
         "patterns": "#priming-patterns",
         "efficiency": "#context-efficiency"
@@ -563,7 +751,13 @@
       "tags": [
         "core"
       ],
-      "aliases": ["architecture", "clean architecture", "layered architecture", "SOLID", "design principles"],
+      "aliases": [
+        "architecture",
+        "clean architecture",
+        "layered architecture",
+        "SOLID",
+        "design principles"
+      ],
       "anchors": {
         "layers": "#layer-boundaries",
         "patterns": "#architectural-patterns"
@@ -579,7 +773,13 @@
       "tags": [
         "core"
       ],
-      "aliases": ["coding standards", "code style", "clean code", "naming conventions", "code quality"],
+      "aliases": [
+        "coding standards",
+        "code style",
+        "clean code",
+        "naming conventions",
+        "code quality"
+      ],
       "anchors": {
         "naming": "#naming-conventions",
         "patterns": "#code-patterns"
@@ -595,7 +795,13 @@
       "tags": [
         "core"
       ],
-      "aliases": ["git flow", "branch strategy", "feature branch", "gitflow", "branch naming"],
+      "aliases": [
+        "git flow",
+        "branch strategy",
+        "feature branch",
+        "gitflow",
+        "branch naming"
+      ],
       "anchors": {
         "branching": "#branch-naming",
         "workflow": "#git-workflow"
@@ -611,7 +817,13 @@
       "tags": [
         "core"
       ],
-      "aliases": ["git", "commit messages", "conventional commits", "changelog", "git hooks"],
+      "aliases": [
+        "git",
+        "commit messages",
+        "conventional commits",
+        "changelog",
+        "git hooks"
+      ],
       "anchors": {
         "commits": "#commit-format",
         "hooks": "#pre-commit-hooks"
@@ -627,7 +839,14 @@
       "tags": [
         "core"
       ],
-      "aliases": ["testing", "unit tests", "integration tests", "TDD", "test coverage", "xUnit"],
+      "aliases": [
+        "testing",
+        "unit tests",
+        "integration tests",
+        "TDD",
+        "test coverage",
+        "xUnit"
+      ],
       "anchors": {
         "patterns": "#test-patterns",
         "coverage": "#coverage-requirements"
@@ -644,7 +863,13 @@
         "data",
         "nosql"
       ],
-      "aliases": ["blob storage", "Azure Storage", "file storage", "BlobServiceClient", "object storage"],
+      "aliases": [
+        "blob storage",
+        "Azure Storage",
+        "file storage",
+        "BlobServiceClient",
+        "object storage"
+      ],
       "anchors": {
         "upload": "#upload-patterns",
         "access": "#sas-tokens"
@@ -662,7 +887,14 @@
         "nosql",
         "cache"
       ],
-      "aliases": ["redis", "cache", "distributed cache", "IDistributedCache", "cache-aside", "StackExchange.Redis"],
+      "aliases": [
+        "redis",
+        "cache",
+        "distributed cache",
+        "IDistributedCache",
+        "cache-aside",
+        "StackExchange.Redis"
+      ],
       "anchors": {
         "patterns": "#cache-patterns",
         "invalidation": "#cache-invalidation"
@@ -679,7 +911,13 @@
         "data",
         "nosql"
       ],
-      "aliases": ["cosmos", "CosmosDB", "document database", "partition key", "RUs"],
+      "aliases": [
+        "cosmos",
+        "CosmosDB",
+        "document database",
+        "partition key",
+        "RUs"
+      ],
       "anchors": {
         "modeling": "#document-modeling",
         "queries": "#query-patterns"
@@ -696,7 +934,13 @@
         "data",
         "vector-search"
       ],
-      "aliases": ["Azure AI Search", "cognitive search", "vector search", "hybrid search", "semantic ranking"],
+      "aliases": [
+        "Azure AI Search",
+        "cognitive search",
+        "vector search",
+        "hybrid search",
+        "semantic ranking"
+      ],
       "anchors": {
         "indexing": "#index-setup",
         "queries": "#search-queries"
@@ -713,7 +957,13 @@
         "data",
         "vector-search"
       ],
-      "aliases": ["RAG chunking", "document chunking", "text splitting", "chunk overlap", "embedding chunks"],
+      "aliases": [
+        "RAG chunking",
+        "document chunking",
+        "text splitting",
+        "chunk overlap",
+        "embedding chunks"
+      ],
       "anchors": {
         "strategies": "#chunking-strategies",
         "retrieval": "#retrieval-pipeline"
@@ -730,7 +980,12 @@
         "frontend",
         "blazor"
       ],
-      "aliases": ["blazor checklist", "blazor design review", "UI checklist", "component checklist"],
+      "aliases": [
+        "blazor checklist",
+        "blazor design review",
+        "UI checklist",
+        "component checklist"
+      ],
       "anchors": {
         "components": "#component-checklist",
         "accessibility": "#a11y-checklist"
@@ -747,7 +1002,12 @@
         "frontend",
         "blazor"
       ],
-      "aliases": ["fluent ui setup", "blazor fluent", "Microsoft Fluent UI", "FluentUI install"],
+      "aliases": [
+        "fluent ui setup",
+        "blazor fluent",
+        "Microsoft Fluent UI",
+        "FluentUI install"
+      ],
       "anchors": {
         "setup": "#package-setup",
         "theme": "#theme-configuration"
@@ -764,7 +1024,13 @@
         "frontend",
         "blazor"
       ],
-      "aliases": ["fluent ui components", "FluentDataGrid", "FluentDialog", "FluentButton", "FluentCombobox"],
+      "aliases": [
+        "fluent ui components",
+        "FluentDataGrid",
+        "FluentDialog",
+        "FluentButton",
+        "FluentCombobox"
+      ],
       "anchors": {
         "grid": "#data-grid",
         "forms": "#form-components"
@@ -781,7 +1047,12 @@
         "frontend",
         "blazor"
       ],
-      "aliases": ["html to blazor", "blazor migration", "html conversion", "razor conversion"],
+      "aliases": [
+        "html to blazor",
+        "blazor migration",
+        "html conversion",
+        "razor conversion"
+      ],
       "anchors": {
         "mapping": "#html-to-blazor-mapping",
         "components": "#component-patterns"
@@ -798,7 +1069,13 @@
         "frontend",
         "blazor"
       ],
-      "aliases": ["blazor lifecycle", "OnInitialized", "OnAfterRender", "StateHasChanged", "component lifecycle"],
+      "aliases": [
+        "blazor lifecycle",
+        "OnInitialized",
+        "OnAfterRender",
+        "StateHasChanged",
+        "component lifecycle"
+      ],
       "anchors": {
         "hooks": "#lifecycle-hooks",
         "async": "#async-patterns"
@@ -815,7 +1092,13 @@
         "frontend",
         "blazor"
       ],
-      "aliases": ["blazor anti-patterns", "blazor mistakes", "blazor gotchas", "blazor bugs", "common errors"],
+      "aliases": [
+        "blazor anti-patterns",
+        "blazor mistakes",
+        "blazor gotchas",
+        "blazor bugs",
+        "common errors"
+      ],
       "anchors": {
         "concurrency": "#concurrency-pitfalls",
         "memory": "#memory-leaks"
@@ -832,7 +1115,13 @@
         "frontend",
         "blazor"
       ],
-      "aliases": ["blazor state", "cascading value", "state container", "component state", "Fluxor"],
+      "aliases": [
+        "blazor state",
+        "cascading value",
+        "state container",
+        "component state",
+        "Fluxor"
+      ],
       "anchors": {
         "patterns": "#state-patterns",
         "sharing": "#state-sharing"
@@ -849,7 +1138,13 @@
         "frontend",
         "design-system"
       ],
-      "aliases": ["aesthetic direction", "visual design", "brand identity", "design language", "design tone"],
+      "aliases": [
+        "aesthetic direction",
+        "visual design",
+        "brand identity",
+        "design language",
+        "design tone"
+      ],
       "anchors": {
         "principles": "#design-principles",
         "tokens": "#design-tokens"
@@ -866,7 +1161,14 @@
         "frontend",
         "design-system"
       ],
-      "aliases": ["animations", "transitions", "motion", "CSS animations", "keyframes", "prefers-reduced-motion"],
+      "aliases": [
+        "animations",
+        "transitions",
+        "motion",
+        "CSS animations",
+        "keyframes",
+        "prefers-reduced-motion"
+      ],
       "anchors": {
         "tokens": "#animation-tokens",
         "principles": "#motion-principles"
@@ -883,7 +1185,13 @@
         "frontend",
         "design-system"
       ],
-      "aliases": ["BEM", "CSS naming", "class naming", "design token naming", "component naming"],
+      "aliases": [
+        "BEM",
+        "CSS naming",
+        "class naming",
+        "design token naming",
+        "component naming"
+      ],
       "anchors": {
         "blocks": "#bem-blocks",
         "tokens": "#token-naming"
@@ -900,7 +1208,13 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["app router", "Next.js 14", "server components", "app directory", "RSC"],
+      "aliases": [
+        "app router",
+        "Next.js 14",
+        "server components",
+        "app directory",
+        "RSC"
+      ],
       "anchors": {
         "layout": "#layout-patterns",
         "routing": "#routing-patterns"
@@ -917,7 +1231,13 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["react components", "server component", "client component", "shadcn/ui", "UI components"],
+      "aliases": [
+        "react components",
+        "server component",
+        "client component",
+        "shadcn/ui",
+        "UI components"
+      ],
       "anchors": {
         "patterns": "#component-patterns",
         "shadcn": "#shadcn-usage"
@@ -934,7 +1254,13 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["TanStack Query", "react-query", "server actions", "data fetching", "useQuery"],
+      "aliases": [
+        "TanStack Query",
+        "react-query",
+        "server actions",
+        "data fetching",
+        "useQuery"
+      ],
       "anchors": {
         "server": "#server-fetching",
         "client": "#client-fetching"
@@ -951,7 +1277,13 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["react-hook-form", "Zod", "form validation", "Server Actions forms", "useFormState"],
+      "aliases": [
+        "react-hook-form",
+        "Zod",
+        "form validation",
+        "Server Actions forms",
+        "useFormState"
+      ],
       "anchors": {
         "validation": "#zod-schemas",
         "submission": "#form-submission"
@@ -968,7 +1300,13 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["naming conventions", "file naming", "component naming", "Next.js naming", "TypeScript naming"],
+      "aliases": [
+        "naming conventions",
+        "file naming",
+        "component naming",
+        "Next.js naming",
+        "TypeScript naming"
+      ],
       "anchors": {
         "files": "#file-naming",
         "components": "#component-naming"
@@ -985,7 +1323,13 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["Next.js patterns", "middleware", "auth patterns", "caching patterns", "image optimization"],
+      "aliases": [
+        "Next.js patterns",
+        "middleware",
+        "auth patterns",
+        "caching patterns",
+        "image optimization"
+      ],
       "anchors": {
         "auth": "#auth-patterns",
         "caching": "#caching-patterns"
@@ -1002,7 +1346,12 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["project structure", "folder structure", "src directory", "app directory organization"],
+      "aliases": [
+        "project structure",
+        "folder structure",
+        "src directory",
+        "app directory organization"
+      ],
       "anchors": {
         "structure": "#directory-structure",
         "organization": "#feature-organization"
@@ -1019,7 +1368,13 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["zustand", "React context", "global state", "state management", "client state"],
+      "aliases": [
+        "zustand",
+        "React context",
+        "global state",
+        "state management",
+        "client state"
+      ],
       "anchors": {
         "patterns": "#state-patterns",
         "server": "#server-state"
@@ -1036,7 +1391,14 @@
         "frontend",
         "nextjs"
       ],
-      "aliases": ["vitest", "jest", "testing-library", "Playwright", "Next.js testing", "component tests"],
+      "aliases": [
+        "vitest",
+        "jest",
+        "testing-library",
+        "Playwright",
+        "Next.js testing",
+        "component tests"
+      ],
       "anchors": {
         "unit": "#unit-tests",
         "e2e": "#e2e-tests"
@@ -1053,7 +1415,13 @@
         "infrastructure",
         "azure"
       ],
-      "aliases": ["azure", "Azure setup", "resource group", "subscription", "azure baseline"],
+      "aliases": [
+        "azure",
+        "Azure setup",
+        "resource group",
+        "subscription",
+        "azure baseline"
+      ],
       "anchors": {
         "resources": "#core-resources",
         "security": "#security-baseline"
@@ -1071,7 +1439,13 @@
         "azure",
         "bicep"
       ],
-      "aliases": ["bicep", "ARM template", "IaC", "infrastructure as code", "resource deployment"],
+      "aliases": [
+        "bicep",
+        "ARM template",
+        "IaC",
+        "infrastructure as code",
+        "resource deployment"
+      ],
       "anchors": {
         "modules": "#module-patterns",
         "parameters": "#parameter-files"
@@ -1089,7 +1463,13 @@
         "azure",
         "devops"
       ],
-      "aliases": ["azure devops", "ADO", "pipelines", "YAML pipeline", "azure-pipelines.yml"],
+      "aliases": [
+        "azure devops",
+        "ADO",
+        "pipelines",
+        "YAML pipeline",
+        "azure-pipelines.yml"
+      ],
       "anchors": {
         "setup": "#organization-setup",
         "pipelines": "#pipeline-setup"
@@ -1107,7 +1487,14 @@
         "azure",
         "devops"
       ],
-      "aliases": ["local dev", "azurite", "local azure", "dev container", "local secrets", "dotnet user-secrets"],
+      "aliases": [
+        "local dev",
+        "azurite",
+        "local azure",
+        "dev container",
+        "local secrets",
+        "dotnet user-secrets"
+      ],
       "anchors": {
         "emulators": "#local-emulators",
         "secrets": "#local-secrets"
@@ -1125,7 +1512,14 @@
         "azure",
         "services"
       ],
-      "aliases": ["Azure Functions", "serverless", "function app", "timer trigger", "HTTP trigger", "Durable Functions"],
+      "aliases": [
+        "Azure Functions",
+        "serverless",
+        "function app",
+        "timer trigger",
+        "HTTP trigger",
+        "Durable Functions"
+      ],
       "anchors": {
         "triggers": "#trigger-types",
         "bindings": "#input-output-bindings"
@@ -1143,7 +1537,13 @@
         "azure",
         "services"
       ],
-      "aliases": ["service bus", "message queue", "topics", "subscriptions", "dead letter queue"],
+      "aliases": [
+        "service bus",
+        "message queue",
+        "topics",
+        "subscriptions",
+        "dead letter queue"
+      ],
       "anchors": {
         "setup": "#namespace-setup",
         "patterns": "#messaging-patterns"
@@ -1161,7 +1561,13 @@
         "azure",
         "services"
       ],
-      "aliases": ["azure storage", "blob", "table storage", "queue storage", "storage account tiers"],
+      "aliases": [
+        "azure storage",
+        "blob",
+        "table storage",
+        "queue storage",
+        "storage account tiers"
+      ],
       "anchors": {
         "tiers": "#storage-tiers",
         "security": "#access-control"
@@ -1178,7 +1584,13 @@
         "infrastructure",
         "docker"
       ],
-      "aliases": ["easypanel", "docker deploy", "self-hosted", "VPS deployment", "docker compose"],
+      "aliases": [
+        "easypanel",
+        "docker deploy",
+        "self-hosted",
+        "VPS deployment",
+        "docker compose"
+      ],
       "anchors": {
         "setup": "#easypanel-setup",
         "deployment": "#deployment-flow"
@@ -1195,7 +1607,12 @@
         "infrastructure",
         "supabase"
       ],
-      "aliases": ["supabase MCP", "supabase tools", "supabase configuration", "MCP supabase"],
+      "aliases": [
+        "supabase MCP",
+        "supabase tools",
+        "supabase configuration",
+        "MCP supabase"
+      ],
       "anchors": {
         "setup": "#mcp-configuration",
         "tools": "#available-tools"
@@ -1212,7 +1629,13 @@
         "infrastructure",
         "supabase"
       ],
-      "aliases": ["supabase auth", "magic link", "OAuth", "JWT supabase", "row level security auth"],
+      "aliases": [
+        "supabase auth",
+        "magic link",
+        "OAuth",
+        "JWT supabase",
+        "row level security auth"
+      ],
       "anchors": {
         "setup": "#auth-setup",
         "providers": "#auth-providers"
@@ -1229,7 +1652,13 @@
         "infrastructure",
         "supabase"
       ],
-      "aliases": ["pgvector", "vector embeddings", "similarity search", "supabase vectors", "HNSW index"],
+      "aliases": [
+        "pgvector",
+        "vector embeddings",
+        "similarity search",
+        "supabase vectors",
+        "HNSW index"
+      ],
       "anchors": {
         "setup": "#pgvector-setup",
         "queries": "#similarity-queries"
@@ -1246,7 +1675,13 @@
         "infrastructure",
         "supabase"
       ],
-      "aliases": ["RLS", "row level security", "postgres policies", "multi-tenant security", "supabase policies"],
+      "aliases": [
+        "RLS",
+        "row level security",
+        "postgres policies",
+        "multi-tenant security",
+        "supabase policies"
+      ],
       "anchors": {
         "policies": "#rls-policies",
         "patterns": "#tenant-patterns"
@@ -1263,7 +1698,13 @@
         "infrastructure",
         "supabase"
       ],
-      "aliases": ["supabase storage", "file uploads", "storage buckets", "storage policies", "signed URLs"],
+      "aliases": [
+        "supabase storage",
+        "file uploads",
+        "storage buckets",
+        "storage policies",
+        "signed URLs"
+      ],
       "anchors": {
         "buckets": "#bucket-setup",
         "policies": "#storage-policies"
@@ -1280,7 +1721,14 @@
         "integration",
         "api"
       ],
-      "aliases": ["graphql", "Hot Chocolate", "GraphQL schema", "query", "mutation", "subscription"],
+      "aliases": [
+        "graphql",
+        "Hot Chocolate",
+        "GraphQL schema",
+        "query",
+        "mutation",
+        "subscription"
+      ],
       "anchors": {
         "setup": "#hot-chocolate-setup",
         "patterns": "#schema-patterns"
@@ -1297,7 +1745,13 @@
         "integration",
         "api"
       ],
-      "aliases": ["grpc", "protobuf", ".proto files", "gRPC service", "server streaming"],
+      "aliases": [
+        "grpc",
+        "protobuf",
+        ".proto files",
+        "gRPC service",
+        "server streaming"
+      ],
       "anchors": {
         "proto": "#proto-design",
         "patterns": "#service-patterns"
@@ -1314,7 +1768,13 @@
         "integration",
         "api"
       ],
-      "aliases": ["REST design", "RESTful API", "HTTP API design", "resource naming", "API versioning"],
+      "aliases": [
+        "REST design",
+        "RESTful API",
+        "HTTP API design",
+        "resource naming",
+        "API versioning"
+      ],
       "anchors": {
         "resources": "#resource-naming",
         "errors": "#error-handling"
@@ -1331,7 +1791,13 @@
         "integration",
         "event-driven"
       ],
-      "aliases": ["CQRS", "command query separation", "MediatR", "read model", "write model"],
+      "aliases": [
+        "CQRS",
+        "command query separation",
+        "MediatR",
+        "read model",
+        "write model"
+      ],
       "anchors": {
         "commands": "#command-patterns",
         "queries": "#query-patterns"
@@ -1348,7 +1814,13 @@
         "integration",
         "event-driven"
       ],
-      "aliases": ["event sourcing", "event store", "event replay", "aggregate events", "append-only log"],
+      "aliases": [
+        "event sourcing",
+        "event store",
+        "event replay",
+        "aggregate events",
+        "append-only log"
+      ],
       "anchors": {
         "events": "#domain-events",
         "replay": "#event-replay"
@@ -1365,7 +1837,13 @@
         "integration",
         "event-driven"
       ],
-      "aliases": ["service bus integration", "message broker", "event bus", "publisher", "consumer"],
+      "aliases": [
+        "service bus integration",
+        "message broker",
+        "event bus",
+        "publisher",
+        "consumer"
+      ],
       "anchors": {
         "topics": "#topic-subscription",
         "patterns": "#integration-patterns"
@@ -1382,7 +1860,13 @@
         "integration",
         "mcp"
       ],
-      "aliases": ["MCP", "Model Context Protocol", "Claude tools", "MCP server", "MCP client"],
+      "aliases": [
+        "MCP",
+        "Model Context Protocol",
+        "Claude tools",
+        "MCP server",
+        "MCP client"
+      ],
       "anchors": {
         "tools": "#tool-definitions",
         "setup": "#server-setup"
@@ -1398,7 +1882,14 @@
       "tags": [
         "observability"
       ],
-      "aliases": ["logging", "serilog", "ILogger", "structured logging", "log levels", "Application Insights"],
+      "aliases": [
+        "logging",
+        "serilog",
+        "ILogger",
+        "structured logging",
+        "log levels",
+        "Application Insights"
+      ],
       "anchors": {
         "setup": "#serilog-setup",
         "patterns": "#logging-patterns"
@@ -1414,7 +1905,14 @@
       "tags": [
         "observability"
       ],
-      "aliases": ["metrics", "prometheus", "OpenTelemetry metrics", "custom metrics", "counters", "histograms"],
+      "aliases": [
+        "metrics",
+        "prometheus",
+        "OpenTelemetry metrics",
+        "custom metrics",
+        "counters",
+        "histograms"
+      ],
       "anchors": {
         "setup": "#metrics-setup",
         "instruments": "#metric-types"
@@ -1430,7 +1928,14 @@
       "tags": [
         "observability"
       ],
-      "aliases": ["monitoring", "alerts", "dashboards", "Application Insights", "health checks", "SLA"],
+      "aliases": [
+        "monitoring",
+        "alerts",
+        "dashboards",
+        "Application Insights",
+        "health checks",
+        "SLA"
+      ],
       "anchors": {
         "alerts": "#alert-rules",
         "dashboards": "#dashboard-setup"
@@ -1446,7 +1951,13 @@
       "tags": [
         "observability"
       ],
-      "aliases": ["tracing", "OpenTelemetry", "distributed trace", "spans", "W3C TraceContext"],
+      "aliases": [
+        "tracing",
+        "OpenTelemetry",
+        "distributed trace",
+        "spans",
+        "W3C TraceContext"
+      ],
       "anchors": {
         "setup": "#otel-setup",
         "propagation": "#context-propagation"
@@ -1462,7 +1973,14 @@
       "tags": [
         "workflows"
       ],
-      "aliases": ["parallel", "Task.WhenAll", "concurrent", "parallelism", "async parallel", "Parallel.ForEachAsync"],
+      "aliases": [
+        "parallel",
+        "Task.WhenAll",
+        "concurrent",
+        "parallelism",
+        "async parallel",
+        "Parallel.ForEachAsync"
+      ],
       "anchors": {
         "patterns": "#parallel-patterns",
         "throttling": "#concurrency-limits"
@@ -1478,12 +1996,46 @@
       "tags": [
         "workflows"
       ],
-      "aliases": ["threads", "ThreadPool", "ConfigureAwait", "deadlock prevention", "async void", "synchronization"],
+      "aliases": [
+        "threads",
+        "ThreadPool",
+        "ConfigureAwait",
+        "deadlock prevention",
+        "async void",
+        "synchronization"
+      ],
       "anchors": {
         "patterns": "#thread-patterns",
         "deadlocks": "#deadlock-prevention"
       },
       "digest": "Use async/await throughout — never mix blocking calls (.Result, .Wait()). ConfigureAwait(false) in library code. Never Thread.Sleep — use Task.Delay with CancellationToken. Lock-free with Interlocked for counters, ConcurrentDictionary for shared state. ThreadPool.QueueUserWorkItem only for truly detached background work."
+    },
+    {
+      "id": "infrastructure-vercel-database",
+      "name": "vercel database",
+      "path": "infrastructure/vercel/vercel-database.md",
+      "category": "infrastructure",
+      "subcategory": "vercel",
+      "tags": [
+        "infrastructure",
+        "vercel",
+        "nextjs",
+        "database"
+      ],
+      "aliases": [
+        "Vercel deploy",
+        "serverless database",
+        "Neon",
+        "PlanetScale",
+        "Vercel Postgres",
+        "serverless postgres"
+      ],
+      "anchors": {
+        "decision": "#decision-tree-choose-your-db-tier",
+        "neon": "#implementation-neon-recommended",
+        "supabase": "#implementation-supabase--pgbouncer-transaction-mode"
+      },
+      "digest": "NEVER use a traditional TCP connection pool (plain pg/Npgsql) when deploying to Vercel — ephemeral functions exhaust connections instantly. ALWAYS use a serverless-compatible database: Neon (first choice for SQL), Supabase with PgBouncer on port 6543 (transaction mode), PlanetScale, or Turso. Set connection_limit=1 when using ORMs with PgBouncer."
     }
   ]
-}
+}