{
  "version": "v1",
  "format": "flax-agent-prompt-recipes",
  "documentation": "https://flaxsites.com/docs/agents",
  "agentConfiguration": "https://flaxsites.com/.well-known/flax-agent.json",
  "purpose": "Copy-ready prompts for safe, site-scoped Flax agent workflows.",
  "variables": {
    "siteUrl": "The exact website origin named by the user, including https://.",
    "changeRequest": "The user’s requested content or presentation change."
  },
  "safetyDefaults": [
    "Start with the exact named site origin and follow its site-scoped MCP discovery document.",
    "Read the current model and model hash before proposing a change.",
    "Ask before requesting optional analytics access.",
    "Validate before creating a draft.",
    "Never ask the user to paste a password, magic code, or access token into chat.",
    "Never publish; the site owner reviews and approves deployment in Flax."
  ],
  "recipes": [
    {
      "id": "site-stats-summary",
      "title": "Get and summarise site stats",
      "summary": "Explain the latest site performance numbers and the most useful next actions.",
      "scope": "analytics-opt-in",
      "requires": ["siteUrl"],
      "prompt": "Get the latest stats for my Flax site at {{siteUrl}} and show the key numbers in a compact visual summary. Then explain the important points briefly. Compare them with the previous period if available, highlight the most important changes and possible reasons, and recommend the three best next actions. Ask for permission before using optional analytics data if needed. Do not change anything yet."
    },
    {
      "id": "homepage-performance-benchmark",
      "title": "Benchmark homepage performance",
      "summary": "Create a baseline scorecard for homepage visibility, experience, and conversion readiness.",
      "scope": "analytics-opt-in",
      "requires": ["siteUrl"],
      "prompt": "Benchmark the homepage performance of my Flax site at {{siteUrl}} across visitor activity, search visibility, clarity, trust, accessibility, and conversion readiness. Ask for permission before using optional analytics data, then compare available homepage stats and search performance with previous periods or sensible benchmarks. Score each area, explain the evidence, separate measured facts from judgement, and return the biggest gaps plus a prioritised action plan. Do not change anything yet."
    },
    {
      "id": "competitor-analysis",
      "title": "Analyse my competitors",
      "summary": "Compare relevant competitors with my site and identify the biggest opportunities.",
      "scope": "read-only",
      "requires": ["siteUrl"],
      "prompt": "Analyse my competitors online for my Flax site at {{siteUrl}}. First identify suitable competitors from my business, location, services, and existing site information, and explain why each is relevant. Compare their positioning, services, content, local visibility, trust signals, and conversion paths with my site. Separate observed facts from assumptions, cite your sources, save a reusable report, and recommend the three biggest opportunities. Do not change anything yet."
    },
    {
      "id": "online-growth-suggestions",
      "title": "Suggest ways to grow online",
      "summary": "Create a broad, prioritised growth plan across the site and wider online presence.",
      "scope": "analytics-opt-in",
      "requires": ["siteUrl"],
      "prompt": "Give me practical suggestions of any kind to grow the business behind my Flax site at {{siteUrl}}. Review my site, business, services, audience, and available performance data, asking first before using optional analytics. Consider SEO, content, local search, conversion, reviews, email, social media, and partnerships. Prioritise the ideas by likely impact, effort, evidence, and safest next step, including ideas that do not require website changes. Do not change anything yet."
    },
    {
      "id": "site-health-review",
      "title": "Review my site",
      "summary": "Find the three highest-impact improvements without changing anything.",
      "scope": "read-only",
      "requires": ["siteUrl"],
      "prompt": "Review my Flax site at {{siteUrl}}. Start with that exact site origin, read the current model and model hash, and identify the three highest-impact improvements across content, structure, and conversion. Explain the evidence for each recommendation. Do not change anything yet."
    },
    {
      "id": "seo-content-review",
      "title": "Review SEO and content",
      "summary": "Assess the current site copy and produce a prioritized content brief.",
      "scope": "read-only",
      "requires": ["siteUrl"],
      "prompt": "Review the SEO and content of my Flax site at {{siteUrl}}. Read the current model first, preserve the site’s existing voice, and return a prioritized brief covering page titles, headings, descriptions, internal links, and missing content opportunities. Do not edit the site."
    },
    {
      "id": "focused-update-draft",
      "title": "Prepare a focused update",
      "summary": "Explain, validate, and draft one approved content change for preview.",
      "scope": "draft-after-confirmation",
      "requires": ["siteUrl", "changeRequest"],
      "prompt": "For my Flax site at {{siteUrl}}, handle this request: {{changeRequest}}. Read the current model and hash, explain the exact proposed operations, and wait for my confirmation. After I confirm, validate the plan against the current model and create a previewable draft only. Never publish."
    },
    {
      "id": "analytics-opportunity-review",
      "title": "Find growth opportunities",
      "summary": "Use aggregate performance data only after the user opts in.",
      "scope": "analytics-opt-in",
      "requires": ["siteUrl"],
      "prompt": "Find growth opportunities for my Flax site at {{siteUrl}}. First read the site model and explain which optional analytics permission would help. Ask for my approval before requesting it. If approved, use only aggregate performance data together with the model, then recommend the next three experiments. Do not make changes yet."
    },
    {
      "id": "article-draft",
      "title": "Draft an article",
      "summary": "Prepare an article draft while keeping publishing under owner control.",
      "scope": "draft-after-confirmation",
      "requires": ["siteUrl", "changeRequest"],
      "prompt": "For my Flax site at {{siteUrl}}, draft an article based on this brief: {{changeRequest}}. Read the current model and existing articles first, match the site’s language and tone, and show me the proposed title, summary, body, and metadata. Wait for my confirmation before creating a draft. Never publish."
    }
  ]
}