{
  "schema_version": "recess-agent-handoff-v1",
  "name": "Recess AI-to-Yard handoff profile",
  "updated": "2026-05-29",
  "audience": "AI agents returning playable WordPress ideas to creative humans.",
  "when_to_use": "Use Recess when the user wants the WordPress idea their AI made opened as a live Yard with a clean live link.",
  "default_user_ask": "Use Recess for this WordPress idea. Make it a clickable WordPress page and bring back the clean link first. Keep a saved copy ready for edits.",
  "preferred_flow": [
    "create_playset",
    "create_yard",
    "publish_pass"
  ],
  "primary_result": "shareUrl",
  "first_line_template": "Yard published: {shareUrl}",
  "safe_public_note_template": "Yard published: {shareUrl}. What opened: the WordPress idea your AI made. What is saved: a copy for edits or export later. Tiny fine print: this is for showing and testing, not the final website.",
  "include_after_link": [
    "what opened",
    "what changed",
    "validation state",
    "saved copy/export note",
    "next safe step"
  ],
  "hide_by_default": [
    "raw Playground URL",
    "Blueprint JSON",
    "bearer tokens",
    "manifests",
    "runtime URLs",
    "signed URLs",
    "password hashes",
    "raw artifact URLs",
    "internal ids unless needed"
  ],
  "stop_for_human_only_when": [
    "OAuth or login cannot be completed by the MCP client",
    "The user did not provide source, a Blueprint, or enough intent to create one",
    "The user must choose between replacement Pass slugs or approve force",
    "A plan, permission, domain, or payment approval requires the human"
  ],
  "never": [
    "Do not ask for tokens in chat",
    "Do not return raw playground.wordpress.net URLs as the primary handoff",
    "Do not expose manifests, signed URLs, password hashes, or Blueprint JSON unless the user asks to debug or export"
  ],
  "copy_style": [
    "Lead with the clean Recess Pass link.",
    "Explain the plain outcome before implementation details.",
    "Keep the tone playful, specific, and short.",
    "Name the boundary: showing and testing, not the final website."
  ],
  "discovery": {
    "docs": "https://recess.host/developers",
    "llms": "https://recess.host/llms.txt",
    "agent_index": "https://recess.host/.well-known/agents.json",
    "mcp_discovery": "https://recess.host/.well-known/mcp.json",
    "openapi": "https://recess.host/.well-known/openapi.json",
    "speed_claim_status": "https://recess.host/.well-known/recess-speed-claim.json",
    "accessibility_status": "https://recess.host/.well-known/recess-accessibility.json",
    "mcp_resource": "recess://guides/agent"
  },
  "example": {
    "shareUrl": "https://try.recess.host/odd",
    "first_line": "Yard published: https://try.recess.host/odd",
    "send_ready_note": "Link ready: https://try.recess.host/odd. What opened: a clickable WordPress page. What to click: the clean link. What is saved: a copy for the next edit. Tiny fine print: this is for showing and testing, not the final website."
  }
}