type	Workspace Guide
title	Artbeats Codex Demo Workspace
description	A small practice workspace for using Codex in business operations and video production.
tags	artbeats codex demo workspace
timestamp	2026-06-24 00:00:00 +0200

Artbeats-Codex-Demo-Workspace

Dies ist ein kleiner Übungsworkspace für die Arbeit mit Codex bei Artbeats.

Er gibt Codex ein einfaches gemeinsames Gedächtnis über Artbeats und zwei fokussierte Arbeitsbereiche, in denen das Team realistische Workflows mit sicherem Demomaterial ausprobieren kann:

• business-operations - Angebote, Kundenbriefings, Kampagnenbriefings und operative Entwürfe.
• video-production - Feedback-Triage, DaVinci-Resolve-Handoff und Assistenz für den Schnitt.

Setup nach GitHub-Download

1. Repo von GitHub herunterladen oder klonen:

git clone https://github.com/wirenet-dev/art-beats.git

Alternativ kann ein GitHub-ZIP heruntergeladen und lokal entpackt werden. 2. In Codex entweder den Workspace-Root öffnen oder direkt einen Domain-Ordner als eigenes Codex-Projekt öffnen:

• business-operations
• video-production

3. Optional die mitgelieferten Video-Production-Skills lokal installieren:

mkdir -p ~/.codex/skills
cp -R video-production/skills/davinci-resolve-operator ~/.codex/skills/
cp -R video-production/skills/frameio-feedback-bridge ~/.codex/skills/

4. Codex neu starten oder eine neue Session öffnen, damit die Skills geladen werden.
5. Für Resolve-Demos Samuel Gurskys davinci-resolve-mcp nach dessen Anleitung installieren und DaVinci Resolve für lokale Scripting-/MCP-Nutzung vorbereiten. Für den AI-Test-Bingen-Demo-Run sind außerdem ffmpeg und ffprobe hilfreich; Whisper oder faster-whisper ist optional für lokale Transkript-Sidecars, wenn Resolve/MCP keine passende Transkriptbasis liefert. Optional kann dvr später ergänzt werden, wenn Artbeats strukturierte CLI/Python/JSON-Workflows testen möchte; der Workspace setzt es nicht voraus.
6. Optional die Frame.io-Bridge lokal einrichten. Die Adobe OAuth Web App JSON und alle Tokens bleiben unter .local/frameio/ und werden nicht committed:

python3 video-production/skills/frameio-feedback-bridge/scripts/setup_frameio_bridge.py \
  --credential-json /path/to/adobe-oauth-web-app.json \
  --install-deps

Danach die Setup-Referenz lesen: video-production/skills/frameio-feedback-bridge/references/setup.md. 7. Für AI Test Bingen das lokale Datenbundle bereitlegen und user/source-resolutions.example.md nach user/source-resolutions.local.md kopieren. Die Platzhalter dort durch lokale Pfade ersetzen. 8. Den Workspace-Checker ausführen:

python3 .wirenet/scripts/check_okf.py

Der Workspace enthält einen kuratierten Beispiel-Run unter video-production/outputs/example-runs/2026-06-24-ai-test-bingen/. Er zeigt Codex, wie ein guter AI-Test-Bingen-Feedbacklauf dokumentiert wurde, ohne schwere lokale Render-, Audio- oder Resolve-Projektdateien in den Download zu packen.

Editierkarte und Warnhinweise

Für normale Arbeit sollen Artbeats-User vor allem mit Prompts arbeiten und Codex die passenden Dateien schreiben lassen. Direkt bearbeiten sollte man nur wenige lokale oder projektnahe Dateien.

Direkt bearbeiten, wenn es nötig ist

• user/source-resolutions.local.md - lokale Pfade, lokale Resolve-Projektnamen und maschinenspezifische Source-Auflösung. Diese Datei entsteht aus user/source-resolutions.example.md und bleibt privat auf der jeweiligen Maschine.
• .local/frameio/ - lokale Frame.io-Bridge-Konfiguration, OAuth-JSON, Tokens und Cache. Diese Daten werden über das Setup-Script erzeugt oder aktualisiert und nicht geteilt.
• Domain-outputs/ - erzeugte Entwürfe, Berichte und Arbeitsnotizen, wenn jemand einen Output manuell nachbearbeiten möchte.
• video-production/projects/<projekt>/status.md - kurzer aktueller Handoff-Stand, nächste Aktionen und offene Fragen für ein benanntes Videoprojekt.
• video-production/projects/<projekt>/sources.md - stabile Source-IDs und benötigtes Material eines Projekts, aber keine lokalen Maschinenpfade.
• Domain-sources/ - bewusst bereitgestellte Demo-, Workshop- oder Projektinputs.

Nur bewusst als Workspace-Pflege ändern

Diese Dateien und Ordner sind die Wissens- und Verhaltensstruktur des Systems. Sie sollten nicht nebenbei in einer normalen Projektarbeit geändert werden:

• AGENTS.md im Root und in den Domains.
• index.md, log.md, identity/, playbooks/ und reviews/.
• video-production/skills/, wenn es um portable Codex-Skills wie Resolve oder Frame.io geht.
• .wirenet/, .gitignore und Setup-/Checker-Dateien.
• Domain- und Projektordnerstruktur, besonders projects/, sources/ und outputs/.

Wenn eine Änderung an diesen Bereichen gewünscht ist, Codex ausdrücklich mit Workspace-Pflege beauftragen und danach den Checker ausführen:

python3 .wirenet/scripts/check_okf.py

Nicht in den geteilten Workspace legen

• Passwörter, Tokens, OAuth-Secrets oder komplette .local/-Ordner.
• Echte unveröffentlichte Footage-Dateien, schwere Render-Dateien oder Resolve-Archive.
• Private Kundenkommentare als dauerhaftes Wissen. Frame.io-Rohdaten bleiben lokal unter .local/frameio/; dauerhafte Zusammenfassungen entstehen nur bewusst über den Triage-Workflow.
• Absolute lokale macOS-, Volume- oder Windows-Pfade in geteilten Dateien.

Was man ausprobieren kann

Öffne einen der Domain-Ordner in Codex und starte mit einem Prompt wie diesem.

Business Operations:

Lies AGENTS.md und führe dann den Angebotsworkflow in playbooks/client-proposal.md mit sources/demo-inputs/sample-museum-inquiry.md aus. Speichere den Angebotsentwurf unter outputs/drafts/proposals/.

Video Production:

Lies AGENTS.md und führe dann den Feedback-Triage-Workflow in playbooks/feedback-triage.md mit sources/demo-inputs/frameio-feedback-sample.md aus. Speichere den Triage-Bericht unter outputs/reports/ und aktualisiere projects/demo-film/status.md.

Video Production mit dem AI-Test-Bingen-Resolve-Bundle:

Lies AGENTS.md, projects/ai-test-bingen/sources.md, projects/ai-test-bingen/status.md, playbooks/resolve-professional-feedback-run.md, reviews/resolve-professional-edit-checklist.md, skills/davinci-resolve-operator/SKILL.md und den Beispiel-Run unter outputs/example-runs/2026-06-24-ai-test-bingen/. Prüfe zuerst Source-Auflösung, Resolve/MCP-Setup und Baseline. Erstelle einen Plan für den AI-Test-Bingen-Demo-Lauf. Berühre Resolve erst nach meiner ausdrücklichen Freigabe. Speichere neue Run-Artefakte unter outputs/feedback-runs/ und aktualisiere den Projektstatus.

Wie der Workspace funktioniert

• Der Root-Ordner enthält geteiltes Unternehmenswissen für Artbeats.
• Der Ordner user/ kann lokale Setup-Details enthalten, zum Beispiel wo diese Maschine ein Projektdatenbundle speichert.
• Jeder Domain-Ordner hat ein eigenes AGENTS.md, sources/ und outputs/.
• AGENTS.md sagt Codex, wie er sich im aktuellen Workspace verhalten soll.
• index.md ist die Karte des Wissens, das in diesem Ordner verfügbar ist.
• identity/ erklärt den Company- oder Domain-Kontext.
• playbooks/ enthält wiederverwendbare Anleitungen dafür, wie Arbeit erledigt wird.
• sources/ enthält Domain-Inputmaterial für Übungen und Referenzen.
• projects/ hält aktuellen Status und nächste Schritte für benannte Jobs.
• Projekt-sources.md-Dateien dokumentieren, welches Quellenmaterial ein benannter Job nutzt.
• outputs/ ist der Ort, an dem Codex Entwürfe, Berichte und Implementierungsnotizen innerhalb einer Domain speichert, sofern der Prompt nicht klar ein anderes Ziel nennt.
• outputs/ ist keine Wissenskarte. Wichtige Outputs werden im Projektstatus verlinkt oder genannt, wenn Codex die Arbeit abschließt.
• reviews/ enthält Qualitätschecks, bevor Arbeit als fertig behandelt wird.
• video-production/skills/ enthält portable Codex-Skills für neue lokale Setups, aktuell Resolve-Operator und Frame.io-Feedback-Bridge.

Arbeitsgewohnheit

Halte für jeden wiederkehrenden Workflow einen eigenen Codex-Thread. Wenn die Arbeit zu einem benannten Projekt gehört, soll jeder Thread den Projektstatus mit dem aktualisieren, was sich geändert hat, was noch offen ist und wo der nächste Thread weitermachen soll.

Der Workspace soll leicht bleiben: Normale Arbeit erzeugt ein Artefakt in outputs/ und, wenn relevant, ein kurzes Projektstatus-Update. Die Wissensstruktur selbst ändert sich nur, wenn jemand ausdrücklich Workspace-Pflege verlangt.

Nützliche Threads

• Projekt-Thread: Projektstatus öffnen und fragen, ob es neues Feedback gibt oder was als Nächstes passieren soll.
• Playbooks-Thread: Fragen, welche Playbooks existieren, dann einen Workflow für einen wiederholbaren Prozess oder eine Method für eine wiederverwendbare Technik verbessern oder erstellen.
• Reviews-Thread: Fragen, welche Reviews existieren, dann eine Review verbessern oder erstellen. Nur mit einem Playbook verbinden, wenn dieser Workflow sie normalerweise nutzen soll.