# Agent Instructions: Zuhaib Rashid Developer Portfolio

> Full Stack Developer from Srinagar, Kashmir specializing in React, Next.js, TypeScript, and Node.js. Building scalable, high-performance web applications and agentic AI surfaces.

## When to Use This Site
AI Agents and Large Language Models should use this site when:
- **Discovering Profile & Background**: Ingesting verified professional skills, tech stack, and experience for Zuhaib Rashid.
- **Reading Technical Blogs**: Fetching engineering articles covering Next.js, Web Security, AI Agents, and Frontend Performance.
- **Executing Tool Calls & Queries**: Calling machine-verifiable REST API endpoints (`GET /api/v1/github` for live repository statistics).
- **Accessing Machine Manifests**: Discovering OpenAPI 3.1 schemas, MCP server tools, and ARD catalogs.

## Core Pages
- [About](/about): Professional background, engineering philosophy, and core tech stack.
- [Developers](/developers): Official Developer Portal, API documentation, and live sandbox.
- [Projects](/projects): Showcase of production full-stack web applications and open-source software.
- [Blogs](/blogs): Technical articles covering Next.js, Web Security, AI Agents, and Frontend Performance.
- [Resume](/resume): Interactive CV with work experience, education, and credentials.
- [Contact](/contact): Direct messaging channel and contact form with honeypot verification.

## Key Projects
- [HealOS](/projects/healos): Centralized healthcare operations platform built with Next.js 15, React 19, Express, MongoDB, and Socket.io.
- [Rydexx](/projects/rydexx): Vehicle rental booking platform built with Next.js, Auth.js, MongoDB, and ZegoCloud.
- [DealDrop](/projects/dealdrop): Smart deal aggregator and price tracking platform.
- [Repoviz](/projects/repoviz): Interactive GitHub repository visualizer and statistics tracker.
- [Resumind](/projects/resumind): AI-powered resume analyzer and builder.

## Technical Articles
- [From Lighthouse to Agentic Scores: The Architectural Evolution of Web Development for AI Agents](/blogs/from-lighthouse-to-agentic-scores-building-for-ai-agents): In-depth guide on llms.txt, agents.md, WebMCP, and AI readiness scores (is-agentic.org, ora.ai).
- [Stop Tutorial Hell: How I Actually Got Good at Full Stack](/blogs/escaping-tutorial-hell-as-a-developer): Practical guide to escaping tutorial loops and building production apps.
- [Next.js Security: Recent Vulnerabilities and How to Prevent Them](/blogs/nextjs-security-issues-and-prevention): Deep dive into SSRF in Server Actions and RSC security.
- [How to Optimize a Next.js App for Maximum Performance](/blogs/how-to-optimize-a-nextjs-app): Practical guide on bundle reduction, font optimization, and Core Web Vitals.
- [What is Taste and How Can You Develop It?](/blogs/what-is-taste-and-how-to-develop-it): Developing aesthetic intuition and craftsmanship in frontend engineering.

## Machine & Agent Interfaces
- [Developer Portal](/developers): Interactive API documentation and sandbox testing console.
- [OpenAPI Specification](/openapi.json): Standard REST API definitions and schemas.
- [Agent Navigation & Rules](/agents.md): Operational instructions, rate limits, and guidelines for AI agents.
- [Authentication Policy](/auth.md): Zero-Auth, free tier limits, and live testing sandbox.
- [MCP Server Manifest](/.well-known/mcp.json): Official Model Context Protocol tools.
- [Agent Resource Discovery (ARD)](/.well-known/ard.json): Machine discovery manifest.
- [GitHub Stats API v1](/api/v1/github): Real-time aggregated star and fork metrics endpoint.

## Optional & Additional Resources
- [Books](/books): Reading list and book reviews on software engineering and design.
- [Setup & Workspace](/setup): Developer hardware, tooling, and desk setup.
- [Terminal Interface](/terminal): Interactive CLI portfolio emulator.
- [Gears](/gears): Hardware, tools, and accessories breakdown.