docs(ai): publish public agent entry files

Summary: Add root-level public docs assets for AI agents: /llms.txt, /go.md, and /skill.md. The llms index follows the concise discovery shape, go.md is a short CLI-first quickstart, and skill.md carries the audited IWSDK cloud-harness guide.

Reviewed By: zjm-meta

Differential Revision: D105905985

fbshipit-source-id: 9b59bed2bdc21e502461b6fe47ae6d36d75098d2

Author: felixtrz

docs/public/go.md

@@ -0,0 +1,77 @@
+# IWSDK Agent Quickstart
+
+Read the full IWSDK development skill before building an application:
+
+- https://iwsdk.dev/skill.md
+
+Use this file as a compact start-here index. The full skill is authoritative when a detail differs.
+
+## Default Operating Model
+
+- Prefer `npx iwsdk ...` CLI commands in cloud-based harnesses.
+- Use MCP tools only when the harness exposes them and they are already working.
+- Build from the official scaffold instead of hand-rolling project setup.
+- Verify visually with managed-browser screenshots and runtime inspection.
+
+## Scaffold
+
+```bash
+# VR game
+npx @iwsdk/create@0.4.1 my-iwsdk-app --yes --mode vr --physics --grabbing --no-metaspatial
+
+# AR app
+npx @iwsdk/create@0.4.1 my-ar-app --yes --mode ar --physics --scene-understanding --no-metaspatial
+
+# Browser-first 3D app
+npx @iwsdk/create@0.4.1 my-browser-app --yes --no-xr --physics --no-metaspatial
+```
+
+Choose flags based on the requested experience. For browser-first apps, add browser locomotion and camera controls in application code when needed.
+
+## Run
+
+```bash
+cd my-iwsdk-app
+npm install
+npm run dev
+```
+
+The starter `npm run dev` uses the IWSDK CLI-managed runtime. Treat the reported runtime URL and `npx iwsdk dev status` as the source of truth.
+
+```bash
+npx iwsdk dev status
+npx iwsdk browser screenshot
+npx iwsdk xr status
+```
+
+## Inspect And Debug
+
+```bash
+npx iwsdk scene hierarchy --maxDepth 3
+npx iwsdk ecs components
+npx iwsdk ecs systems
+npx iwsdk ecs snapshot --label before
+npx iwsdk ecs step --count 1
+npx iwsdk ecs snapshot --label after
+npx iwsdk ecs diff --from before --to after
+```
+
+For XR interactions:
+
+```bash
+npx iwsdk xr enter
+npx iwsdk xr get-transform --device controller-right
+npx iwsdk xr set-transform --device controller-right --position '{"x":0.3,"y":1.2,"z":-0.5}'
+npx iwsdk xr select --device controller-right
+```
+
+## Key Docs
+
+- AI overview: https://iwsdk.dev/ai/
+- Runtime-first workflows: https://iwsdk.dev/ai/workflows.html
+- MCP tools reference: https://iwsdk.dev/ai/mcp-tools.html
+- Project setup: https://iwsdk.dev/guides/01-project-setup.html
+- Browser-first systems: https://iwsdk.dev/guides/16-browser-first-systems.html
+- Examples: https://iwsdk.dev/examples/
+- API reference: https://iwsdk.dev/api/
+- LLM discovery index: https://iwsdk.dev/llms.txt

docs/public/llms.txt

@@ -0,0 +1,54 @@
+# Immersive Web SDK
+
+> Immersive Web SDK (IWSDK) is an AI-native WebXR framework for building VR, AR, mixed-reality, and browser-first 3D applications with Entity Component System architecture, Three.js-compatible rendering, spatial input, locomotion, spatial UI, runtime CLI tooling, MCP-compatible inspection, and headless browser verification.
+
+IWSDK applications should be built from the official scaffold and verified through the `iwsdk` CLI whenever possible. Cloud-based harnesses often have incomplete MCP setup, so agents should load the skill first and prefer CLI commands for setup, runtime inspection, screenshots, ECS debugging, XR emulation, and reference queries. MCP tools are useful when the harness exposes them and they are already connected.
+
+## Agent Entry Points
+
+- [IWSDK development skill](https://iwsdk.dev/skill.md): Canonical cloud-harness instructions for building, testing, debugging, and deploying IWSDK applications.
+- [Agent quickstart](https://iwsdk.dev/go.md): Short operational entrypoint for agents that need a compact start-here file before loading the full skill.
+
+## Start Here
+
+- [AI-native development overview](https://iwsdk.dev/ai/): How IWSDK's managed browser, runtime CLI, and MCP-compatible tooling fit together.
+- [Getting started with AI](https://iwsdk.dev/ai/getting-started.html): Enable AI tooling, start the managed runtime, and connect supported tools.
+- [AI workflows](https://iwsdk.dev/ai/workflows.html): Runtime-first CLI workflows for screenshots, controller interaction, scene inspection, ECS debugging, and parity checks.
+- [MCP tools reference](https://iwsdk.dev/ai/mcp-tools.html): Runtime tool surface and CLI/MCP equivalents.
+
+## Guides
+
+- [Project setup](https://iwsdk.dev/guides/01-project-setup.html): Scaffold a new IWSDK project and choose XR, AR, browser-first, and feature flags.
+- [Testing experience](https://iwsdk.dev/guides/02-testing-experience.html): Run, inspect, and verify IWSDK apps during development.
+- [Working in 3D](https://iwsdk.dev/guides/03-working-in-3d.html): Core scene, mesh, transform, and material patterns.
+- [Built-in interactions](https://iwsdk.dev/guides/06-built-in-interactions.html): Input, pointers, grabbing, and interaction systems.
+- [Custom systems](https://iwsdk.dev/guides/07-custom-systems.html): Build ECS systems and components.
+- [Build and deploy](https://iwsdk.dev/guides/08-build-deploy.html): Production builds, optimized assets, and static deployment.
+- [Browser-first systems](https://iwsdk.dev/guides/16-browser-first-systems.html): Browser-first 3D app patterns without requiring a headset.
+
+## Core Concepts
+
+- [ECS](https://iwsdk.dev/concepts/ecs/): World, entity, component, system, query, lifecycle, and architecture concepts.
+- [Three.js with IWSDK](https://iwsdk.dev/concepts/three-basics/): Three.js interoperability, transforms, meshes, geometry, and materials.
+- [XR input](https://iwsdk.dev/concepts/xr-input/): Input actions, visuals, pointers, stateful gamepads, and XR origin handling.
+- [Locomotion](https://iwsdk.dev/concepts/locomotion/): Slide, teleport, turn, and locomotion performance.
+- [Spatial UI](https://iwsdk.dev/concepts/spatial-ui/): UIKit, UIKitML, layout, documents, and end-to-end spatial UI flow.
+- [Grabbing](https://iwsdk.dev/concepts/grabbing/): Object grabbing and manipulation interaction types.
+
+## API Reference
+
+- [API index](https://iwsdk.dev/api/): Generated TypeDoc reference for IWSDK packages.
+- [Core API](https://iwsdk.dev/api/core/): Core runtime, ECS, world, rendering, and framework APIs.
+- [XR input API](https://iwsdk.dev/api/xr-input/): XR input package reference.
+- [Locomotor API](https://iwsdk.dev/api/locomotor/): Locomotion package reference.
+- [Vite plugin APIs](https://iwsdk.dev/api/vite-plugin-gltf-optimizer/): Build-time plugins and optimization references.
+
+## Examples
+
+- [Examples overview](https://iwsdk.dev/examples/): Example apps covering audio, environment raycast, grab interactions, locomotion, physics, scene understanding, and depth occlusion.
+- [GitHub repository](https://github.com/facebook/immersive-web-sdk): Source code, examples, packages, and issue tracker.
+
+## Optional
+
+- [llms.txt proposal](https://llmstxt.org/index.md): Informal convention used by this file.
+- [AGENTS.md convention](https://agents.md/): Project-level coding-agent instruction convention; separate from this site's public skill entrypoint.