@thedecipherist/claude-packs 0.0.0-stage → 1.0.0

package/profiles/stellix.layout.json

@@ -0,0 +1,315 @@
+{
+  "_comment": "Stellix, tailored from docs/project.md (surveyed 2026-10-26, branch work/notes-hit, b41d77d). Complete: packs add no default folders. stage-guard is disabled: the house git-guard already refuses git add -A. 0.4.0: the SOUND and MIXER layers (lib/app/src/layer*, cards, controls) are UI, so the control and look rules load there; confirm against the re-survey. 0.6.0: the copy trees are folders of kind copy (protect-vendor guards them; copy-tree-guard.py is merged into it), and guards carries Stellix's values for the house guards. enable: the opt-in hooks Stellix runs (user-asks, idle-wake); guards.git.refuseTrunk: Stellix works on a branch per step.",
+  "complete": true,
+  "folders": {
+    "app": {
+      "path": "lib/app",
+      "purpose": "the standalone, processor, editor, player, demo and the one launch function (launch.cpp)"
+    },
+    "app_copy": {
+      "path": "lib/app/tabula",
+      "kind": "copy",
+      "purpose": "a COPY TREE (kind copy): Tabula 1's PIANO loader, bridge and prebuild tool, copied unchanged by tools/copy_tabula.py; read-only as every copy tree"
+    },
+    "snapshot": {
+      "path": "lib/snapshot",
+      "purpose": "the one shared snapshot header the painter reads (header-only)"
+    },
+    "world": {
+      "path": "lib/world",
+      "purpose": "the world: travellers, strikes, rebounds, PULL, walls, the snapshot ring, State and the seeded RandomSource"
+    },
+    "engines": {
+      "path": "lib/engines",
+      "purpose": "SlotSound and Tabula 1's voice, copied and proved (src/tabula is read-only)"
+    },
+    "engines_copy": {
+      "path": "lib/engines/src/tabula",
+      "kind": "copy",
+      "purpose": "a COPY TREE (kind copy): Tabula 1's voice, effects and dspblocks files, copied unchanged by tools/copy_tabula.py; read-only (L8), each file with its origin line"
+    },
+    "engines_own": {
+      "path": "lib/engines/src/own",
+      "kind": "own",
+      "purpose": "PROMOTED files (kind own): copied files that measured identical, moved out of the copy tree by tools/copy_promote.py with their .origin record; these may be changed"
+    },
+    "dsp": {
+      "path": "lib/effects",
+      "purpose": "effects and dynamics: delay, EQ, compressor, limiter (S11a-S11d)"
+    },
+    "painter": {
+      "path": "lib/painter",
+      "purpose": "everything drawn: scene, camera, card, GPU layer, shaders, the Painter facade"
+    },
+    "records": {
+      "path": "data",
+      "purpose": "data/records (fixed ids, moons) and data/bank (factory patches)"
+    },
+    "probes": {
+      "path": "probes",
+      "purpose": "probe executables, each with --selftest, and the shot program (pictures, benches)"
+    },
+    "plants": {
+      "path": "tools/plants",
+      "purpose": "planted-fault sources run by tools/plants.sh"
+    },
+    "docs": {
+      "path": "docs",
+      "purpose": "spec, delay spec, laws, licences, research, work order (plan and logs at the root: build.md, bugs.md, workflow-bugs.md)"
+    },
+    "tools": {
+      "path": "tools",
+      "purpose": "build.sh, step.py, gates/, hooks/, plants.sh and plants.d/, copy and compare tools"
+    }
+  },
+  "concepts": {
+    "cpp": [
+      "lib/**/*.cpp",
+      "lib/**/*.h",
+      "lib/**/*.mm",
+      "probes/**/*.cpp",
+      "probes/**/*.h",
+      "tools/plants/**/*.cpp"
+    ],
+    "audio": [
+      "lib/app/src/processor.h",
+      "lib/app/src/processor.cpp",
+      "lib/app/src/sound.h",
+      "lib/app/src/mixer.h",
+      "lib/engines/include/**",
+      "lib/engines/src/*.cpp",
+      "lib/effects/**"
+    ],
+    "dsp": [
+      "lib/effects/**",
+      "lib/engines/include/**",
+      "lib/engines/src/*.cpp"
+    ],
+    "params": [
+      "lib/app/src/controls.h",
+      "lib/app/src/params.h",
+      "lib/app/src/moonparams.h",
+      "lib/app/src/host_params.h",
+      "lib/app/src/processor.h",
+      "data/records/**",
+      "data/bank/**"
+    ],
+    "records": [
+      "data/records/**",
+      "data/bank/**",
+      "lib/world/include/stellix/world/state.h"
+    ],
+    "world": [
+      "lib/world/**",
+      "lib/snapshot/**",
+      "lib/app/src/launch.*",
+      "lib/app/src/demo.cpp"
+    ],
+    "painter": [
+      "lib/painter/**"
+    ],
+    "shaders": [
+      "lib/painter/src/card/*_glsl.h",
+      "lib/painter/src/card/ui2d_*.h",
+      "lib/painter/src/gl/glsl.h",
+      "**/*.wgsl"
+    ],
+    "ui": [
+      "lib/app/src/editor*.h",
+      "lib/app/src/live.*",
+      "lib/painter/src/view.*",
+      "lib/app/src/layer*",
+      "lib/app/src/*card*",
+      "lib/app/src/*control*"
+    ],
+    "app": [
+      "lib/app/**"
+    ],
+    "tests": [
+      "probes/**",
+      "lib/*/tests/**",
+      "tools/gates/**",
+      "tools/plants/**",
+      "tools/plants.d/**"
+    ],
+    "bench": [
+      "probes/shot/cpugate.cpp",
+      "probes/shot/simbench.cpp",
+      "probes/shot/shot.cpp",
+      "probes/machine/**"
+    ],
+    "build": [
+      "CMakeLists.txt",
+      "**/CMakeLists.txt",
+      "cmake/**"
+    ],
+    "claude": [
+      ".claude/skills/**",
+      "**/.claude/skills/**",
+      ".claude/agents/**",
+      ".claude/rules/**"
+    ],
+    "notes": [
+      "build.md",
+      "bugs.md",
+      "workflow-bugs.md",
+      "docs/**/*.md"
+    ],
+    "docs-folder": [
+      "docs"
+    ]
+  },
+  "files": {
+    "seeded_random": "lib/world/include/stellix/world/random_source.h",
+    "world_math": "lib/world/src/sim_fly.h",
+    "snapshot": "lib/world/src/sim.h",
+    "render_thread": "lib/app/src/editor.h"
+  },
+  "protected": [
+    "lib/engines/src/tabula/**",
+    "design/reference/**",
+    "build/evidence/**"
+  ],
+  "disable": [
+    "hooks/no-shipped-images.mjs",
+    "checks/one-seeded-random.json",
+    "hooks/stage-guard.mjs"
+  ],
+  "gates": {
+    "hover": "bash tools/gates/hover_gate.sh"
+  },
+  "commands": {
+    "build": "bash tools/build.sh build",
+    "test": "bash tools/build.sh test",
+    "test-one": "bash tools/build.sh test -R <name>",
+    "plants": "bash tools/plants.sh",
+    "run": "bash tools/build.sh run",
+    "step": "python3 tools/step.py status",
+    "cpu-gate": "bash tools/build.sh test -R stellix.cpu_gate",
+    "frame-bench": "stellix_shot --bench (built by `bash tools/build.sh build`)",
+    "picture-gates": "bash tools/build.sh test -R '_gate'"
+  },
+  "siblings": [
+    "../"
+  ],
+  "kinds": {
+    "audio-entry": {
+      "what": "processBlock and the processor, voices, sound and mixer",
+      "in": "lib/app/src/processor.* (audio files) or lib/engines",
+      "concepts": [
+        "audio",
+        "dsp",
+        "tests"
+      ],
+      "content": "\\b(processBlock|renderNextBlock|getNextAudioBlock)\\s*\\("
+    },
+    "world": {
+      "what": "travellers, strikes, rebounds, PULL, walls, the world step, the snapshot ring, seeded random",
+      "in": "world"
+    },
+    "snapshot": {
+      "what": "the one plain-data snapshot type the painter reads",
+      "in": "snapshot"
+    },
+    "engine": {
+      "what": "SlotSound and the copied Tabula voice (src/tabula is read-only)",
+      "in": "engines"
+    },
+    "dsp-block": {
+      "what": "effects and dynamics: delay, EQ, compressor, limiter",
+      "in": "dsp"
+    },
+    "gpu-code": {
+      "what": "anything that calls Dawn/WebGPU, the scene, camera, card, Painter facade",
+      "in": "painter",
+      "concepts": [
+        "painter",
+        "tests"
+      ],
+      "content": "\\b(wgpu::|wgpu[A-Z]\\w*\\s*\\(|WGPU[A-Z]\\w+)"
+    },
+    "shader": {
+      "what": "WGSL shaders",
+      "in": "painter",
+      "concepts": [
+        "painter"
+      ],
+      "files": [
+        "**/*.wgsl"
+      ]
+    },
+    "editor": {
+      "what": "the editor, live view and UI wiring",
+      "in": "app",
+      "concepts": [
+        "ui",
+        "painter",
+        "app",
+        "tests"
+      ],
+      "content": "\\bvoid\\s+(?:\\w+::)*paint\\s*\\(\\s*(?:juce::)?Graphics\\b"
+    },
+    "records": {
+      "what": "fixed-id records, moons, factory patches",
+      "in": "records"
+    },
+    "probe": {
+      "what": "a probe executable with --selftest, the shot program",
+      "in": "probes"
+    },
+    "plant": {
+      "what": "a planted-fault source for tools/plants.sh",
+      "in": "plants"
+    },
+    "docs": {
+      "what": "spec, laws, licences, research, work orders",
+      "in": "docs",
+      "concepts": [
+        "docs-folder"
+      ],
+      "files": [
+        "**/laws.md",
+        "**/*-spec.md"
+      ]
+    },
+    "tools": {
+      "what": "build.sh, step.py, gates, hooks, copy and compare tools",
+      "in": "tools"
+    }
+  },
+  "guards": {
+    "git": {
+      "safeRestore": "python3 tools/safe_restore.py <paths>",
+      "branchStart": "python3 tools/step.py start <STEP> \"task\" (work that is not a step: start --work <name> \"task\")",
+      "refuseTrunk": true,
+      "house": true
+    },
+    "copy": {
+      "tools": [
+        "tools/copy_tabula.py",
+        "tools/copy_reimport.py",
+        "tools/copy_promote.py"
+      ]
+    },
+    "time": {
+      "saveCommand": "add new files by path, then python3 tools/step.py save \"<note>\""
+    },
+    "browser": {
+      "pictureCommand": "the shot program (stellix_shot --render)"
+    },
+    "images": {
+      "guarded": [
+        "**"
+      ],
+      "allowed": [
+        "design/reference/**",
+        "build/pictures/**",
+        "out/**"
+      ]
+    }
+  },
+  "enable": [
+    "hooks/user-asks.mjs",
+    "hooks/idle-wake.mjs"
+  ]
+}

package/profiles/sub37.layout.json

@@ -0,0 +1,247 @@
+{
+  "_comment": "Sub37, tailored from docs/project.md answer (b) (surveyed 2026-10-31, main 0ee9e78). Install on the tree as it is: `init audio-core --profile sub37`, never gpu-painter or stellix. Complete: packs add no default folders. Probes stay in tools/ until the probes-to-tests/ decision is made once for every synthkit unit. paramIds reads the ids from the generated header and the panel binding ids from panel/bindings.json; the unit's own kFrozenIds gate in tools/tests_main.cpp stays the authority. No bench folder exists, so no bench concept. The tools/ folder is keyed \"probes\": folder-law treats a folder named tools as scripts only, and Sub37's C++ probes live there.",
+  "complete": true,
+  "folders": {
+    "app": {
+      "path": "src",
+      "purpose": "PluginProcessor and PluginEditor, flat in src/: parameters, programs, session, clock, the window, bindings, actions"
+    },
+    "audio": {
+      "path": "src/engine",
+      "purpose": "the audio-thread code: the paraphonic voice, the ladder, MultiDrive, envelopes, mod buses (Engine, Coeffs)"
+    },
+    "params": {
+      "path": "src/patch",
+      "purpose": "the program record and the sysex both ways"
+    },
+    "generated": {
+      "path": "src/generated",
+      "purpose": "Sub37Params.h and Sub37Factory.h, written by tools/gen_headers.py from data/; never hand edited"
+    },
+    "ui": {
+      "path": "src/ui",
+      "purpose": "the shell adapter; after the rebuild, the native panel component and its gestures"
+    },
+    "data": {
+      "path": "data",
+      "purpose": "params.csv (the parameter table, append only) and factory.csv (the factory bank)"
+    },
+    "panel": {
+      "path": "panel",
+      "purpose": "gen_panel.py (the panel's source), measure_overlay.py, and their output panel.json and bindings.json"
+    },
+    "resources": {
+      "path": "resources",
+      "purpose": "the PNG panel export (resources/native), until the native rebuild deletes it"
+    },
+    "design": {
+      "path": "design/reference",
+      "purpose": "reference pictures and their measured analysis; read-only, never read by a build step"
+    },
+    "probes": {
+      "path": "tools",
+      "purpose": "the probes and gates (*_probe.cpp, tests_main.cpp, clock_gate_test.cpp, param_reaches_audio.cpp), snapshot_main.cpp, gen_headers.py, measure scripts"
+    },
+    "cmake": {
+      "path": "cmake",
+      "purpose": "Siblings.cmake, CheckGenerated.cmake, GenVersion.cmake (copies of synthkit/cmake)"
+    },
+    "docs": {
+      "path": "docs",
+      "purpose": "laws, research, manual audit, provenance, the gates, licences (logs at the root: bugs.md, todo.md, build.md)"
+    }
+  },
+  "concepts": {
+    "cpp": [
+      "src/**/*.cpp",
+      "src/**/*.h",
+      "tools/**/*.cpp",
+      "tools/**/*.h"
+    ],
+    "audio": [
+      "src/engine/**",
+      "src/PluginProcessor.h",
+      "src/PluginProcessor.cpp"
+    ],
+    "dsp": [
+      "src/engine/**"
+    ],
+    "params": [
+      "src/PluginProcessor.h",
+      "src/PluginProcessor.cpp",
+      "src/patch/**",
+      "src/generated/**",
+      "data/params.csv"
+    ],
+    "presets": [
+      "data/factory.csv",
+      "data/params.csv",
+      "src/patch/**"
+    ],
+    "generated": [
+      "src/generated/**"
+    ],
+    "ui": [
+      "src/PluginEditor.h",
+      "src/PluginEditor.cpp",
+      "src/ui/**"
+    ],
+    "app": [
+      "src/PluginProcessor.*",
+      "src/PluginEditor.*"
+    ],
+    "panel-spec": [
+      "panel/**",
+      "**/bindings.json"
+    ],
+    "reference": [
+      "design/reference/**"
+    ],
+    "tests": [
+      "tools/*_probe.cpp",
+      "tools/tests_main.cpp",
+      "tools/clock_gate_test.cpp",
+      "tools/param_reaches_audio.cpp"
+    ],
+    "build": [
+      "CMakeLists.txt",
+      "**/CMakeLists.txt",
+      "cmake/**"
+    ],
+    "claude": [
+      ".claude/skills/**",
+      "**/.claude/skills/**",
+      ".claude/agents/**",
+      ".claude/rules/**"
+    ],
+    "notes": [
+      "bugs.md",
+      "todo.md",
+      "build.md",
+      "workflow-bugs.md",
+      "docs/**/*.md"
+    ],
+    "docs-folder": [
+      "docs"
+    ]
+  },
+  "files": {},
+  "protected": [
+    "design/reference/**"
+  ],
+  "disable": [],
+  "commands": {
+    "configure": "cmake -B build -DCMAKE_BUILD_TYPE=RelWithDebInfo",
+    "build": "buildq cmake --build build",
+    "test": "buildq ctest --test-dir build --output-on-failure",
+    "test-one": "buildq ctest --test-dir build --output-on-failure -R <name>",
+    "standalone": "buildq cmake --build build --target Sub37_Standalone",
+    "panel-check": "npm run panel:validate && npm run panel:check",
+    "panel-export": "npm run panel:native",
+    "snapshot": "Sub37Snapshot (built by the build command) writes the editor to PNG"
+  },
+  "siblings": [
+    "../"
+  ],
+  "paramIds": {
+    "extensions": "(\\.(cpp|h|hpp|cc|mm)|bindings\\.json)$",
+    "patterns": [
+      "\\{\\s*\"([a-z][a-z0-9_]*)\",\\s*\"[^\"]*\",\\s*\"(?:float|choice)\"",
+      "\"([a-z][a-z0-9_]*)\":\\s*\\{\\s*\"kind\""
+    ]
+  },
+  "kinds": {
+    "audio-entry": {
+      "what": "processBlock and the audio-thread engine: voice, ladder, MultiDrive, envelopes, mod buses",
+      "in": "audio",
+      "concepts": [
+        "audio",
+        "tests"
+      ],
+      "content": "\\b(processBlock|renderNextBlock|getNextAudioBlock)\\s*\\("
+    },
+    "processor": {
+      "what": "the processor: parameter registration, programs, session, clock",
+      "in": "app"
+    },
+    "editor": {
+      "what": "the window and anything that paints: the editor, the native panel component, its gestures",
+      "in": "ui",
+      "concepts": [
+        "ui",
+        "tests"
+      ],
+      "content": "\\bvoid\\s+(?:\\w+::)*paint\\s*\\(\\s*(?:juce::)?Graphics\\b"
+    },
+    "patch": {
+      "what": "the program record and the sysex both ways",
+      "in": "params"
+    },
+    "generated": {
+      "what": "the generated headers (Sub37Params.h, Sub37Factory.h): run tools/gen_headers.py, never hand edit",
+      "in": "generated",
+      "concepts": [
+        "generated"
+      ],
+      "files": [
+        "**/Sub37Params.h",
+        "**/Sub37Factory.h"
+      ]
+    },
+    "bank": {
+      "what": "the parameter table (append only) and the factory bank",
+      "in": "data",
+      "concepts": [
+        "presets"
+      ],
+      "files": [
+        "**/factory.csv",
+        "**/params.csv"
+      ]
+    },
+    "panel": {
+      "what": "the panel source (gen_panel.py) and its output panel.json and bindings.json",
+      "in": "panel",
+      "concepts": [
+        "panel-spec"
+      ],
+      "files": [
+        "**/panel.json",
+        "**/bindings.json"
+      ]
+    },
+    "probe": {
+      "what": "a probe or gate with --selftest (the house template keeps them in tools/)",
+      "in": "probes",
+      "concepts": [
+        "tests"
+      ],
+      "files": [
+        "**/*_probe.cpp"
+      ]
+    },
+    "reference": {
+      "what": "reference pictures and their measured analysis",
+      "in": "design"
+    },
+    "export": {
+      "what": "the PNG panel export, until the native rebuild deletes it",
+      "in": "resources"
+    },
+    "docs": {
+      "what": "laws, research, provenance, the gates, licences",
+      "in": "docs",
+      "concepts": [
+        "docs-folder"
+      ],
+      "files": [
+        "**/laws.md",
+        "**/*-spec.md"
+      ]
+    },
+    "tools": {
+      "what": "scripts: gen_headers.py, measure scripts, the snapshot renderer",
+      "in": "probes"
+    }
+  }
+}

package/prompts/scan-review.md

@@ -0,0 +1,40 @@
+Review the copy of this project in the current folder, and write a report the owner can act on. `claude-packs scan` already ran every check over every file; its report is `claude-packs-scan.md` in this folder. The checks find patterns. Your job is the bugs they cannot see, and to say which of their hits are real.
+
+<constraints>
+Always do:
+- Treat this as read-only. This folder is a throwaway copy; the owner's code is elsewhere. The only file you write is `claude-packs-review.md`.
+- Read the code. Every finding names the file and the symbol.
+- Split the review by concern, one reviewer each, so none of them skims:
+  1. **Security:** who can reach what. Injection and XSS through query strings and stored text, open redirects, OAuth `redirect_uri`, what the CSP really stops, authorization on every route, secrets and prompts written to disk or logs.
+  2. **Runaway work:** anything that sets off itself: a watcher that writes what it watches, retries with no limit, loops with no stop, polling, anything that costs money per call.
+  3. **Work that disappears:** a failed send marked delivered, a box cleared before the send succeeded, a queue item lost on restart, errors swallowed, no shutdown handling.
+  4. **Docs that lie:** compare CLAUDE.md, the README and the deploy notes with the code. A stale CLAUDE.md misleads every session, so name each claim that is no longer true: a stack, a command, a folder.
+  5. **Platform and operations:** what behaves differently on the other OS, signals that do nothing, a deploy that drops in-flight work.
+- Verify the hits in `claude-packs-scan.md`. Sample each check, and count real and false for what you read. Give counts only for what you counted; say so when a count is partial.
+- Mark every finding with how you know it: **measured** (you ran it), **read in the code** (you traced it, did not fire it), or **claim** (likely, not confirmed). Measure what you can run safely in this copy.
+- Rank by what happens to the owner, worst first, and give each finding one plain sentence of consequence.
+- List checks that misfired or missed something: they are bugs in claude-packs, not in this project.
+
+Never do:
+- Change, format or "fix" any code.
+- Connect to a production database, a live API or any service with real credentials, or use any token you find. A finding that needs production to confirm says so, and the owner decides.
+- Print a secret's value. Name the file and line.
+- Call a hit a bug because a check fired, or call the project clean because the checks passed.
+</constraints>
+
+## Report format
+
+Lead with the most urgent finding, in one sentence.
+
+**What to install:** the configuration and packs, why, and what was left out and why. If the scan's recommendation is wrong for this project, say so.
+
+**What the review found:** hits checked and how many were real, then the worst findings as a table:
+
+| Bug | Problem | How I know |
+|---|---|---|
+
+Then the rest by concern, in plain sentences: what happens, not how the code is shaped.
+
+**Decisions for you:** each rule that does not fit this project, with your recommendation and the count it affects.
+
+**Next step:** the order to fix things in, the first one named. Nothing is fixed, merged or deployed by this review.

package/prompts/survey.md

@@ -0,0 +1,82 @@
+Survey this repository and write `docs/project.md`: a complete, factual description of how the project is laid out and how its code is written. It will be used to tailor the claude-packs rules, checks, hooks and skills so each one triggers exactly where it's needed.
+
+<constraints>
+Always do:
+- Read the code. Every statement in project.md comes from files you opened, with the path cited. Where something isn't in the repo, write "not present", never a guess.
+- Treat this as read-only: the only file you create or change is `docs/project.md`.
+- Use real paths and real names: folders, files, classes, namespaces, CMake targets, test names.
+- Keep it complete but plain: tables and short lists, no essays.
+
+Never do:
+- Change, move, format or "fix" any code, config, rule or skill while surveying.
+- Describe what the spec *plans* as if it exists. Mark planned-but-absent things as planned, with the spec section.
+- Run builds, installers or anything that writes files (reading `git log`, `ls`, `cmake --help`-style queries is fine).
+</constraints>
+
+## What project.md must contain
+
+### 1. Folder tree
+The full directory tree (folders only, to depth 4, excluding `build*`, `.git`, `node_modules`, `JUCE`, `_deps`, vendored libraries), and for every folder: what lives there, file count, main languages, and one example file.
+
+### 2. Where each concern lives
+A table with one row per concern: the folders and files that hold it, the main classes, and whether it runs on the audio thread, the message thread, the render thread, or offline.
+Concerns: plugin/standalone entry and processor; voices and voice allocation; sound engines (each oscillator kind); filters; effects (each); dynamics (EQ, compressor, limiter); the world (travellers, hits, pushes, tick); the world snapshot and handoff; the seeded random generator; parameters and IDs; patches, presets, state save/load, reset; records (layout and state); the painter / GPU code; shaders; UI input, gestures, camera, picking; undo; MIDI, MPE, note tracking, sustain; tempo and clock; tests and gates; benchmarks; tools and scripts; research data.
+
+### 3. How code is written
+- C++ standard, compiler flags (from CMake), warnings, sanitizer presets.
+- Naming conventions (files, classes, members, constants, namespaces), with examples.
+- File-size distribution: largest 15 source files with line counts, and how many exceed 300 lines.
+- Error handling style, ownership style (unique_ptr, raw, references), use of `juce::` vs `std::` types.
+- How modules are structured (base classes, registries, "everything extends from core"), with the base class names.
+- Threading model: which threads exist, and what communicates between them (atomics, FIFOs, snapshots, locks — name the files).
+- How parameters are declared and how their IDs are made.
+
+### 4. Build, dependencies, tests
+- Build system and targets (CMake target names, formats built: standalone/VST3/AU/CLAP).
+- JUCE version (read it from the repo), Dawn or other GPU library and version or commit, every other third-party library with version and licence.
+- Test framework, test target names, how gates and planted faults are run, golden files and where they live.
+- CI, if any.
+
+### 5. Claude setup already in the repo
+- Contents of `CLAUDE.md` and any nested `CLAUDE.md` (summarise, quote headings).
+- Every file in `.claude/` (rules with their `paths:`, skills with their descriptions, hooks and what they block, settings), and any `build.md`, `bugs.md`, `step.py`, work orders and laws files.
+- Anything that duplicates or conflicts with another rule, skill or hook.
+
+### 6. Proposed layout for claude-packs
+Finish with this JSON block, filled from what you found (use the real folder paths; add folders that exist and matter; mark a folder `"planned": true` if the spec calls for it but it doesn't exist yet):
+
+```json
+{
+  "folders": {
+    "app":     { "path": "", "purpose": "" },
+    "audio":   { "path": "", "purpose": "" },
+    "engines": { "path": "", "purpose": "" },
+    "dsp":     { "path": "", "purpose": "" },
+    "params":  { "path": "", "purpose": "" },
+    "world":   { "path": "", "purpose": "" },
+    "records": { "path": "", "purpose": "" },
+    "painter": { "path": "", "purpose": "" },
+    "shaders": { "path": "", "purpose": "" },
+    "ui":      { "path": "", "purpose": "" },
+    "tests":   { "path": "", "purpose": "" },
+    "bench":   { "path": "", "purpose": "" },
+    "docs":    { "path": "", "purpose": "" },
+    "tools":   { "path": "", "purpose": "" }
+  },
+  "extra_folders": {},
+  "files_to_move": [ { "from": "", "to": "", "why": "" } ],
+  "special_files": {
+    "seeded_random": "",
+    "world_math": "",
+    "render_thread": "",
+    "snapshot": ""
+  }
+}
+```
+
+`files_to_move` lists source files that sit outside any folder above, or in the wrong one (for example drawing code in an audio folder). List them; don't move them.
+
+### 7. Open questions
+Anything you couldn't determine, as a numbered list.
+
+When done, reply with one line: the path of project.md and how many open questions it has.