CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Kommunikation

Mit dem User auf Deutsch kommunizieren.

Projektübersicht

0nefinity ist ein kreativ-philosophisch-mathematisches Kunstprojekt rund um die nicht-duale Identität 0 ≡ 1 ≡ ∞. Keine klassische App — eine Sammlung interaktiver HTML-Experimente, Visualisierungen und philosophischer Texte. Kein Build-System, kein npm, kein package.json.

Entwicklungsumgebung

Infrastruktur

Ein Git-Repo, zwei Worktrees, zwei Docker-Container auf dem Host-Server:

Pfad (Host)	Branch	Domain	Docker-Container
`/home/timbr/0nefinity/0nefinity.love/`	`main`	`0nefinity.love`	`0nefinity-live` (Volume `:ro`)
`/home/timbr/0nefinity/dev.0nefinity.love/0nefinity-dev/`	`claude-dev`	`dev.0nefinity.love`	`0nefinity-dev`

Git-Repo: /home/timbr/0nefinity/0nefinity.love/.git
Remote: git@github.com:0nefinity/0nefinity.love.git
Dev-Worktree zeigt auf claude-dev Branch

Webserver

nginx auf dem Host terminiert TLS (Let's Encrypt) und proxied:
- 0nefinity.love → 127.0.0.1:18
- dev.0nefinity.love → 127.0.0.1:129
Apache 2.4 + PHP 8.3 in Docker-Containern (ein Image, zwei Container)
.htaccess regelt Rewrites, Clean URLs, SSI, PHP-Routing, Sicherheit
Dateien bearbeiten → sofort live (Volumes, kein Build nötig)

Docker-Setup

# Dateien unter /home/timbr/0nefinity/
#   Dockerfile, docker-compose.yml, reverse-proxy.conf

docker compose up -d              # Container starten
docker compose build && docker compose up -d   # Image neu bauen + starten
docker compose logs -f live       # Logs live-Container
docker compose logs -f dev        # Logs dev-Container

Verfügbare Tools

PHP 8.3 (im Container)
Python 3.12 (auf dem Host)

Architektur

Flache Sammlung selbst-enthaltener HTML-Seiten. Die gemeinsame Infrastruktur:

Datei	Rolle
`meta.css`	Globales Theme, CSS-Variablen (`--bg-color`, `--text-color` etc.), Menü-Styling. Nutzt `!important` bewusst. Immer für Farben konsultieren.
`meta.js`	Globales UI-Framework, `_018Space`-Objekt, Menü-Verhalten
`tools/controls.js`	Interaktive UI-Steuerelemente (Slider, Inputs, Zoom)
`tools/zoom.js`	Zoom und Skalierung für Canvas-Seiten
`0nefinity.js`	Mathematische Konstanten und Manifestationen der 0nefinity-Theorie
`tools/tools/decimal.js`	Bibliothek für beliebig genaue Dezimalzahlen
`tools/tools/pixi.js`	PixiJS (WebGL-Rendering) für grafikintensive Seiten

Einstiegspunkte: index.html (Manifest + Navigation), README.html (Doku) Archiv: 00_Archiv/ — nur zum Nachschlagen, nicht anfassen

Git-Workflow

Entwicklung auf claude-dev, stabile Releases auf main
Dev-Arbeit regelmäßig committen und pushen
Merge nach main nur wenn stabil und getestet
Commit-Messages: Formlos, Deutsch oder Deutsch/Englisch gemischt (z.B. "zwischenspeichern", "018 ascii animation, yeah")

Coding-Regeln

Controls: Immer 0 als gültigen Eingabewert erlauben, Ranges so unbegrenzt wie möglich (→ ∞). Keine künstlichen Obergrenzen.
Styling: Farben ausschließlich über meta.css-Variablen setzen. meta.js, controls.js und zoom.js für Standard-Interaktionen nutzen — nicht neu erfinden.
Performance: Muss auch auf alter Hardware ("Gurke") flüssig laufen. Rechenintensive Aufgaben in Web Worker auslagern (tools/workers/).
Dateinamen: Auf Deutsch, beschreibend, Leerzeichen und Emojis sind erlaubt und gewollt.

Philosophische Konventionen

Deutsch-Englisch-Mix, unkonventionelle Interpunktion und metaphorische Variablennamen sind Absicht, keine Fehler. Die "Unvollkommenheiten" gehören zur Ästhetik des Projekts.

GitNexus — Code Intelligence

This project is indexed by GitNexus as 0nefinity.love (3227 symbols, 5600 relationships, 268 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.

If any GitNexus tool warns the index is stale, run npx gitnexus analyze in terminal first.

Always Do

MUST run impact analysis before editing any symbol. Before modifying a function, class, or method, run gitnexus_impact({target: "symbolName", direction: "upstream"}) and report the blast radius (direct callers, affected processes, risk level) to the user.
MUST run gitnexus_detect_changes() before committing to verify your changes only affect expected symbols and execution flows.
MUST warn the user if impact analysis returns HIGH or CRITICAL risk before proceeding with edits.
When exploring unfamiliar code, use gitnexus_query({query: "concept"}) to find execution flows instead of grepping. It returns process-grouped results ranked by relevance.
When you need full context on a specific symbol — callers, callees, which execution flows it participates in — use gitnexus_context({name: "symbolName"}).

Never Do

NEVER edit a function, class, or method without first running gitnexus_impact on it.
NEVER ignore HIGH or CRITICAL risk warnings from impact analysis.
NEVER rename symbols with find-and-replace — use gitnexus_rename which understands the call graph.
NEVER commit changes without running gitnexus_detect_changes() to check affected scope.

Resources

Resource	Use for
`gitnexus://repo/0nefinity.love/context`	Codebase overview, check index freshness
`gitnexus://repo/0nefinity.love/clusters`	All functional areas
`gitnexus://repo/0nefinity.love/processes`	All execution flows
`gitnexus://repo/0nefinity.love/process/{name}`	Step-by-step execution trace

CLI

Task	Read this skill file
Understand architecture / "How does X work?"	`.claude/skills/gitnexus/gitnexus-exploring/SKILL.md`
Blast radius / "What breaks if I change X?"	`.claude/skills/gitnexus/gitnexus-impact-analysis/SKILL.md`
Trace bugs / "Why is X failing?"	`.claude/skills/gitnexus/gitnexus-debugging/SKILL.md`
Rename / extract / split / refactor	`.claude/skills/gitnexus/gitnexus-refactoring/SKILL.md`
Tools, resources, schema reference	`.claude/skills/gitnexus/gitnexus-guide/SKILL.md`
Index, status, clean, wiki CLI commands	`.claude/skills/gitnexus/gitnexus-cli/SKILL.md`