Agentic Ventures Wiki

Briefing — Phase 1: Bug-Fixes + Quick-Wins (agenticventures.de)

5 Min. Lesezeit

Briefing — Phase 1: Bug-Fixes + Quick-Wins

Dieses File ist als Prompt fuer eine frische Claude-Session gedacht. Marvin kann es kopieren oder ein neuer Claude liest es direkt. Der Prompt steht im naechsten Abschnitt — alles davor/danach ist Begleit-Kontext.

Prompt (ab hier kopierbar)

Du arbeitest in Marvin’s Vault ~/source/agentic-ventures/. Lies erst CLAUDE.md, dann intern/projekte/av-website/_index.md und intern/projekte/av-website/redesign-plan.md Section „Phase 1”. Code-Repo ist ~/source/agentic-ventures-website/ (Next.js 15 + React 19 + Tailwind v4 + GSAP + Motion + Lenis), live auf agenticventures.de via Vercel.

Mission: Phase 1 (Bug-Fixes + Quick-Wins) komplett abarbeiten und deployen. Sechs Tasks, ca. 4-6 h, alle Solo-fähig. Reihenfolge unten ist nach Hebel-pro-Aufwand sortiert, nicht nach Nummerierung — das ist Absicht.

Reihenfolge der Tasks

1. Phase 1.1 — Sitemap-Trailing-Space-Bug (15 min, höchster Hebel)

  • Symptom: Live-URL https://agenticventures.de/sitemap.xml hat <loc>-URLs mit Leerzeichen am Ende
  • Files: app/sitemap.ts, app/robots.ts, app/layout.tsx, plus Vercel-Env-Var NEXT_PUBLIC_SITE_URL
  • Fix: SITE_URL mit .trim() versehen + Env-Var im Vercel-Dashboard prüfen (Trailing-Whitespace/Newline aus dem Wert raus)
  • Verifikation nach Deploy: curl -s https://agenticventures.de/sitemap.xml | grep -E 'loc>.* <' muss leer sein

2. Phase 1.2 — Alte .io-Referenzen raus (10-15 min)

  • Files: DESIGN.md (Header description + Wortmarken-Section) und README.md (Header-Link + Deploy-Section)
  • Code-Defaults sind bereits korrekt — app/layout.tsx, app/sitemap.ts, app/robots.ts, src/lib/schema.ts nicht anfassen
  • Sicherheitscheck vorher: grep -rn "agenticventures.io" ~/source/agentic-ventures-website/ --include="*.ts" --include="*.tsx" --include="*.md" — wenn andere Files auftauchen, Marvin fragen

3. Phase 1.6 — Cred-Strip kürzen (5 min)

  • File: src/components/sections/resolve-landing.tsx
  • Aktuell 4 Items, davon doppeln „Service · kein Produkt” und „Deine Tools bleiben deine Tools”
  • Neu: 3 Items „Service · kein Produkt” / „Kein Lock-in” / „DSGVO-konform”

4. Phase 1.3 — Hero-CTA ergänzen (30-45 min)

  • File: src/components/sections/video-hero.tsx
  • Primary „Kennenlerngespräch buchen” (Link auf Cal-URL, gleiche Konstante wie ResolveLanding) + Ghost „Wie wir arbeiten” (Anchor #process)
  • Konsistent zum ResolveLanding-CTA-Stil — keinen zweiten Button-Stil einführen
  • Mobile testen: CTA-Pair darf das Hero-Video nicht überdecken

5. Phase 1.4 — Headline-Konsistenz Hero ↔ Pitch (Entscheidung mit Marvin + 5 min Code)

  • Aktueller Hero: „Wir bauen den digitalen Zwilling deines Unternehmens.”
  • Pitch in positioning.md: „KI-Agenten, die das Büro führen — kein neues Tool, sondern die Schicht die bestehende Tools intelligent verbindet.”
  • Empfehlung aus Plan: zurück zum Pitch-Satz. „Digitaler Zwilling” lädt Industrie-4.0-Erwartungen und ist nirgends im Vault verankert
  • WICHTIG: keine Änderung ohne explizites OK von Marvin. Marvin entscheidet. Falls „digitaler Zwilling” bleibt → positioning.md als zweite Marken-Headline ergänzen

6. Phase 1.5 — Pricing 4 Cards → 5 Cards + Range-Anker (30-45 min, komplexester Task)

  • Files: src/components/sections/pricing.tsx, neue Konstante src/lib/pricing.ts (zentralisiert für spätere Schema-Konsistenz, siehe Phase 3.4)
  • Neue Card „Hosted-MCP” zwischen Beratung und Sprint (Vault-Begriff, KMU-tauglicher Site-Name mit Marvin abklären — Kandidaten: „Tool-Anbindung”, „KI-Arbeitsplatz”, „Chat-Setup”, „Eigener KI-Connector”)
  • Preise aus leistungen als „ab X €”:
    • Schulung „ab 1.500 €”
    • Beratung „ab 1.800 €/Tag”
    • Hosted-MCP „ab 2.500 €” (NEU)
    • Sprint „ab 8.500 €”
    • Managed „ab 200 €/Monat”
  • Layout: aus 4er-Grid wird 5er-Grid. Auf Desktop ggf. 5 Spalten, auf Tablet 2x3 (5. Card spannt 2 Spalten oder steht zentriert), auf Mobile gestapelt

Constraints

  • Push auf main braucht explizites OK pro Push. Sicherheitsregel blockt direct-push ohne explizite Autorisierung. Pattern: erst Edits + Commit lokal, dann Marvin fragen „go”, dann pushen.
  • Pre-commit-Hooks nicht skippen. Wenn Hook failt: Issue fixen, NEUER Commit (nicht --no-verify, nicht --amend).
  • Vercel deployed automatisch on push. Live in ca. 1 min nach Push.
  • Schreibstil für UI-Texte (siehe Memory feedback_schreibstil_extern): keine em-dashes (—), Ich-Form wo der Founder spricht. Sichtbare UI-Texte folgen dem Stil der heute geänderten Bio in trust.tsx (sachlich, konkret, ohne Marketing-Pathos). Beispiel-Diff in intern/projekte/av-website/copy-decisions.md.
  • Nicht überdrehen. Phase 1 ist Bugs + Quick-Wins. Keine Phase-2-Cases-Content, keine Phase-3-Schemas, keine neuen Sections. Wenn was nach Scope-Ausweitung riecht — abbrechen und Marvin fragen.
  • ADHS-Mode: kleine Schritte. Ein Commit pro Task (oder maximal zwei verwandte Tasks gebündelt). Marvin kann zwischendurch reviewen.
  • Commit-Message-Stil: Conventional Commits auf Deutsch, wie die letzten Commits (fix:, refactor:, feat:). Beispiel fix(seo): Sitemap-URLs ohne Trailing-Whitespace.

Output

  • 4-6 Commits auf main, alle gepusht und live
  • Pro Task: kurze Verifikation dass es im Browser/curl wirklich greift (nicht nur dass der Build durchgeht)
  • Aktualisierung von copy-decisions wenn Headline-Entscheidung (1.4) gefällt wurde — Section „Hero-Headline” mit Status, File, Diff
  • Aktualisierung von _index Phase 1 als ✅ markiert + Datum
  • Append-only History-Eintrag in redesign-plan §„Append-only History”
  • Kurz-Summary für Marvin am Ende: was wurde gemacht, Live-URLs, was nächstes (Phase 0.3 Cases-Freigaben starten + Phase 2.1 Aylem-Case schreiben)

Wenn du fertig bist

Marvin’s nächste Session-Hooks:

  • Strategie-Klärung mit Marvin nötig (NEU 2026-05-11): Stand jetzt gibt es KEINE veröffentlichungsfähigen Kunden-Referenzen. Phase 0.3 (Cases-Freigaben) und Phase 2 (Cases-Content) sind damit blockiert. Vor dem nächsten Sprint muss entschieden sein was als Trust-Signal an die Stelle tritt — Kandidaten: eigene Builds zeigen (Voit, HeyJulia, eigene MCPs), GitHub-Aktivität sichtbar, Methodik-Page mit eigenen Screenshots, anonymisierte Mini-Cases, Demo-Video aus eigenem Setup.
  • Phase 3 (AI-SEO-Tiefe) gewinnt damit an Gewicht — Schema.org, llms.txt, FAQ-BLUF, robots.txt-Bot-Differenzierung müssen mehr leisten wenn keine Cases.

Begleit-Kontext (nicht Teil des Prompts)

  • Heutige Session (2026-05-11): Bio im Trust-Block + Schema.org Person-Description neu, commit 55b0f62 auf main, live deployed. Plus Blog-Draft intern/projekte/av-website/blog/wie-ki-agenten-unternehmen-finden.md angelegt — separate Spur, nicht Teil von Phase 1.
  • Pitch-Statement „Welt ist so komplex” wurde im Code nicht gefunden, in copy-decisions als offene Frage geparkt — nicht in Phase 1 lösen, separate Quelle suchen.
  • Last-known good Branch-Stand: main = origin/main = 55b0f62.
  • Domain-Realität: Marken-Domain ist agenticventures.de (ohne Bindestrich). agentic-ventures.com gehört uns nicht, agenticventures.io ist alt — nicht referenzieren.

Graphansicht

Backlinks