Link the AI-debate cluster by its search phrases, with a Related block

docs/operations.md

@@ -74,6 +74,8 @@ The landing page and the free tools also exist in Hungarian and Spanish, each at
 
 The guide pages in `public/<slug>/index.html` are generated, not hand-edited: run `python3 scripts/generate_seo_content.py` and commit its output. The same command writes the seven comparison and prep pages from [`scripts/seo_comparison_pages.py`](../scripts/seo_comparison_pages.py), each with its own layout, and lists them in `llms.txt`. Those pages link to `/best-ai-for-debate` while that page is still a separate draft; [`scripts/check-site.mjs`](../scripts/check-site.mjs) allows that one missing path until its file exists. Short pages live in its `PAGES` list; pages with long-form copy, their own highlight-card descriptions, and their own FAQs (which also feed the page's FAQPage JSON-LD) live in [`scripts/seo_guides.py`](../scripts/seo_guides.py). Each page's "Related" block shows up to six pages from its own topic cluster and one from each of two other clusters, picked from `CLUSTERS`; every page in `PAGES` must sit in exactly one cluster, and the generator stops when one does not. Paragraphs also get up to three in-body links from `LINK_PHRASES`, specific phrases first; `python3 scripts/generate_seo_content.py --links` lists the links each page got. A guide entry can set a later `modified` date for that page alone; no page is dated earlier than `CONTENT_DATE`, which covers the copy every guide shares, including the related and in-body links, so move it when `CLUSTERS` or `LINK_PHRASES` change. Sections hold paragraphs and `h3`, `steps`, `list`, `table` and `example` blocks, plus a `speech_times` block that builds the speech-times table from the free timer's formats in [`src/lib/free-tools/formats.ts`](../src/lib/free-tools/formats.ts), so the guide and the timer cannot disagree; a guide's `definition` (question, term, text) renders a definition list under the short answer and a `DefinedTerm` in its JSON-LD; paragraphs, list items and table cells can hold Markdown-style links to a site path or, for a primary source, an `https://` URL. A guide can set a `disclosure` line, shown under its byline, and a numbered list: `items` (name, URL) pairs that become an `ItemList` in its JSON-LD, each matched in order by an `h3` that starts "1. Name"; a title with `{item_count}` gets the real count, and the generator stops when the headings and `items` disagree. Every guide needs FAQs of its own in `seo_guides.py`; the generator refuses a page without them, so no two pages share boilerplate questions. [`src/test/seo/guide-content.test.ts`](../src/test/seo/guide-content.test.ts) fails when a guide has fewer than 700 words outside its related and About blocks, or when a sentence longer than 60 characters appears on more than three guides.
 
+The AI-debate cluster (the eight pages in `pages` in [`src/config/ai-debate-cluster.json`](../src/config/ai-debate-cluster.json)) links its pages by the phrases people search for: each page gets a "More on AI debate" block from [`scripts/seo_cluster.py`](../scripts/seo_cluster.py), every `/debateowl-vs-*` page gets its own sentence from `VS_LINES` there pointing to `/best-ai-debate-tools`, and `llms.txt`, the home page's guide hub, and the English footer list the same links from the same file, and the `/tools` pages link `/ai-debate`. A link marked `"live": false` is for a page that does not exist yet and stays hidden everywhere; once the page ships, set it true, rerun the generator and commit the regenerated pages. `check-site.mjs` fails the build if it is switched on before the page exists.
+
 Every guide opens with the reader's main question as its first H2 and an answer of at most 100 words, kept in [`scripts/seo_answers.py`](../scripts/seo_answers.py); the generator refuses a page without one or with a longer answer. Each guide shows visible "Published" and "Updated" dates (`PUBLISHED_DATE` or a `published` key, and the `modified` date) that match its Article JSON-LD. Prices and plan facts are stated "as of" the month in `factsCheckedOn` in `src/config/site.json`; move that date when you recheck them, and the pricing page's About block, `llms.txt` and the landing page follow. Every other guide has a one-line About that links to the landing page and pricing instead of repeating the plan facts. Copy in `seo_guides.py` and `seo_answers.py` that names the month itself (prices and competitor facts) needs the same edit: search those files for "As of". The generator also writes `public/llms.txt`, the plain summary for AI agents. `public/robots.txt` allows AI crawlers by name in their own group, which repeats the private-route rules because a crawler that matches a named group ignores `*`.
 
 To retire a guide, delete its `PAGES` entry, its `CLUSTERS` and `LINK_PHRASES` entries, and its `public/<slug>/` folder (the generator never deletes), add its redirects to `vercel.json`, and repoint any link to it. Two guides that answer the same search should become one page, not two thin ones.

public/ai-debate-case-generator/index.html

@@ -47,6 +47,7 @@
       <section class="section faq article" aria-labelledby="faq"><h2 id="faq">Frequently asked questions</h2><details><summary>Does the case generator write a complete case?</summary><p>It writes a complete draft: an opening, arguments with explanation, evidence and why each matters, &quot;If they say… we answer…&quot; replies, a closing line and the sources it cites. Treat it as a structure to cut, verify and rewrite in your own words.</p></details><details><summary>Are the generated citations reliable?</summary><p>They are research leads. Every draft is researched on the web and lists the sources it cites, and an argument that still needs evidence is marked Needs Source. Open every source, confirm the exact claim and record the full citation before using it.</p></details><details><summary>Which debate formats does the generator support?</summary><p>Set the Current Debate&#x27;s format to British Parliamentary, Policy, Classroom or Custom, and Generate reads it along with the debate&#x27;s Instructions. Generate&#x27;s own speaker roles (introductor, R1, R2 and conclusor) follow the School 4-6-6-3 format. For WSDC, Public Forum and Lincoln-Douglas, use Custom and describe the structure in the Instructions.</p></details><details><summary>Can I change one part of a case without starting over?</summary><p>Yes. Regenerate a single section and the rest of the case stays on screen unchanged.</p></details><details><summary>Can I export a generated case?</summary><p>Yes. Cases export to PDF and DOCX, and cases created in a Current Debate are saved to it automatically.</p></details><details><summary>Is there a free AI debate case generator?</summary><p>DebateOwl&#x27;s case generator is included in the 3-day free trial, with no credit card, and then in Pro at $5/month + tax; there is no permanent free plan. Without an account you can use the free debate timer, motion generator, flow sheet and speech time calculator, but not the case generator.</p></details><details><summary>Can AI write a Public Forum case?</summary><p>It can draft one. Set the Current Debate&#x27;s format to Custom and describe the Public Forum structure in its Instructions, since Generate&#x27;s own speaker roles follow School 4-6-6-3. A PF constructive is four minutes, which usually fits two arguments with evidence, so cut the draft to that and verify every source.</p></details><details><summary>Is using an AI case generator cheating?</summary><p>Using it to draft and research before a round is preparation, but check your league&#x27;s and your school&#x27;s rules first: most leagues forbid electronic help during a round. Verify every source, rewrite the case in your own words and make sure you can defend each argument, because a case you cannot explain is easy to beat.</p></details></section>
     </article>
     <aside class="section article" aria-labelledby="about"><h2 id="about">About DebateOwl</h2><p><a href="/">DebateOwl</a> is an AI debate prep and practice app. See <a href="/">how it works</a> or <a href="/debateowl-pricing">pricing</a>.</p></aside>
+    <section class="section article" aria-labelledby="related-ai-debate"><h2 id="related-ai-debate">More on AI debate</h2><ul><li><a href="/ai-debate">AI debate partner</a></li><li><a href="/ai-debate-practice">AI debate practice</a></li><li><a href="/ai-debate-coach">AI debate coach</a></li><li><a href="/best-ai-debate-tools">best AI debate tools</a></li><li><a href="/best-ai-for-debate">which AI is best for debate</a></li><li><a href="/free-vs-paid-ai-debate-tools">free vs paid AI debate tools</a></li><li><a href="/how-to-prepare-for-a-debate-with-ai">how to prepare for a debate with AI</a></li></ul></section>
     <section class="section article" aria-labelledby="related"><h2 id="related">Related DebateOwl guides</h2><nav class="links" aria-label="Related guides"><a href="/ai-rebuttal-generator">AI Rebuttal Generator for Debate</a>
 <a href="/debate-rebuttal-practice">Practice Rebuttals Before Your Opponent Finds the Weakness</a>
 <a href="/debate-evidence-finder">Find Better Debate Evidence Without Losing the Argument</a>

public/ai-debate-coach/index.html

@@ -47,6 +47,7 @@
       <section class="section faq article" aria-labelledby="faq"><h2 id="faq">Frequently asked questions</h2><details><summary>What can I ask the AI debate coach?</summary><p>Anything you would ask a coach between rounds: what your side has to prove, which argument decides the round, speech structure, how to answer a specific argument, or why a practice speech did not land. Specific questions with format, side and speaker role get the best answers.</p></details><details><summary>Does the coach know my case?</summary><p>It knows your Current Debate: the motion, and the Library sources you have marked active. Paste a speech or a case section into the question when you want feedback on that exact text.</p></details><details><summary>Can the AI coach cite sources?</summary><p>Yes. Turn on Citations in Ask and the answer includes sources you can open. Check each one against the original before using it in a round.</p></details><details><summary>Will the coach write my speeches for me?</summary><p>It can draft an outline or a passage, but you will speak better from structure you understand. Use it to find what is missing, then write the speech in your own words.</p></details><details><summary>How is this different from a general AI chatbot?</summary><p>The coach works inside one debate at a time, so it keeps your motion, debate settings and sources in context, and it is set up for debate questions rather than essays.</p></details><details><summary>Is there a free AI debate coach?</summary><p>Not a permanent one in DebateOwl. The Ask coach comes with the app&#x27;s 3-day free trial, no credit card needed, and after that with Pro at $5/month + tax. The tools you can use free without an account, the debate timer, motion generator, flow sheet and speech time calculator, do not include coaching.</p></details><details><summary>Can an AI judge my debate speech?</summary><p>Partly. Sparring rounds end with a judged verdict that names the reason for the decision, and the Ask coach can tell you what was unclear, under-warranted or dropped in a speech you paste in. It has not watched you speak and does not know the judges at your tournament, so treat its verdict as practice feedback, not a prediction of a real ballot.</p></details></section>
     </article>
     <aside class="section article" aria-labelledby="about"><h2 id="about">About DebateOwl</h2><p><a href="/">DebateOwl</a> is an AI debate prep and practice app. See <a href="/">how it works</a> or <a href="/debateowl-pricing">pricing</a>.</p></aside>
+    <section class="section article" aria-labelledby="related-ai-debate"><h2 id="related-ai-debate">More on AI debate</h2><ul><li><a href="/ai-debate">AI debate partner</a></li><li><a href="/ai-debate-practice">AI debate practice</a></li><li><a href="/best-ai-debate-tools">best AI debate tools</a></li><li><a href="/best-ai-for-debate">which AI is best for debate</a></li><li><a href="/ai-debate-case-generator">AI debate generator</a></li><li><a href="/free-vs-paid-ai-debate-tools">free vs paid AI debate tools</a></li><li><a href="/how-to-prepare-for-a-debate-with-ai">how to prepare for a debate with AI</a></li></ul></section>
     <section class="section article" aria-labelledby="related"><h2 id="related">Related DebateOwl guides</h2><nav class="links" aria-label="Related guides"><a href="/ai-debate-case-generator">AI debate generator for cases with citations</a>
 <a href="/ai-rebuttal-generator">AI Rebuttal Generator for Debate</a>
 <a href="/debate-rebuttal-practice">Practice Rebuttals Before Your Opponent Finds the Weakness</a>

public/ai-debate-practice/index.html

@@ -47,6 +47,7 @@
       <section class="section faq article" aria-labelledby="faq"><h2 id="faq">Frequently asked questions</h2><details><summary>What is AI debate practice?</summary><p>A practice round against an AI opponent that answers your speeches. In DebateOwl it is a Sparring round in School 4-6-6-3, Lincoln-Douglas or Public Forum, at real speech times, ending in a scorecard and a verdict.</p></details><details><summary>What is on the scorecard?</summary><p>A score for you and for the AI opponent out of 100, split into Logic, Evidence, Delivery and Strategy at 25 each, with a note on every score, the judge&#x27;s verdict, key moments and what to work on next.</p></details><details><summary>Which AI can I practise debate against?</summary><p>DebateOwl&#x27;s Sparring gives you an AI opponent for full timed rounds. Debate Ladder also puts you against an AI by voice, and ChatGPT or Claude will argue back in a chat if you set them up. The best AI debate tools page compares more options.</p></details><details><summary>Which formats can I spar against the AI in?</summary><p>Sparring runs School 4-6-6-3, Lincoln-Douglas and Public Forum rounds with their speech order and times. For WSDC, British Parliamentary and other formats you can still generate cases, get coaching and drill rebuttals, and time speeches yourself.</p></details><details><summary>Can I give my practice speeches out loud?</summary><p>Yes. Sparring and Crossfire can run as spoken rounds in the browser, so you can practise delivery as well as content.</p></details><details><summary>How often should I practise against an AI opponent?</summary><p>Two or three focused sessions a week usually beats one long one. Each session should end with one specific fix that you drill before the next round.</p></details><details><summary>Does AI practice replace a coach or real rounds?</summary><p>No. It adds repetitions between team practices. Judge adaptation, delivery under pressure and strategic judgement still develop fastest with people.</p></details><details><summary>Is AI debate prep better than traditional prep?</summary><p>Neither is better on its own. AI is faster at outlines, block drafts and evidence leads; reading sources, coaching and real rounds build the judgement AI drafts lack.</p></details><details><summary>Are my practice rounds private?</summary><p>Yes. Rounds, verdicts and debriefs are saved to your account inside the Current Debate they belong to, behind sign-in. Search engines only see these public guides.</p></details></section>
     </article>
     <aside class="section article" aria-labelledby="about"><h2 id="about">About DebateOwl</h2><p><a href="/">DebateOwl</a> is an AI debate prep and practice app. See <a href="/">how it works</a> or <a href="/debateowl-pricing">pricing</a>.</p></aside>
+    <section class="section article" aria-labelledby="related-ai-debate"><h2 id="related-ai-debate">More on AI debate</h2><ul><li><a href="/ai-debate">AI debate partner</a></li><li><a href="/ai-debate-coach">AI debate coach</a></li><li><a href="/best-ai-debate-tools">best AI debate tools</a></li><li><a href="/best-ai-for-debate">which AI is best for debate</a></li><li><a href="/ai-debate-case-generator">AI debate generator</a></li><li><a href="/free-vs-paid-ai-debate-tools">free vs paid AI debate tools</a></li><li><a href="/how-to-prepare-for-a-debate-with-ai">how to prepare for a debate with AI</a></li></ul></section>
     <section class="section article" aria-labelledby="related"><h2 id="related">Related DebateOwl guides</h2><nav class="links" aria-label="Related guides"><a href="/best-ai-for-debate">Which AI is best for debate?</a>
 <a href="/ai-debate-coach">AI debate coach for your motion, side and speech</a>
 <a href="/ai-debate-case-generator">AI debate generator for cases with citations</a>

public/best-ai-debate-tools/index.html

@@ -48,6 +48,7 @@
       <section class="section faq article" aria-labelledby="faq"><h2 id="faq">Frequently asked questions</h2><details><summary>What is the best AI tool for debate?</summary><p>Our top pick is DebateOwl, for preparing a specific motion: a case you can read out loud, &quot;If they say X, we answer Y&quot; replies and timed practice rounds. We make it, so test it yourself. WinDebate suits Policy, Congress and live-round review, PublicForumAI suits Public Forum, and general chatbots suit open brainstorming.</p></details><details><summary>Why is DebateOwl ranked first?</summary><p>Because we think it fits the most common job, getting one motion ready for a round, better than the others: case, replies and a timed, scored round in one place, in English, Spanish or Hungarian. We make DebateOwl, so the ranking is our editorial pick, and every fact about the other tools links to their own site.</p></details><details><summary>Is a general chatbot good enough for debate prep?</summary><p>For brainstorming and explaining concepts, often yes. It is weaker at keeping a motion, side and format in context, predicting the opposing case, timing speeches and giving round-style feedback.</p></details><details><summary>Are free AI debate tools enough?</summary><p>Free tiers are a good way to run the comparison test. Check the daily or monthly limits against how many practice sessions you plan before a tournament.</p></details><details><summary>Can I use AI tools during a debate round?</summary><p>Usually not. Most leagues restrict or ban internet access and electronic help during rounds. Check your league&#x27;s rules, and use AI tools for preparation.</p></details><details><summary>What are the alternatives to DebateOwl?</summary><p>General chatbots, AI research assistants, other dedicated debate platforms, and simple practice utilities such as timers and flowing templates. Run the one-hour test above on DebateOwl and on each alternative you are considering.</p></details><details><summary>How should I compare AI debate tools fairly?</summary><p>Give every tool the same motion and the same tasks, such as a case, the strongest counter, feedback on your speech and evidence for one claim, then score each answer against the same criteria.</p></details></section>
     </article>
     <aside class="section article" aria-labelledby="about"><h2 id="about">About DebateOwl</h2><p><a href="/">DebateOwl</a> is an AI debate prep and practice app. See <a href="/">how it works</a> or <a href="/debateowl-pricing">pricing</a>.</p></aside>
+    <section class="section article" aria-labelledby="related-ai-debate"><h2 id="related-ai-debate">More on AI debate</h2><ul><li><a href="/ai-debate">AI debate partner</a></li><li><a href="/ai-debate-practice">AI debate practice</a></li><li><a href="/ai-debate-coach">AI debate coach</a></li><li><a href="/best-ai-for-debate">which AI is best for debate</a></li><li><a href="/ai-debate-case-generator">AI debate generator</a></li><li><a href="/free-vs-paid-ai-debate-tools">free vs paid AI debate tools</a></li><li><a href="/how-to-prepare-for-a-debate-with-ai">how to prepare for a debate with AI</a></li></ul></section>
     <section class="section article" aria-labelledby="related"><h2 id="related">Related DebateOwl guides</h2><nav class="links" aria-label="Related guides"><a href="/best-ai-for-debate">Which AI is best for debate?</a>
 <a href="/debateowl-vs-chatgpt">DebateOwl vs ChatGPT for Debate Prep</a>
 <a href="/debateowl-vs-debateclub">DebateOwl vs DebateClub</a>