project-mdlisted

# CLAUDE.md Generation Skill ## Purpose `CLAUDE.md` is the single source of truth Claude Code loads at the start of every session. It must encode everything Claude needs to work correctly on this project without re-explanation. Write it once at init time; update it when the project changes materially. --- ## Step 1 — Gather inputs at init time Ask the human the following questions in sequence. Do not proceed until all are answered. ### 1a — Language ``` What language(s) does this project use? 1. Python only 2. Rust only 3. Both (Python + Rust, e.g. PyO3 bindings or separate components) ``` Store as `LANGUAGE ∈ {python, rust, both}`. ### 1c — Project type ``` What type of project is this? 1. ML — machine learning models, training loops, W&B, data pipelines 2. Physics — numerical simulation, PDEs, stochastic equations, physical units 3. Both — ML applied to physical systems (e.g. surrogate models, BEC, atomtronics) 4. General — software, tooling, analysis; no domain-specific physics or ML ``` Store the answer as `PROJECT_TYPE ∈ {ml, physics, both, general}`. ### 1d — Physics context (skip if PROJECT_TYPE = ml or general) Ask: ``` Describe the physical system briefly: - What equations govern the system? (e.g. SGPE, GPE, Maxwell-Bloch) - What dimensionality? (1D / 2D / 3D) - What unit system? (SI / natural / dimensionless) - Key physical constraints to enforce? (e.g. normalisation, conservation laws, boundary conditions, symmetry) - Known