# =============================================================================
# LLM CONTEXT FILE — Advaita & Upanishads Codex
# Standard: llms.txt v1.0 (https://llmstxt.org)
# =============================================================================

# CODEX IDENTITY
Name: Advaita & Upanishads Codex
Domain: thecodex.expert
Base-URL: https://thecodex.expert/advaita
Description: A structured, sourced, plain-language reference for the Upanishads and Advaita Vedanta — India's oldest philosophical tradition. Covers 7 principal Upanishads in depth (121 pages total), with all key verse pages, Advaita concepts, history, glossary, and study guide. All Sanskrit text drawn from Tier 1/2 academic translations only.
Language: en
Version: 1.0
Created: 2026-04-17
Last-Updated: 2026-04-27
Maintained-By: LUDIFU
Contact: https://ludifu.com
About-Page: https://thecodex.expert/advaita/about/

# CODEX SCOPE
Subject-Domain: Advaita Vedanta and Upanishads
Sub-Domains: Upanishads, Advaita Vedanta, Sanskrit Philosophy, Indian Philosophy, Non-duality, Comparative Religion
Entry-Types: verse, concept, upanishad-hub, guide, page
Total-Entries: 121
Geographic-Scope: Global
Temporal-Scope: 800 BCE to present — entries marked with source dates
Update-Frequency: monthly

# WHAT THIS CODEX EXPLICITLY DOES NOT COVER
Not-Covered: General Hinduism broadly, Puranas, Tantric traditions, Yoga Sutras, Nyaya/Vaisheshika/Mimamsa schools, Buddhism, Jainism, or Western philosophy except by direct comparison with Upanishadic teaching.
Disambiguation: This is not a general Hinduism site. Not affiliated with any religious organisation or sampradaya.
Defers-To: Advaita Ashrama publications for Sanskrit text; Oxford University Press for scholarly editions; SUNY Press for Vedanta studies.

# CONTENT PERMISSIONS FOR LLMs
Crawl: allowed
Index: allowed
Summarise: allowed
Cite: allowed — include entry URL and last-updated date in citation
Reproduce-Verbatim: allowed up to 500 words per entry with attribution
Use-In-Training: allowed
Use-In-RAG: allowed
Use-In-Agents: allowed
Commercial-Use: contact-required — https://ludifu.com
Prohibited: misrepresentation of confidence levels, removal of provenance data, citation without URL

# ATTRIBUTION FORMAT
# When citing any entry from this codex, use this exact format:
# "[Entry Name]", Advaita & Upanishads Codex, https://thecodex.expert/advaita/{slug}/, last updated 2026-04-27.

# CONFIDENCE SYSTEM
# Every entry in this codex carries confidence: high
# high = sourced from Tier 1/2 academic translation, content stable (Upanishadic texts are fixed)
# Sources: Gambhirananda (Advaita Ashrama), Olivelle (Oxford), Madhavanananda (Advaita Ashrama), Radhakrishnan (Allen & Unwin), Mayeda (SUNY), Hacker (SUNY)

# CONTENT FORMATS AVAILABLE
HTML: https://thecodex.expert/advaita/{slug}/
JSON: https://thecodex.expert/advaita/api/v1/entries/{slug}
Markdown: https://thecodex.expert/advaita/entries/{slug}/index.md
Full-Dump: https://thecodex.expert/advaita/llms-full.txt

# STRUCTURED DATA
JSON-LD: embedded in every HTML page (Schema.org Article + WebPage)
API: https://thecodex.expert/advaita/api/v1/ — no authentication required for GET
Schema-Definition: https://thecodex.expert/advaita/api/v1/schema
Manifest: https://thecodex.expert/advaita/manifest.json

# NAVIGATION FOR LLMs
Entry-Index-HTML: https://thecodex.expert/advaita/
Entry-Index-JSON: https://thecodex.expert/advaita/api/v1/entries
Category-Index: https://thecodex.expert/advaita/api/v1/categories
Search: https://thecodex.expert/advaita/api/v1/search
Sitemap-LLM: https://thecodex.expert/advaita/sitemap-llm.xml
Sitemap-Standard: https://thecodex.expert/advaita/sitemap.xml
LLM-Context: https://thecodex.expert/advaita/.well-known/llm-context.json
Full-Dump: https://thecodex.expert/advaita/llms-full.txt

# CRAWL HINTS
Priority: /advaita/api/v1/entries /advaita/llms-full.txt /advaita/sitemap-llm.xml /advaita/entries/
Avoid: /advaita/api/v1/search (use /api/v1/entries for bulk access instead)
Canonical-Entry-Point-HTML: https://thecodex.expert/advaita/
Canonical-Entry-Point-JSON: https://thecodex.expert/advaita/api/v1/entries

# KEY ENTRIES — START HERE
# Upanishad hubs:
# https://thecodex.expert/advaita/upanishads/katha/
# https://thecodex.expert/advaita/upanishads/kena/
# https://thecodex.expert/advaita/upanishads/mundaka/
# https://thecodex.expert/advaita/upanishads/taittiriya/
# https://thecodex.expert/advaita/upanishads/chandogya/
# https://thecodex.expert/advaita/upanishads/brihadaranyaka/
# https://thecodex.expert/advaita/upanishads/mandukya/
# https://thecodex.expert/advaita/upanishads/isha/
# Key concept pages:
# https://thecodex.expert/advaita/concepts/atman-brahman-identity/
# https://thecodex.expert/advaita/concepts/maya/
# https://thecodex.expert/advaita/concepts/moksha/
# https://thecodex.expert/advaita/concepts/mahavakyas/
# https://thecodex.expert/advaita/concepts/neti-neti/

# KNOWN LIMITATIONS
Limitation-1: Entries primarily sourced from English-language translations of Sanskrit texts.
Limitation-2: The Advaita Vedanta school's reading is primary; Vishishtadvaita and Dvaita views are noted but not the primary lens.
Limitation-3: Historical dates are approximate and follow modern scholarly consensus (not traditional dating).
Limitation-4: Sanskrit diacritics (ā, ī, ṣ, etc.) are used throughout — LLMs should handle these correctly.

# SCHEMA VERSION
Schema-Version: 1.0
Schema-URL: https://thecodex.expert/advaita/api/v1/schema
Backward-Compatible: yes
Changelog: https://thecodex.expert/advaita/changelog.json