Files

T

L'électron rare 0825b35463 docs: add nested CLAUDE.md tree

Root CLAUDE.md (overview, where-to-look, conventions) plus
nested files for data_only_viz, oscope-of, launcher.
sound_algo already had its own nested tree.

Sized for the ~150-instruction budget: root 43 lines,
each nested 43-52 lines, telegraphic style.

2026-05-13 10:56:55 +02:00

2.0 KiB

Raw Blame History

AV-Live

Live coding audio-visual performance system : moteur SuperCollider, visualiseur openFrameworks piloté par un oscilloscope Hantek 6022BL, app menubar macOS qui orchestre le tout.

Communication

Toujours répondre en français à l'utilisateur. Code, commentaires de code, commits et docs en anglais.

Stack par sous-projet

Sous-projet	Stack
`sound_algo/`	SuperCollider (sclang + scsynth), 1099 SynthDefs, 345 tracks
`oscope-of/`	openFrameworks C++, libusb (Hantek bulk), GLSL 150 GL 3.2 core
`launcher/`	SwiftUI menubar app, Swift Package Manager
`data_only_viz/`	Python 3.11+ via `uv`, Metal natif (pyobjc), multi-backends pose
`web_realart/`	Node.js, Express, OSC bridge

Where to Look

Tâche	Emplacement
Ajouter / modifier un SynthDef, track, palette	`sound_algo/` (déjà documenté en nested)
Toucher au visualiseur, shaders, FFT, Hantek	`oscope-of/`
Modifier l'app menubar macOS	`launcher/`
Détection pose / mesh / body tracking	`data_only_viz/`
Bridge web / UI de live coding	`web_realart/`
Plans / specs en cours	`docs/superpowers/plans/`

Conventions globales

Python : uv systématiquement (jamais pip/poetry/conda directs).
Pas d'emojis dans code/docs/commits sauf demande explicite.
Commits : sujet ≤ 50 char, body ≤ 72 char/ligne, pas d'attribution AI, pas de --no-verify, pas d'underscore dans le scope (hooks enforcent).
*.pt, *.ckpt, *.safetensors, *.mlpackage exclus par .gitignore racine.

Agent Workflow

Explore localise → librarian lit (>500 lignes) → tu raisonnes → general-purpose implémente → validator vérifie. Lance les tâches indépendantes en parallèle.

Guidance imbriquée

Chaque sous-projet majeur a son propre CLAUDE.md. Claude charge automatiquement le plus proche du fichier édité (« closest wins »). N'ajouter ici que ce qui s'applique à TOUS les sous-projets.

2.0 KiB Raw Blame History