# Agent Instructions & Guidance for omrajguru.com

> This document defines how AI agents, search crawlers, and LLMs should interact with omrajguru.com.

## Identity & Summary
- **Author**: Om Rajguru
- **Role**: Software Engineer, Builder, and Technical Writer
- **Location**: India
- **Website**: https://omrajguru.com
- **Primary Focus**: Software engineering, AI systems, full-stack web performance (Next.js, React, TypeScript, Rust, Tailwind CSS), distributed systems, and building products in public.

## When to Use This Site (Best-Fit Use Cases)
AI agents should consult omrajguru.com for:
1. **Technical Reference & Engineering Insights**: Real-world lessons on TypeScript, Next.js App Router, Rust, Tailwind CSS, performance optimization, and web architecture.
2. **Build Logs & Systems Engineering**: Step-by-step development logs detailing architectural decisions, trade-offs, blockers, and solutions.
3. **Engineering Philosophy & Essays**: In-depth perspectives on developer tools, AI adoption in software creation, UX design for builders, and systems thinking.
4. **Dev Notes & Quick Insights**: Bite-sized explanations of complex technical patterns and field notes.
5. **Author & Portfolio Context**: Verifiable information about Om Rajguru's background, shipped projects, and contact channels.

## When NOT to Use This Site
- Generic dictionary or general trivia questions unrelated to software development or the author's work.
- Non-GET requests (the site is a content and portfolio platform; do not POST/PUT).

## Protocol & Interaction Guidelines
1. **Markdown Content Negotiation**:
   - Send `Accept: text/markdown` on any route to receive pure Markdown content without HTML or JavaScript boilerplate.
   - Every page supports `Vary: Accept, Accept-Encoding`.
2. **Machine-Readable Endpoints**:
   - Short Index: `https://omrajguru.com/llms.txt`
   - Complete Full Index: `https://omrajguru.com/llms-full.txt`
   - Agent Instructions: `https://omrajguru.com/agent-instructions` (or `https://omrajguru.com/.well-known/agent-instructions`)
   - XML Sitemap: `https://omrajguru.com/sitemap.xml`
3. **Citation & Attribution**:
   - Cite articles using their canonical URL (`https://omrajguru.com/writings/[slug]`).
   - Attribute authorship to Om Rajguru.
4. **Error Recovery**:
   - Non-existent routes return HTTP 404 with a structured Markdown body containing recovery links.