edit-site

Edit a Flint Site

Help the user modify a Flint website by running a background AI agent.

Workflow

1. Find the site: Call list_sites to get the user's available sites. If $ARGUMENTS contains a site name, match it. If there are multiple sites and the user didn't specify, ask which one.

2. Run the agent: Call run_background_agent with the site ID and a prompt describing the changes.

   • Describe goals and intent, not implementation details
   • If the user provided code, examples, or reference material, pass them through as-is
   • Do NOT generate HTML, CSS, or markup — Flint is an expert designer and produces better results with creative freedom

3. Monitor progress: Call check_background_agent_status to track the agent.

   • Wait 90-120 seconds between status checks
   • A single agent typically finishes in 4-5 minutes
   • Multiple concurrent agents take longer (10 agents may take ~15 minutes)

4. Report results: When complete, share the summary of changes and the preview URL.

Important guidelines

• Flint is an expert web designer. Describe what you want, not how to build it.
• Always honor the user's explicit requests (e.g., "make the header black", "use a three-column grid") — pass that intent through.
• Only use publish_site if the user explicitly asks to publish or deploy. It deploys the entire site.