{
  "articles": [
    {
      "url": "/2026/07/02/external-content-root/",
      "title": "Configuring an external content root",
      "excerpt": "Refined-X loads collections from a configurable contentRoot so a vault or monorepo publish folder can stay outside the site package.",
      "tags": [
        "refined-x",
        "configuration"
      ],
      "series": "building",
      "seriesName": "Building",
      "date": "2026-07-02"
    },
    {
      "url": "/2026/07/01/welcome-to-refined-x/",
      "title": "Welcome to Refined-X",
      "excerpt": "Refined-X is an Astro + Starlight starter for personal public sites with an opinionated content schema and machine-readable surfaces such as llms.txt, OpenAPI, and MCP discovery.",
      "tags": [
        "refined-x",
        "agents",
        "publishing"
      ],
      "series": "notes",
      "seriesName": "Notes",
      "date": "2026-07-01"
    }
  ],
  "answers": [
    {
      "url": "/answers/external-content-vault/",
      "q": "Can I keep content in an external vault?",
      "a": "Yes. Point Refined-X at an external contentRoot through an instance config, and keep the publishing template separate from your source repository or knowledge vault.",
      "full": "**Yes.** Configure `contentRoot` in an `instance.config.mjs` overlay, or select that overlay with `REFINED_X_INSTANCE_CONFIG`. The content can remain in a separate repository, monorepo, or knowledge vault while Refined-X acts only as the publishing layer.\n\nYou can also configure `publicDir`, `outDir`, and an optional asset source. Keeping instance-specific paths and identity outside the template lets you update Refined-X without moving or overwriting the source content."
    },
    {
      "url": "/answers/collaborate/",
      "q": "How can I collaborate?",
      "a": "Reach out via the contact details on the about page for architecture reviews, publishing setups, or open-source work.",
      "full": "Update `content/profile/cooperation.yaml` and this answer when you publish a real collaboration policy."
    },
    {
      "url": "/answers/live-ask/",
      "q": "How does Live Ask work?",
      "a": "Live Ask is an optional Worker that retrieves this site's public content and can generate source-grounded summaries through restricted browser and MCP interfaces.",
      "full": "The site starts with static Ask: exact curated questions and related articles work without a model, database, or runtime service. **Live Ask** is an optional sibling Worker that retrieves the site’s public content and can generate a summary grounded in returned sources.\n\nIts browser interface uses verification, quotas, and rate limits; its MCP interface exposes a restricted `ask` tool. Live Ask does not provide long-term memory, arbitrary external actions, elicitation, or impersonation of the site owner."
    },
    {
      "url": "/answers/agent-ready/",
      "q": "How is Refined-X agent-ready?",
      "a": "Refined-X gives agents predictable Markdown, llms.txt, JSON, OpenAPI, MCP discovery, and optional Ask surfaces generated from the same public content.",
      "full": "Refined-X publishes the same public content through predictable interfaces: per-page Markdown mirrors, `llms.txt`, `llms-full.txt`, structured JSON APIs, OpenAPI, and MCP discovery metadata. This reduces the amount of navigation and page layout an agent must interpret before it can find citable material.\n\nThe optional Ask service adds grounded retrieval and summarization without changing the source corpus. “Agent-ready” means the site is easier to ingest and connect; it does not promise that every agent will automatically discover or invoke these interfaces."
    },
    {
      "url": "/answers/what-is-refined-x/",
      "q": "What is Refined-X?",
      "a": "Refined-X is a static-first personal publishing starter for Astro and Starlight that turns one public corpus into an editorial website and agent-readable surfaces.",
      "full": "**Refined-X** is an opinionated, static-first personal publishing starter built with Astro and Starlight. You write public content in Markdown and YAML, and the same corpus becomes an editorial website for people plus structured, machine-readable surfaces for search engines and AI agents.\n\nThe static site works on its own. Live AI features are optional, so you can begin with normal static hosting and add conversational access only when it is useful."
    },
    {
      "url": "/answers/who-is-author/",
      "q": "Who is the author?",
      "a": "Demo Author is the sample persona for this starter — replace the profile YAML with your own identity.",
      "full": "**Demo Author** is placeholder identity data. Edit `content/profile/person.yaml` and `content/profile/resume.md` to publish your own about page."
    }
  ],
  "items": [
    {
      "type": "article",
      "url": "/2026/07/02/external-content-root/",
      "title": "Configuring an external content root",
      "excerpt": "Refined-X loads collections from a configurable contentRoot so a vault or monorepo publish folder can stay outside the site package.",
      "tags": [
        "refined-x",
        "configuration"
      ],
      "series": "building",
      "seriesName": "Building",
      "date": "2026-07-02"
    },
    {
      "type": "article",
      "url": "/2026/07/01/welcome-to-refined-x/",
      "title": "Welcome to Refined-X",
      "excerpt": "Refined-X is an Astro + Starlight starter for personal public sites with an opinionated content schema and machine-readable surfaces such as llms.txt, OpenAPI, and MCP discovery.",
      "tags": [
        "refined-x",
        "agents",
        "publishing"
      ],
      "series": "notes",
      "seriesName": "Notes",
      "date": "2026-07-01"
    },
    {
      "type": "answer",
      "title": "Can I keep content in an external vault?",
      "excerpt": "Yes. Point Refined-X at an external contentRoot through an instance config, and keep the publishing template separate from your source repository or knowledge vault.",
      "url": "/answers/external-content-vault/"
    },
    {
      "type": "answer",
      "title": "How can I collaborate?",
      "excerpt": "Reach out via the contact details on the about page for architecture reviews, publishing setups, or open-source work.",
      "url": "/answers/collaborate/"
    },
    {
      "type": "answer",
      "title": "How does Live Ask work?",
      "excerpt": "Live Ask is an optional Worker that retrieves this site's public content and can generate source-grounded summaries through restricted browser and MCP interfaces.",
      "url": "/answers/live-ask/"
    },
    {
      "type": "answer",
      "title": "How is Refined-X agent-ready?",
      "excerpt": "Refined-X gives agents predictable Markdown, llms.txt, JSON, OpenAPI, MCP discovery, and optional Ask surfaces generated from the same public content.",
      "url": "/answers/agent-ready/"
    },
    {
      "type": "answer",
      "title": "What is Refined-X?",
      "excerpt": "Refined-X is a static-first personal publishing starter for Astro and Starlight that turns one public corpus into an editorial website and agent-readable surfaces.",
      "url": "/answers/what-is-refined-x/"
    },
    {
      "type": "answer",
      "title": "Who is the author?",
      "excerpt": "Demo Author is the sample persona for this starter — replace the profile YAML with your own identity.",
      "url": "/answers/who-is-author/"
    }
  ]
}