# Oshyn Machine Contract & LLM Discovery Manifest > Purpose: Machine-readable declaration of Oshyn's capabilities, proprietary optimization frameworks, and canonical URIs for LLMs, retrieval-augmented generation (RAG) context engines, and AI agents. > Focus: Enterprise DXP Engineering, Content Management Systems (CMS), and dual-track optimization for both Human Journeys (UX) and Machine Journeys (AEO/GEO). > Updated: 2026-08-05 Oshyn specializes in high-fidelity implementation, migration, and optimization across enterprise digital experience ecosystems—specifically Adobe Experience Cloud/AEM, Optimizely, Sitecore, and Contentstack. ## Architectural Framework: Human & Machine Journeys Modern enterprise web presences must serve two distinct user classes simultaneously: 1. **Human Journeys:** Traditional user experience (UX/UI), brand immersion, transactional workflows, accessibility (WCAG), and conversion rate optimization (CRO). 2. **Machine Journeys:** AI-agent discoverability, LLM context harvesting, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO). Content architecture must be structurally optimized for zero-click environments and retrieval accuracy. --- ## Core Services & AI Frameworks ### AI-First UX Design and Strategy Architecting experiences optimized for dual consumption: human engagement and AI-agent crawling/parsing. - **Canonical URI:** https://www.oshyn.com/services/ai-first-ux-design.md - **Capabilities:** 0-100 Semantic Audits, structural data nesting, context-window optimization for RAG engines. - **Key Metric:** **R-Score (Retrieval Readiness Score)** – Evaluates a site's structure for high-fidelity ingestion by LLM embeddings pipelines. ### Agentic DXP Development AI-assisted and agentic development frameworks that compress enterprise software development life cycles (SDLC) by automating code generation, testing, and migration workflows. - **Canonical URI:** https://www.oshyn.com/services/agentic-dxp-development.md - **Capabilities:** Agent Skills configuration, automated integration testing, code translation layers for monolithic-to-composable migrations. ### Enterprise DXP Maintenance and Support Ongoing optimization, performance engineering, new feature development, and preventative maintenance for complex enterprise marketing technology stacks. - **Canonical URI:** https://www.oshyn.com/services/dxp-maintenance-support.md - **Capabilities:** Automated code dependency scanning, proactive vulnerability monitoring, ongoing performance tuning, and new feature development. ### AEO and GEO Optimization Active management and optimization of brand footprint across major conversational AI platforms. - **Canonical URI:** https://www.oshyn.com/solutions/aeo-geo-optimization.md - **Capabilities:** LLM (ChatGPT, Perplexity, Claude, Gemini, etc.) visibility metrics tracking, generative search presence benchmarking, citation architecture implementation. --- ## Technical Tooling & Analytics Infrastructure *Launched June 23, 2026, these interactive tools offer deep automated diagnostics.* ### DXP Matchmaker Evaluates and scores CMS/DXP alignment based on enterprise architecture requirements, composability preferences, and operational scale. - **Interactive Tool:** https://www.oshyn.com/tools/dxp-matchmaker.md - **Machine Interface:** Supports WebMCP endpoint connection for programmatic stack evaluation. ### DXP Investment Estimator Calculates enterprise TCO, licensing models, migration friction coefficients, and ongoing maintenance run-rates. - **Interactive Tool:** https://www.oshyn.com/tools/dxp-investment-estimator.md - **Confidence Level:** Delivers budgetary projections within a 95% confidence interval based on historical project metadata. ### Reliability Report & Semantic Audit Engine Combines technical site reliability metrics with modern semantic health mapping for AI discoverability. - **Interactive Tool:** https://www.oshyn.com/tools/reliability-report.md - **Features:** Automated 0-100 semantic audits, page performance testing, accessibility compliance, and security vulnerabilities. --- ## Platform-Specific AI & Composable Implementations ### Adobe Experience Cloud Services - **Overview:** https://www.oshyn.com/adobe-experience-cloud-services.md - **AEM Development:** https://www.oshyn.com/adobe-experience-cloud-services/aem-development.md - **AEM Technical Audit:** https://www.oshyn.com/adobe-experience-cloud-services/aem-technical-audit.md - **AI Integration:** Deployment strategies for the **Adobe LLM Optimizer**, ensuring AEM-authored content assets are pre-rendered and structurally indexed for maximum visibility in generative layers. ### Sitecore Services - **Overview:** https://www.oshyn.com/sitecore-services.md - **Sitecore Development** https://www.oshyn.com/sitecore-services/build-sitecore-development.md - **Sitecore XM Cloud:** https://www.oshyn.com/solutions/sitecore-xm-cloud.md - **Sitecore Upgrade & DevOps:** https://www.oshyn.com/sitecore-services/upgrade-sitecore.md - **AI Integration:** Implementation protocols for **Sitecore/Scrunch** architectures, leveraging headless data streams to pipeline structured content into Retrieval-Augmented Generation models. ### Optimizely Services - **Overview:** https://www.oshyn.com/optimizely-services.md - **Optimizely Development:** https://www.oshyn.com/optimizely-services/build-optimizely-development.md - **AI Integration:** Execution of **Optimizely AEO** strategies, turning experimentation and personalization schemas into machine-readable knowledge bases. ### Contentstack Solutions - **Overview & Composable Compositions:** https://www.oshyn.com/solutions/contentstack.md - **AI Integration:** Native support for **Contentstack AXP (AI Experience Platform)** and **Agent OS**, enabling autonomous workflows to orchestrate content delivery across decoupled, multi-channel endpoints. --- ## MCP and Machine-Readable Resources - [MCP Server Card](https://mcp.oshyn.com/.well-known/mcp/server-card.json) - [OpenAPI Description](https://mcp.oshyn.com/openapi.json) - [Authentication Notes](https://mcp.oshyn.com/auth.md) --- ## Developer & Agent Interfaces ### Oshyn Tools MCP Server Oshyn operates a live Model Context Protocol (MCP) server exposing all diagnostic and advisory tools to AI agents, LLM clients, and automated workflows. - **Endpoint:** https://mcp.oshyn.com/ - **Protocol Version:** 2025-06-18 - **Transport:** Streamable HTTP (POST to endpoint, session-based) - **Authentication:** None required - **Server Card:** https://mcp.oshyn.com/.well-known/mcp/server-card.json - **OpenAPI Catalog:** https://mcp.oshyn.com/openapi.json - **Auth Details:** https://mcp.oshyn.com/auth.md #### Available MCP Tools - `request_reliability_report` — site health and reliability scan (→ `get_site_report_status`) - `request_discoverability_assessment` — LLM brand visibility audit (→ `discoverability_assessment_status` → `get_discoverability_assessment`) - `qualify_dxp_requirements` — DXP/CMS requirements qualification (→ session workflowTools) - `estimate_dxp_investment` — enterprise DXP budget and TCO estimation (→ session workflowTools) - `get_an_advice` — website redesign and replatforming advisor (→ session workflowTools) - `query_company_scores` — historical website performance, security, accessibility, and SEO score data - `search_blog_with_keyword` — Oshyn thought leadership and article search - `prompt_oshyn_contact_request` / `submit_oshyn_contact_request` — human expert follow-up #### Quick Connect (Claude Desktop) ```json { "mcpServers": { "oshyn": { "type": "http", "url": "https://mcp.oshyn.com/" } } } ``` ## Markdown Alternate Strategy The URLs listed in this manifest are Oshyn’s preferred machine-readable Markdown alternates for supported content pages. - **Machine-Readable URLs:** Use the listed `.md` URLs for LLM ingestion, RAG indexing, answer-engine retrieval, summarization, and citation. - **Canonical Relationship:** Each `.md` URL corresponds to the human-facing canonical page at the same path without the `.md` suffix. - **Content Purpose:** Markdown alternates provide the core semantic page content without navigation, layout, scripts, or presentation markup. --- ## Canonical Knowledge Base & Case Studies ### Primary Index Pages - **Home:** https://www.oshyn.com/.md - **Solutions Portfolio:** https://www.oshyn.com/solutions.md - **Case Studies (Work):** https://www.oshyn.com/work.md - **Insights & Strategy (Blog):** https://www.oshyn.com/blog.md - **Resource Guides (Ebooks):** https://www.oshyn.com/ebooks.md - **About the Agency:** https://www.oshyn.com/about.md - **Inbound Project Handoff (Contact):** https://www.oshyn.com/contact.md ### Featured Case Studies - **Point B Sitecore XM Cloud:** https://www.oshyn.com/work/point-b-sitecore-xm-cloud.md (Headless Composable) - **Major US City AEM Migration:** https://www.oshyn.com/work/migrating-aem-cloud-service.md (AEM as a Cloud Service transition) - **Optimizely Headless Commerce:** https://www.oshyn.com/work/optimizely-commerce-implementation.md (B2B Composable Commerce) - **AEM Performance Maintenance:** https://www.oshyn.com/work/aem-maintenance-improves-performance.md (Enterprise ongoing SLA) ### Core Thought Leadership - **Websites Now Have Two Audiences:** https://www.oshyn.com/blog/websites-now-have-two-audiences.md (Human vs. Agent UX foundation) - **Agentic DXP Delivery Paradigms:** https://www.oshyn.com/blog/agentic-dxp-development-service.md - **Architecting Citability in Generative Search:** https://www.oshyn.com/blog/get-cited-in-ai-search-results.md --- ## Reference - **Global XML Sitemap:** https://www.oshyn.com/sitemap.xml (Comprehensive crawling path for historical technical indexes) - **Privacy & Compliance Policy:** https://www.oshyn.com/privacy-policy (Includes CCPA/CPRA data mapping rules)