Socratic Sparring [Gegenwind] — Epistemological Dialectic Engine

Socratic Sparring [Gegenwind] is the unified cognitive reasoning companion of the Brainstorm Reactor. It consolidates previous fragmented coaching surfaces (the legacy Sokratischer Schreibcoach and Sokratischer Ideen-Coach) into a single, high-register epistemological interface.

Rather than generating superficial text or auto-completing prompts, the engine introduces constructive friction to expose hidden assumptions, surface systemic contradictions, and guide the user through rigorous First-Principles deconstruction.

---

1. Architectural Philosophy & Anti-Cognitive Surrender

Modern AI interfaces predominantly optimize for sycophancy and immediate text generation. Empirical cognitive science demonstrates that this creates severe cognitive vulnerabilities.

Tri-System Theory & Cognitive Surrender Mitigation

Research by Shaw & Nave (Wharton School, University of Pennsylvania, 2026) establishes that when humans interact with generative AI assistants (System 3: Artificial External Cognition), internal analytical deliberation (System 2) and intuitive sanity checks (System 1) are systematically suppressed. This phenomenon—termed Cognitive Surrender (Cohen's h = 0.81)—leads users to uncritically accept flawed arguments, hallucinations, or superficial ideas.

To restore epistemic sovereignty, Socratic Sparring enforces Facilitative Socratic Inquiry:

• Zero Automated Rewriting: The engine strictly refuses to ghostwrite or produce ready-made replacement paragraphs. The user remains 100% the author of their thoughts.
• Cognitive Austerity & Icon Discipline: All decorative and playful "magic" icons (Zap, Sparkles, ⚡, ✨) are banned. The UI communicates with academic sobriety, utilizing functional semantic iconography (Brain, Workflow, Search, Lightbulb, FileText, PenLine).
• High-Register Language: In accordance with the project's Text Style Guide (Austrian Standard German / Wiener Raum), product microcopy uses indicative, precise, and professor-level language without startup clichés (revolutionär, game-changing, KI-powered).

---

2. Epistemological Architecture & Cognitive Schools

The engine organizes intellectual inquiry into four distinct cognitive schools of thought, supplemented by an autonomous heuristic classifier:

School 1: Problem ergründen (First Principles)

Targets ill-defined, frustrating, or stagnant problem spaces:

1. Symptom vs. Kernursprung: Ruthlessly separates superficial symptoms (e.g. "Our team lacks motivation") from structural root causes (e.g. "Mismatched incentive structures and misaligned ownership").
2. Systemischer Zielkonflikt: Formulates the underlying paradox keeping the problem in equilibrium.
3. Versteckte Beharrungskräfte: Discloses implicit incentives, habits, or institutional fears stabilizing the dysfunction.
4. 3 Radikale Tiefenfragen: Formulates exactly 3 fundamental questions challenging baseline premises.
5. Handoff Bifurcation (1A vs. 1B):
   • Option 1A (Im Chat weiterdenken): Injects the full deconstruction into the session memory as a pinned context block for immediate free-form dialectics.
   • Option 1B (In Briefing überführen): Emits reactor:start-briefing-interview, handing off the distilled problem seed directly to the structured Socratic Briefing Interview pipeline.

School 2: Idee entwickeln (Orthogonal Innovation Angles)

Designed for creative sparks, project plans, and novel concepts:

1. Was die Idee stark macht: Identifies the emotional core, resonance, and unique leverage of the proposal.
2. Der Knackpunkt (Dilemma): Pinpoints the acute trade-off the concept must overcome.
3. 3–5 Orthogonale Lösungs-Winkel: Leverages TRIZ-derived inventive operators (Inversion, Asymmetrie, Phasung, Segmentierung) to crack the trade-off from unconventional perspectives.
4. Sentence Starters: Provides incomplete sentence beginnings (e.g., „Spannend wird es vor allem dann, wenn...“) acting as cognitive springboards without prescribing conclusions.

School 3: These härten (Dialectical Argumentation)

Audits drafts, manifestos, claims, and strategic memos:

1. Betrachtung: Objective analytical reflection of the main claim.
2. Verdeckte Annahmen: Exposes implicit premises that lack verification or evidence.
3. Gegengedanke (Antithese): Formulates the sharpest counter-perspective to stress-test resilience.
4. Argumentations-Reifestufe: Tracks qualitative milestones (Entwurf → Hinterfragt → Belegt → Eingegrenzt → Bereit).
5. 3-Stufen-Synthese-Builder: Provides dedicated input fields (Geschärfte Grundthese, Wichtigster Beleg, Eingrenzung/Rahmenbedingung) where the user personally re-articulates the fortified argument.

School 4: Disputation führen (Macro-Theses & Systemic Pillars)

Stress-tests civilizational paradigms, historical axioms, and macro-theses against mathematical, game-theoretic, and information-theoretic boundaries:

1. Hyper-Steelman: Constructs the strongest possible, high-register reconstruction of the interlocutor's thesis at eye level.
2. Epistemic Wedge Across 3 Systemic Pillars: Applies a hard analytical wedge grounded in formal theory:
   • Pillar 1: Collective Coordination & Intersubjective Fictions (Dunbar threshold N > 150 enforcement costs O(N²); Schelling focal points vs. phenomenological deconstruction).
   • Pillar 2: Cognition & Algorithmic Decoupling (Decoupling intelligence I from sentience C in non-ergodic environments).
   • Pillar 3: Information Networks & Systemic Order (Shannon entropy vs. network order compression; order optimization suppressing truth signals).
3. Angreifbare Prämisse (Unbacked Warrant): Pinpoints the unverified causal bridge sustaining the narrative.
4. Maieutisches Dilemma: Formulates the core paradox forcing a new synthesis.
5. Sokratische Prüffrage: Exactly one demanding maieutic inquiry constrained strictly to ≤ 20 words.
6. Dedicated Campaign & Dropzone: Accessible directly as Mode 4 in the Gegenwind Cockpit, or via /drop/disputation (rcp_disputation_v1).

Auto-Erkennung (Deterministic Classifier)

The classifySparringInput() utility in lib/reactor/sparring-classifier.ts parses incoming text in real time using syntactic heuristics:

• Problem indicators (problem, konflikt, engpass, bottleneck, warum, scheitert, krise) allocate weight to Problem.
• Idea indicators (idee, vorhaben, konzept, startup, plattform, was wäre wenn) allocate weight to Idea.
• Argumentative connectors (weil, deshalb, daher, obwohl, folglich, behauptung, fazit) allocate weight to Thesis.
• Macro-narrative and systems indicators (zivilisation, kollektiv, fiktion, algorithmus, entropie, gesellschaft, paradigma) allocate weight to Disputation.
• Question marks and token length curves dynamically balance exploratory versus articulated submissions.

---

3. Action Menu & PDF Export Architecture

A dedicated Kebap Action Menu (⋮) is anchored in the panel header, granting instant access to operational utilities:

Full AI Thought Preservation in PDF Export

When the user exports a session to PDF, all analytical considerations are preserved with 100% fidelity:

1. Deconstruction Artifacts: The complete breakdown (Symptom, Root Cause, Tension, Probing Questions, Solution Angles) is recorded in session history and rendered under Core Dialog & Results.
2. Reasoning Trace (Thinking): In the PDF Export modal, checking Reasoning Trace ("Internal AI Reasoning" / „Die internen Gedankengänge der KI“) causes the PDF compiler to extract and format the underlying model's Chain-of-Thought traces directly into the document.

---

4. Mobile SOTA UX Standards (mobile-sota.md)

In accordance with the Lead Developer's Mobile SOTA guidelines, the Socratic Sparring module enforces strict ergonomic baselines:

1. iOS Safari Viewport-Zoom Elimination:
   • Text inputs on mobile automatically trigger an intrusive viewport zoom if font sizes are below 16px.
   • The <textarea> and all synthesis input fields enforce text-[16px] sm:text-sm (or sm:text-base), completely neutralizing unwanted iOS auto-zoom.
2. Fitts's Law Touch Targets (≥ 44–48px):
   • Primary action buttons (Sokratischen Gegenwind anfordern, 1A / 1B Handoff, Als Erkenntnis-Karte senden) enforce min-h-[48px] touch-manipulation active:scale-[0.98].
   • Segmented mode controls enforce min-h-[36px] touch-manipulation.
   • Micro-actions (In Chat, Idea Lab, building block appenders) enforce ≥ 40px touch envelopes.
3. Single-Skin Mobile Sheet:
   • On mobile viewports, the host mounts inside a full-height bottom sheet (SheetContent side="bottom" h-[100dvh] max-h-[100dvh] pt-14 pb-4), providing edge-to-edge interaction without double-scroll containers.

Widescreen 50:50 Splitscreen & Zero-Scroll Cockpit Ergonomics (desktop-cockpit-ergonomics.md)

On desktop and laptop viewports (≥ 1024px), Socratic Sparring organizes the workspace into a balanced 50:50 cognitive split:

1. Symmetrical 56px Header Baseline:
   • The writing canvas (WritingRoomViewport) and dialectical mirror (GegenwindMirrorPanel) enforce identical h-14 (56px) headers with matched border-bottom and background blur, guaranteeing a flush horizontal baseline.
2. Double-Chrome Elimination:
   • The redundant outer sidebar tab row is dynamically suppressed in Gegenwind mode. Global panel controls (Pool switching, 50:50 splitscreen collapse/expand, re-calculation, and single close trigger) are unified directly into the 56px header.
3. Progressive Disclosure & Above-the-Fold Guarantee:
   • Secondary friction layers (Versteckte Bremsen & Beharrungskräfte) utilize an accessible progressive disclosure trigger. This recovers ~120px of vertical space, ensuring the 3 deep probing questions and handoff actions (In Entwurf, Briefing starten ➔) are visible above the fold on 16:10 laptop screens without vertical scrolling.
4. Bidirectional Dirty-State Synchronization:
   • When text in the writing canvas is modified after an analysis run, the primary trigger updates to Gegenwind aktualisieren ⌘↵, while the mirror status line reflects Entwurf modifiziert · Neu berechnen (⌘↵).
5. Direct Entry & Splitscreen Invariant (Zero-Sidebar Squeeze):
   • When accessing Socratic Sparring directly from landing page chips (/reactor?tool=sparring), quick-launch cards, or dropzone routes (/drop/schreibcoach), the interface immediately enforces bilateral balance without a cramped 3-column squeeze:
     • Left Sidebar: Auto-collapsed on initial mount (isLeftSidebarOpen: false).
     • Right Sidebar: Auto-opened and expanded into 50% splitscreen (isRightSidebarOpen: true, isPoolExpanded: true).
     • Hydration Guard: syncFromLocalStorage() is locked while Socratic Sparring is active, preventing background local storage synchronization from reverting the layout to 3-column Studio mode.
     • Reversible Exit Restoration: Closing or dismissing the Socratic Sparring panel restores bilateral Studio mode (isLeftSidebarOpen: true, isRightSidebarOpen: true, isPoolExpanded: false).

---

5. Technical Constraints & Invariants Compliance

• Universal Access & V1 Retirement: Socratic Sparring [Gegenwind] is universally available to all tiers (Free, Pro, and Enterprise/Admin). Legacy Socratic Coach V1 UI panels are cleanly retired and aliased into Gegenwind.
• Chat Input Bridging: Launching Gegenwind with unsubmitted text in the chat input field seamlessly transfers the text to the writing canvas while preserving all file attachments in the main chat.
• Engine & REST Pipeline: Dedicated skew-immune endpoint /api/reactor/sparring enforcing standard HTTP POST semantics and zero Next.js Server Action hash skew (PureStream v1 architecture).
• Model Resolver: Dynamically routed via resolveModelFromSlot('logic').
• Temperature Corridor Gate: Strictly bounded at 0.85 (adhering to the 0.8 ≤ T ≤ 1.2 SSOT invariant).
• Double-Shield IP: Frontend cognitive interaction patterns are documented here as open Prior Art. Internal algorithmic weights and scoring functions remain clearance-protected Trade Secrets.

---

6. Live Interactive Module & Guest Dropzone