> Content index: https://quillly.com/docs/llms.txt > Canonical page: https://quillly.com/docs/first-session --- title: Your First Session with Quillly: Prompts and Rules description: How your first session with Quillly starts, prompts for posts, SEO fixes, goals and directories, what Quillly refuses, and how Agent Notes keep memory. keywords: first session, example prompts published: 2026-09-24 updated: 2026-09-24 url: https://quillly.com/docs/first-session word_count: 1666 --- # Your first session > See how your AI starts a Quillly session, prompts for posts, SEO fixes, goals and directories, what Quillly refuses, and how Agent Notes keep memory. Canonical: https://quillly.com/docs/first-session Published: 2026-09-24 Your first session starts once your AI app is connected: you ask in plain words, and your AI does the work in Quillly. This page shows how a session starts, prompts for common jobs, what Quillly will not let your AI do, and how it remembers between sessions. **Before you start**, you need: - An AI app connected to Quillly with a key from **Connections**. [Connect your AI](https://quillly.com/docs/connect-your-ai) shows how. - At least one website in Quillly. [Open Connections](https://quillly.com/dashboard/connections) ## How your first session starts ![How a Quillly session runs: list_websites, then get_content_strategy, then a draft, the SEO fixes, and publishing once the score clears the minimum](https://quillly.com/serve/v1/019c64a2-a62f-7793-aa68-2c78316d3309/images/449c40ddf1e82bd5081841d091172c7803462aa5.webp) Your AI reaches Quillly through the [Model Context Protocol](https://modelcontextprotocol.io) (MCP). It starts every session the same way, even when your prompt is one line: 1. It calls `list_websites`. With one website, it uses that one. With several, it asks you which one. 2. It calls `get_content_strategy` for that website. The answer is the session brief, built from your website's own data. The brief holds: - **The plan** (`next_actions`): this session's steps, in order. Your AI follows them unless you ask for something else. - **The limits** (`policy`): the minimum SEO score to publish, 85 unless you change it, and the hardest keyword to target. By default, a session spends up to 6 research credits, writes 1 new post and leaves posts edited in the last 14 days alone. - **How to write and what you sell** (`writing_brief`, `brand_brief`). The product facts come from your submission kit on **Domain Rating**, when you have filled it in. - **Your rules and notes** (`guardrails`, `session_notes`) from **Agent Notes**, and your saved keywords from **Focus list**. - **A closing checklist** (`session_checklist`) your AI goes through before it tells you it is done. You do not need to explain the process, even in your first session: "Write a blog post for acme.com" runs the whole plan. ## Example prompts for common jobs Type these as you would ask a colleague, with your own website in place of `acme.com`. ### Write a post ```text Write a blog post for acme.com and publish it. ``` Your AI picks a keyword from your saved keywords first, and researches new ones only when none fits. Research spends credits, and your AI keeps to the session's budget. It writes a draft, applies the SEO fixes and publishes when the score clears your minimum. Then it tells you the URL, the score and each credit it spent. To check the post yourself first, add "Keep it as a draft." > [!NOTE] > A new post also changes older ones. To help search engines find it, your AI adds links to it from two or three of your published posts. ### Fix a low score ```text Find the lowest-scoring post on acme.com and fix it. ``` Your AI lists your posts by score with `bulk_seo_audit` and gets the fixes for the weakest with `get_blog_seo_patches`. It applies them in one `update_content` call and checks the new score with `check_blog_seo`. A published post stays live while your AI edits it. ### Add a goal ```text Add a goal called signup on acme.com and count it as a conversion. ``` Your AI saves the goal with `manage_analytics_goal`. The Quillly tracker on your website sends it when a visitor signs up: add `qa('goal', 'signup')` to your code, or `data-qa-goal="signup"` to the button. As a conversion, the goal marks each visitor who completes it as a **Customer** in **Analytics**. Goals need an Analytics or Content + Analytics plan. ### Check directory progress ```text Which directories is acme.com listed on, and what launches next? ``` Your AI reads each directory's state with `list_directories`: **Not submitted**, **Planned**, **Submitted**, **Live** or **Needs attention**. **Needs attention** means a submission is waiting on you, such as an email to verify. `get_launch_plan` lists the launches scheduled for each day. ## What Quillly will not let your AI do Quillly checks these on its own server, whichever AI app you use: - **Publish below your minimum score.** Quillly's instructions tell your AI to override this only when you ask it to publish anyway. - **Publish a page with a broken link.** There is no override, not even when you ask. - **Use a switched-off tool.** A tool can be off for the connection on **Connections**, or for your role in your organization's **Agent tools** settings. - **Use a tool outside your plan.** Quillly tells your AI which product the tool belongs to. Nothing runs and nothing is billed. - **Go over your limits.** A call over your calls a day, calls a minute or research credits does not run. - **Work on someone else's website.** Each call checks that the website is yours or shared with your organization. When your trial ends without a plan, your AI can still see your websites and work on directory submissions. It cannot write, publish, research or read analytics until you choose a plan. ## How your AI remembers between sessions Each session starts fresh. What your AI must remember goes into **Agent Notes**, which every session reads first. ![The Agent Notes page in Quillly with a handoff written by Claude, a guardrail, a decision and a resolved note](https://quillly.com/serve/v1/019c64a2-a62f-7793-aa68-2c78316d3309/images/a762048143d85f066dfde89156fd19226e1b9517.webp) - **Your AI writes notes** with `update_website_note`. A **Handoff** is work for the next session, a **Decision** records a choice and its reason, a **Guardrail** is a rule every session must obey, and a **Note** is context. - **Notes show who wrote them.** A note from your AI carries its connection's name, such as Claude. - **You can write notes too.** Open **Agent Notes** under **Growth** and click **Add note**. Resolve a note when it no longer applies, and your AI stops reading it. Deleting a note is possible only on this page. - **Limits are settings, not notes.** Ask "Don't publish anything under 90 on acme.com", and your AI saves the change with `update_website_settings`. Every later session then uses it. These limits have no screen in the dashboard. On a website shared with your organization, changing them needs the Admin role by default. [Open Agent Notes](https://quillly.com/dashboard/notes) ## Common questions ### Do I have to tell my AI which tools to use? No. Describe the result you want, and your AI picks the tools, as the [MCP specification](https://modelcontextprotocol.io/specification/2026-07-28/server/tools) intends. The session brief and each tool's answer tell it what to do next. ### Why does my AI ask which website to use? You have more than one website, and Quillly tells your AI never to guess which one you mean. Name the website in your prompt, such as acme.com, to skip the question. With a single website, your AI uses it without asking. ### Does my AI remember our last session? Only what is in **Agent Notes** and in your account, such as your posts, scores and saved keywords. The plan ends with a handoff note, so the next session knows what was done and what comes next. ## Related - [Connect your AI](https://quillly.com/docs/connect-your-ai): the apps you can use and how to connect them. - [API keys, OAuth and tool access](https://quillly.com/docs/api-keys): switch tools off for a key and check your limits. - [Plans, trial and limits](https://quillly.com/docs/plans): research credits and calls a day for each plan.