+
KTX
Docs
diff --git a/docs-site/content/docs/concepts/the-context-layer.mdx b/docs-site/content/docs/concepts/the-context-layer.mdx
index 3baf30f6..cb03b7c0 100644
--- a/docs-site/content/docs/concepts/the-context-layer.mdx
+++ b/docs-site/content/docs/concepts/the-context-layer.mdx
@@ -27,6 +27,161 @@ The industry has moved through three distinct approaches to getting AI and data
A context layer is the infrastructure that gives agents the business knowledge they need to produce correct analytics artifacts. It includes a semantic layer - that's a critical component - but it's not the whole thing.
+
+ 
+
+
KTX organizes context into four pillars:
- Semantic sources
diff --git a/docs-site/next-env.d.ts b/docs-site/next-env.d.ts
index 9edff1c7..c4b7818f 100644
--- a/docs-site/next-env.d.ts
+++ b/docs-site/next-env.d.ts
@@ -1,6 +1,6 @@
///
+
+
+ + {"How KTX works"} +
++ {"KTX pulls structured metadata and human knowledge from your analytics stack, reconciles it into reviewable files, then gives agents a trusted surface for search, SQL generation, validation, and edits."} +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + {"Source systems"} +
+
+
+
+
+ + {"Warehouses"} +
++ {"schemas, types, row counts, constraints, query history"} +
+
+
+ + {"Modeling tools"} +
++ {"dbt, MetricFlow, LookML"} +
+
+
+ + {"BI systems"} +
++ {"Looker explores, Metabase questions, dashboards"} +
+
+
+ + {"Notion and team knowledge"} +
++ {"runbooks, definitions, policies, analyst notes"} +
++ {"KTX ingest"} +
+
+
+
+
+ {"Extract"}
++ {"adapters read metadata, files, APIs, and warehouse evidence"} +
+
+
+ {"Reconcile"}
++ {"the ingest agent merges new facts with existing context"} +
+
+
+ {"Verify"}
++ {"validation and provenance make each write auditable"} +
++ {"KTX project"} +
+-
+
- + {"semantic-layer/"} + +
- + {"sources, columns, joins, grain, measures, segments, filters"} + +
- {"wiki/"} +
- + {"business definitions, rules, gotchas, semantic references"} + +
- + {"raw-sources/"} + +
- + {"scan artifacts, extracted metadata, relationship evidence"} + +
- {".ktx/"} +
- + {"local indexes, embeddings, session state, caches"} + +
+
+
+
+
+
+
+
+ + {"Agent workflows"} +
+
+
+
+ {"Search sources and wiki pages"}
+
+
+ {"Compile trusted SQL"}
+
+
+ {"Explain metrics and provenance"}
+
+
+ {"Patch files, validate, open review"}
+
+
+ {"Reviewed agent and analyst edits flow back into the same YAML and Markdown files, so the next ingest run starts from the team's accepted context."}
+
+