📚 CARDS: Crowdsourced Annotated Research for Debating Solutions

• 🖍️ Auto-Highlight Agents: agents highlight and underline as many words as needed on a slider, multiple options
• 🔎 Full-text search: across thousands of tagged, annotated evidence cards spanning policy, LD, PF, and college formats
• 🤖 AI-powered annotation: one-click summaries, warrant extensions, and logic-flaw detection per card
• 📖 Three reading modes: plain text, highlighted tags, and underline-only for fast cutting
• 📎 Citation auto-formatter: and one-click flow integration — paste directly into your speech doc
• 📱 Mobile-responsive: with full-screen card overlays for reading on the go
• 📝 Auto-Research Outlines: agents outline the topic to keyphrases and monitor for new quotes

⚖️ FIAT: Forum for Issue Analysis on Topics

• 🧠 Recommendation Agents: AI assists with research, summarization, flaw detection, and comparative quote analysis
• 🧑‍⚖️ Judge Decision: agents prompts recommend multiple judge decision options, speech to flow, quote to response options
• 📊 Multi-column flow spreadsheet: format-specific speech columns for PF, LD, Policy, and NDT with inline editing
• 🔗 Shareable round URLs: every round gets a permanent link; share with judges or teammates instantly
• 🏆 Round management: tournament setup, team pairing, judge assignments, and round notes in one place
• 📄 Speech docs: full markdown editor per speech with email sharing to judges and coaches
• ⏱️ Smart timers: format-aware prep and speech timers with audio/visual alerts and auto-advance
• 👥 Collaboration: invite judges and spectators by email; view-only and edit roles supported
• 🗄️ Archive system: save, browse, and restore any past round with full flow history
• 📲 Mobile-optimized: responsive design with swipe navigation between speech columns

🎥 LEARN: Lectures from Educators, Archive of Rounds & Notes

• 🎓 ~1,400 college NDT rounds: dating back to 1995, averaging 50+ new rounds per year, including every recent TOC and NDT elimination round
• 🗣️ ~350 Public Forum rounds: (2015–present), ~125 Policy rounds: (2003–present), ~90 LD rounds (2019–present)
• 📺 ~900 instructional videos: across 20 categories: topic lectures, camp coaching, kritik theory, counterplans, impact calc, novice intro, speaking & delivery, and more
• ⭐ ~100 hand-curated top picks: the highest-value rounds and lectures selected for study
• 🔍 Searchable grid with filter by title, channel, year, or view count; inline YouTube playback with thumbnails
• 📘 200-term Debate Dictionary: with plain-English definitions for theory, kritik, and procedural jargon
• 🏅 26 years of national champion records: (2000–2025) across NDT, Policy, LD, and PF
• 📈 Team Rankings: TOC bid list + DebateDrills Elo dual ranking system

🔎 STREAM: Search with Top Result Extraction & Answer Model

• 🔍 Web Search: 70+ popular sites search across 10 categories: Web Search, Academic, Videos, Images, Files, News, etc
• 📝 Article Preview: Extract, format with APA cite, and summarize articles, PDFs, Youtube, and URLs before reading them
• 🤖 User Choice of LLM: OpenAI, Claude, Gemini, Groq, Ollama, Anthropic, etc
• 📄 File Upload Support: Ask questions about PDFs, URLs, DOCX, Google Docs, and Youtube
• 📚 Search History: All searches saved with memories, except for privacy mode
• ❓ Follow-up Questions: Generate follow-up questions to ask language models

📝 REASON: CardMirror Research Editor for Annotated Summaries in Outline Notation

/reason-editor and every speech-doc panel run on debate-editor — the ported-in CardMirror ProseMirror engine, packing roughly 500 editing commands into ~30 thematic groups. Highlights (full 50+ feature list in the package README):

Document & files

• 📝 Structured outline: pockets, hats, blocks, tags, cards, analytics, and undertags as first-class node types, with footnotes, tables, and live/transcluded zones
• 💾 Lossless .docx and .cmir round-trip: Verbatim Word interop plus a native gzip save format, including encrypted-.docx decryption and damaged-file salvage
• 🔁 Bulk conversion & compression, automatic style cleanup on import, and a headless cardmirror-read CLI/MCP tool for AI-assistant access to files outside the app

Cutting & formatting

• 🏷️ One-click structural styles: Pocket, Hat, Block, Tag, Analytic, Undertag, plus citation/underline/emphasis marks and acronym-aware variants
• 🎨 Highlight, shading, and font-color pickers with standardization commands, a paintbrush mode, and highlight locking
• 🔢 Card numbering, multiple condense modes, and a full editing-utilities set (shrink/regrow, short cites, live-zone refresh, heading move/copy/delete)

Collaboration & workflow

• 👥 Real-time collaboration (CRDT-backed via Loro) with share codes, invite links, and version recovery
• 🎤 Speech-doc targeting: mark a doc as the live send target and send content at cursor or at end, with a persistent send history
• 🌊 Flow integration: send cards or headings straight to a Flow column or cell, or pull content back
• 📇 Dropzone card exchange, Quick Cards, and a unified command-bar search across cards, commands, settings, and ~50 other site tools

AI, learning & chrome

• 🤖 AI tools: ask-about-selection, AI-generated citations, translation, and AI-assisted text/formatting repair
• 🗂️ Flashcards with spaced-repetition review, a card cutter panel, voice dictation, and a reading-marker mode
• 🧩 Runtime plugin registry, a 12-category menu bar, customizable keybindings, and per-user preferences synced to account settings
• 🖥️ Native desktop/mobile wrapper (Tauri) running the identical editor with no browser chrome

Research & Evidence

• Evidence Library — Search shared cut cards and reusable analytics by keyword, citation, argument, topic, or tag.
• Argument Library — Browse shared research through topic folders, case areas, and tag-based collections.
• Contributions Feed — Submit, like, save, and endorse community cards, summaries, highlights, and annotations.
• LLM Card Scoring — Score cards for relevance, clarity, uniqueness, evidence quality, and usability.
• Revision Incentives — Reward and rank improvements to weak cards, citations, and stale evidence.
• Review Queue — Move cards through draft, review, requested changes, approval, and publication.
• Topic Coverage Dashboard — Identify missing, thin, covered, and untracked arguments by card and word count.
• Speech Documents — View evidence sent from Reason Editor into designated speech documents.

Team Prep & Collaboration

• Task Inbox — Review research tasks routed to contributors and organized by topic.
• Collaboration Prep Room — Share a topic-specific prep space for evidence, draft blocks, tasks, and active teammates.
• Team Collaboration Mode — Leave, assign, and track live prep notes during shared topic sprints.
• Prep Notes — Maintain live prep notes grouped into needs-follow-up, open, and covered status.
• Notifications — See and mark read notifications for prep-note assignments and activity.
• Team Brainstorm Assist — Submit, seed, organize, and upvote ideas for arguments, impacts, frontlines, and turns.
• Group Challenges — Create squad challenges based on contributions or recorded rebuttal wins.
• Research Progress — Review contribution history, task-completion rates, and per-topic work progress.

Community & Contributor Progress

• Leaderboard — Rank contributors by helpfulness score, tier, badges, and quest streak.
• News Stream — View product updates, community announcements, Daily Best Card winners, and Contributor Award standings.
• Contributor Awards — See helpfulness-ranked category winners, such as best evidence finder and best explainer.
• Daily Best Card — View the current highest-helpfulness card and prior daily winners.
• Progress — Track contributor tiers, badges, unlocked task levels, and daily-quest streaks.
• Quest Streaks — View current and longest daily-quest streaks plus milestone badges.
• Daily Quests — Track team goals, such as finding solvency cards, against live same-day contributions.

Practice & AI Rounds

• Practice Drills — Run flow-derived overview, frontline, cross-examination, and collapse drills.
• AI Coach Mode — Generate extension, refutation, collapse, and weighing prompts from a round’s flow.
• Judge Paradigm Picker — Select a built-in or custom AI judge paradigm for practice rounds.
• AI Judge Decision — Generate an AI decision grounded in the selected judge paradigm and flow summary.
• Opponent Persona Picker — Choose or define an AI practice opponent’s debating style.
• Word-Count Speeches — Practice speeches under a maximum word count instead of a time limit.
• Online Debate Versus AI — Debate an AI opponent in real turn order using a chosen format and side.
• Practice Round Simulator — Simulate a tournament round with a timer, AI judge paradigm, and AI opponent persona.
• Speech Transcript Summaries — Create per-argument flow summaries with cross-examination questions and extension ideas.
• Argument Tree Outline — Browse and filter a structured outline of every argument in a round’s flow.
• Flow Annotations — Add timestamped annotations to individual flowed arguments while reviewing recordings.
• AI Response-Outcome Charts — Analyze side exposure, vulnerable arguments, and hypothetical response paths in a flow.

Scouting & Round Strategy

• Judge Profiles — Review saved judges’ side-vote bias, speaker points, speed tolerance, and theory receptiveness.
• Opponent Team Profiles — Scout teams using records, side tendencies, common cases, and frequently used arguments.
• Pre-Round Briefings — Combine judge and opponent scouting, head-to-head records, and team prep notes for an upcoming round.
• Scout-to-Strategy — Convert scouting and judge tendencies into ranked case options and matchup-risk assessments.

Standings & Coaching

• CX NDCA Standings — View cumulative season standings based on recorded tournament results.
• Team Rankings — Browse debate-team rankings, leaderboards, and Elo ratings.
• Coaching Programs — Run roster-scoped group coaching spaces with topic sprints, challenges, and drills.
• Coach Materials — Upload or dictate grounding material for the team coach AI and preview relevant sources.

API & SDK

• API Reference — Interactive Scalar docs generated from debate-openapi.yml.
• debate-api-client (npm) — Typed SDK generated from the OpenAPI spec with Hey API, sending requests through grab-url for caching, retries, rate limiting, and dedupe on every call.

Contributing

Start developing locally, develop features, open ideas in discussions, and submit a PR!

npx git0 debate/ai

Open questions and larger proposals belong in Discussions; bugs and scoped work belong in Issues.

License

See LICENSE.md. packages/reason-editor vendors the CardMirror engine and carries its own LICENSE and THIRD-PARTY-NOTICES.md.