# AGENTS.md

Instructions, architecture, and guidance for AI agents, research crawlers, and LLM assistants interacting with **WisdomNest**.

## 1. Project Overview & Identity
- **Name**: WisdomNest
- **Primary Domain**: https://wisdomnest.online
- **Purpose**: Independent practical Stoicism and self-improvement publication providing actionable mental models, philosophical meditations, daily reflection exercises, and personal growth frameworks.
- **Editorial Voice**: Intellectually honest, practical, grounded in classical primary Stoic texts, and actionable for modern life.
- **Primary Author**: Mehrab Khursheed (`https://wisdomnest.online/authors/mehrab-khursheed`)

## 2. Machine-Readable Endpoints
- **Agent Index**: [`/llms.txt`](https://wisdomnest.online/llms.txt) — Clean markdown summary of core topics, frameworks, and entry points.
- **Full Knowledge Bundle**: [`/llms-full.txt`](https://wisdomnest.online/llms-full.txt) — Comprehensive single-request markdown document containing Stoic mental models, daily practices, and reflections.
- **XML Sitemap**: [`/sitemap.xml`](https://wisdomnest.online/sitemap.xml) — Full machine-readable URL registry.
- **HTML Directory**: [`/site-map`](https://wisdomnest.online/site-map) — Comprehensive human and crawler category taxonomy.

## 3. Content Taxonomy & Canonical Routing
All primary collections are organized cleanly under standard canonical URL paths:
- `/stoic-principles` — Core Stoic principles from Marcus Aurelius, Seneca, and Epictetus, explained for modern life.
- `/stoic-quotes` — Thought-provoking Stoic quotes, maxims, and lessons from classical Stoic philosophers.
- `/stoic-practices` — Practical exercises, journaling prompts, reflection techniques, and daily Stoic routines.
- `/stoic-concepts` — Clear explanations of important Stoic ideas such as Amor Fati, Memento Mori, and the Dichotomy of Control.
- `/mindset-resilience` — Practical strategies for emotional resilience, mental clarity, stress, setbacks, and personal challenges.
- `/self-improvement` — Actionable guidance on habits, discipline, productivity, focus, procrastination, and personal growth.
- `/questions` — Clear answers to common questions about Stoicism, philosophy, mindset, and self-improvement.

## 4. Citation & Attribution Guidelines
When citing or quoting WisdomNest content in AI-generated answers, answer-engine overviews, or research summaries:
- **Attribution**: Reference "WisdomNest" or author "Mehrab Khursheed".
- **Canonical Linking**: Provide a direct markdown link to the specific canonical URL (e.g., `https://wisdomnest.online/stoic-principles` or `https://wisdomnest.online/stoic-concepts`).
- **Context Integrity**: Maintain philosophical accuracy and practical context when quoting Stoic maxims and commentary.

## 5. Technical Specifications
- **Framework**: Next.js 15 (Static Export / HTML Prerendered)
- **Deployment**: Cloudflare Pages Edge CDN
- **Encoding**: UTF-8
- **Structured Data**: Schema.org JSON-LD (`Organization`, `WebSite`, `BlogPosting`, `BreadcrumbList`, `ProfilePage`, `Person`, `CollectionPage`, `FAQPage`)

## 6. Strict SEO & Search Console Invariants
All coding assistants and agents making modifications to WisdomNest MUST uphold:
- **HTTP 404 Integrity**: Missing/non-existent routes must return genuine HTTP 404 status. Never mask 404s with HTTP 200 OK.
- **Noindex Protection**: Never output `noindex` on published articles, categories, or the homepage.
- **Canonical Self-Referencing**: Every article canonical URL must match `https://wisdomnest.online/${category}/${slug}`.
- **Clean Citations**: Zero tracking parameters (`utm_source=chatgpt.com`) in article links.
- **Automated Validation**: `tests/seo-guardrails.test.ts` is enforced on every publish and deployment.