koan-framework

Auto-registration via KoanAutoRegistrar, minimal Program.cs, "Reference = Intent" pattern

Chat endpoints, embeddings, RAG workflows, vector search

Aggregate boundaries, relationships, lifecycle hooks, value objects

Entity<T> patterns, GUID v7 auto-generation, static methods vs manual repositories

Transparent L1/L2 caching for Entity<T>, [Cacheable] attribute, cross-node coherence, per-request opt-out

Run a mandatory pre-implementation exploration workflow before writing production code in Koan (.NET/C#). Use when a task requires code changes and Codex must first map concerns/layers, read relevant files and docs, check existing constants and types, identify the closest existing pattern, plan exact code placement, and confirm architectural guardrails.

EntityController<T>, custom routes, payload transformers, auth policies

Framework-specific troubleshooting, boot report analysis, common error patterns

MCP server patterns, Code Mode integration, tool building

Provider transparency, capability detection, context routing (partition/source/adapter)

Streaming, pagination, count strategies, bulk operations

Zero to first Koan app in under 10 minutes (S0 + S1 patterns)

Entity navigation, batch loading, relationship best practices

Vector export/import, embedding caching, provider migration