Skip to content

armgit / SOMA

Public Imported from GitHub
0

Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice

Entscheidung E77, Plan und Changelog: Skill Parametrische Modelle

Kai-Jungsthoefel3b1738da8bfd
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 70e7454..027da09 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@ eigenen Abschnitt mit Datum und Git-Tag.
### Neu
- Technische Zeichnungen: Der Agent beschreibt eine Zeichnung in `drawings/*.py` (`soma.drawing`) mit Ansichten, Schnitten, Einzelheiten, Maßen, Texten und Stückliste, `soma drawing build` schreibt PDF und DXF nach `output/drawings/` und ein Bild, mit dem der Agent sein Ergebnis prüft. Die Maße werden immer am Modell gemessen, eine Prüfung meldet Überschneidungen, Maße neben Kanten und getippte Zahlen. Dazu der Skill „Technical drawings“ mit den Regeln nach ISO (E76).
+- Skill „Parametric models“, bei neuen Modellen immer an: Der Agent legt erst fest, was die Größe bestimmt und was beim Ändern stehen bleibt, gibt wenige unabhängige Werte als Parameter frei, leitet den Rest daraus ab und baut das Modell an den Grenzen jedes Bereichs zur Probe. Einstellbar sind die Höchstzahl der Parameter und der Umfang dieser Prüfung (E77).
### Geändert
diff --git a/DECISIONS.md b/DECISIONS.md
index 19b3a48..958b12a 100644
--- a/DECISIONS.md
+++ b/DECISIONS.md
@@ -79,3 +79,4 @@
| 74 | Parameter für den Nutzer | **Der Agent gibt mit `param()` im Code die Werte frei, die der Nutzer selbst ändern soll, nicht alle Konstanten** (etwa Kurbelwinkel des Modellmotors, Bauraum der CNC-Maschine). Die App zeigt sie im Parameter-Panel (Entwurf 2, Bild 6), Ändern baut neu. **Jedes Feld lässt sich auf den Wert des Agenten zurücksetzen** | Wunsch des Nutzers nach Brainstorming (Kommentare wie im OpenSCAD-Customizer, Funktionsaufruf, eigene Tabelle). Gewählt: Funktionsaufruf nach Vorbild Streamlit/Gradio. Wegen der Rücksetzung bleibt der Wert des Agenten im Code, die Werte des Nutzers stehen getrennt in `parameters.json`. Das ersetzt die Anmerkung im Entwurf, der Wert werde in den Code geschrieben. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |
| 75 | Größe der ZIP | **`renders/` kommt nicht mehr in die ZIP** (im Verlauf schon seit E64 nicht). **Vor dem Schreiben der ZIP packt die App die Git-Objekte** (`git repack`), ähnliche Fassungen von `output/model.step` werden als Unterschied gespeichert. Commits und Hashes bleiben, nichts wird gelöscht | Wunsch des Nutzers nach Prüfung zweier ZIPs (Motor 153 MB, Hotwire 12.5 MB, Code jeweils unter 100 KB): „Ja wir lassen renders aus der git repack können wir auch machen wenn das keine probleme verursacht“. Verträgt sich mit E35, weil `repack` keine Historie umschreibt. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |
| 76 | Technische Zeichnungen | **Der Agent zeichnet selbst, soma liefert einen Werkzeugkasten statt automatischer Anordnung oder Bemaßung.** Eine Zeichnung ist eine Python-Datei `drawings/*.py`: Blatt mit Rahmen und Schriftfeld (abschaltbar), Ansichten aus beliebigen Formen (Bauteil, Gruppe, Zusammenbau, eigene CadQuery-Form) mit verdeckten Kanten, Schnitte, Einzelheiten, Maße an Modellpunkten mit gemessenem Wert, dazu freies Zeichnen direkt mit ezdxf. Ausgabe DXF, PDF und **ein** PNG in hoher Auflösung, Ausschnitte schneidet der Agent bei Bedarf selbst zu. `check` meldet nur. **Best Practices kommen in einen optionalen Skill** | Wunsch des Nutzers nach Brainstorming: „nicht zu viel automatisieren. Der Agent muss viel Spielraum haben … notfalls auch Sachen komplett selbst zeichnen“, dazu „auf jeden Fall einen Skill … für Best Practices“ und „ich glaube nicht, dass mehrere Exporte nötig sind“. Der erste Vorschlag (Ansichten und Maße legt soma selbst an) ist damit verworfen. Technik: verdeckte Kanten mit HLR aus OCP, DXF mit ezdxf, PDF und PNG aus derselben DXF über matplotlib, keine neuen Pakete. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |
+| 77 | Skill: Parametrische Modelle | **Mitgeliefert wird ein Skill „Parametric models“ (`parametrik.md`), damit Agenten mit `param()` gute parametrische Modelle bauen:** Konstruktionsabsicht zuerst, wenige unabhängige Parameter, alles Übrige abgeleitet, Bereiche, in denen jeder Wert baut, Formelemente, die Änderungen überstehen, Felder im Panel, Prüfung an den Bereichsgrenzen | Wunsch des Nutzers („ein Skill … damit die Agenten möglichst gute parametrische Modelle produzieren, mit der param() Funktion“). Ergänzt 45 und 74. Auslegung (nicht ausdrücklich bestätigt): Kategorie Arbeitsweise, ab Werk „Immer“ (jedes Modell hat Parameter, Regel 7 in `AGENTS.md`), Einstellungen Höchstzahl der Parameter und Umfang der Bereichsprüfung, Prüfung ohne neuen Befehl über eine Kopie des Projekts. Umsetzung in PLAN.md, Abschnitte 10 und 11 |
diff --git a/PLAN.md b/PLAN.md
index 0c789fd..712cf48 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -302,21 +302,22 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben
*Skills (E17, E46, E55; 47 Prüfungen in `app/test/skills.mjs`, 14 Einheitentests):*
-- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 16 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten, zwei kamen mit E58 dazu, FEM mit E65, Technische Zeichnungen mit E76). Inhalt und Kopf (Titel, Beschreibung, Themen, Einstellungen für die Oberfläche) sind auf Englisch, der Kopf war bis E73 deutsch. Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.
+- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 17 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten, zwei kamen mit E58 dazu, FEM mit E65, Technische Zeichnungen mit E76, Parametrische Modelle mit E77). Inhalt und Kopf (Titel, Beschreibung, Themen, Einstellungen für die Oberfläche) sind auf Englisch, der Kopf war bis E73 deutsch. Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.
- **Stufen (E55, Wunsch des Nutzers):** Jeder Skill steht je Modell auf **Aus**, **Bei Bedarf** oder **Immer** (Umschalter mit drei Feldern in der Karte, „Immer“ hebt die Karte orange hervor, „Aus“ nimmt sie zurück). Bei Bedarf und Immer kopieren den Skill nach `.soma/skills/<id>.md`, tragen ihn in `project.json` ein (`skills` für Immer wie bisher, `skills_on_demand` für Bei Bedarf, auch in der App-Kopie, E27) und listen ihn im Abschnitt am Ende der `AGENTS.md` (zwischen `<!-- soma:skills -->` und `<!-- /soma:skills -->`, bei älteren Projekten ohne diesen Abschnitt wird er angehängt). Der Abschnitt hat zwei Listen: „Always follow“ (vor jeder Änderung lesen und befolgen) und „Read when relevant“ (je Skill der Anlass aus dem neuen Kopffeld `when`, etwa „Read when the parts will be 3D printed on a filament printer (FDM)“, nicht alle vorab lesen). Die Kopie eines Skills „Bei Bedarf“ hat unter der Überschrift einen Hinweis: dem Skill folgen, solange das Thema gilt, das in `NOTES.md` unter `## Requirements` festhalten (sonst weiß eine spätere Sitzung nichts davon), die Werte sind Standardwerte der App (vom Nutzer eingestellte nennt er mit Namen), also nennen oder nachfragen, und in der App lässt er sich auf „Immer“ stellen. **Aus** entfernt Kopie und Eintrag. Jedes Umstellen zählt als ungespeicherte Änderung und wandert mit Snapshot, Git und ZIP. Ein Wechsel zwischen Bei Bedarf und Immer schreibt die Kopie neu, eine unveränderte ohne Sicherung.
- **Einstellungen (Wunsch des Nutzers):** Ein Skill erklärt im Kopf Variablen, etwa `var overhang: 45 | ° | Max. Überhangwinkel | 10..85` (Standard, Einheit, Bezeichnung, Bereich) oder eine Auswahl `var material: PLA | | Material | PLA, PETG, ABS, ASA, TPU` (Einträge auch als `wert=Anzeige`). Im Text stehen Platzhalter wie `{{overhang}}`. Im Panel stehen die Einstellungen im aufgeklappten Skill: Zahlenfelder (Komma oder Punkt, Enter übernimmt, Escape verwirft) und Auswahllisten, geänderte Werte orange mit Knopf „zurück auf den Standard“, darunter in der Karte „Eingestellt: …“. Die App prüft jeden Wert (Bereich, Auswahl) und lehnt Falsches mit Grund ab. Gespeichert werden nur abweichende Werte, in `project.json` unter `skill_settings`, auch für ausgeschaltete Skills (sie gelten beim Einschalten). Die Kopie im Projekt enthält die eingesetzten Werte, im Text und im Kopf, der Agent liest also konkrete Zahlen. Eine Änderung schreibt die Kopie eines eingeschalteten Skills neu, eine von Hand geänderte Kopie kommt vorher in die Sicherung. Welche Einstellungen die mitgelieferten Skills haben, steht unten. Ein Skill ohne Einstellungen ist erlaubt.
- **Agent:** Ein laufender Agent liest `AGENTS.md` nicht von selbst neu. Die Meldung nach dem Umstellen oder Einstellen sagt das, „An Agent geben“ fügt `[Skill: .soma/skills/<id>.md] ` ein, mit geänderten Einstellungen etwa `[Skill: .soma/skills/3d-druck.md, Einstellungen: Max. Überhangwinkel = 50°] `. `AGENTS.md` erklärt dem Agenten diese Notiz. Den Knopf gibt es bei Bedarf und Immer, bei Bedarf heißt er: jetzt anwenden.
- **Ansehen:** Die Kopie öffnet sich im Code-Panel, nur lesbar („Kopie eines Skills“).
- **Kategorien (E46, Wunsch des Nutzers):** `category` im Kopf ordnet einen Skill unter eine Überschrift im Panel: Arbeitsweise, Fertigungsverfahren, Konstruktionswissen, Prüfen und Zeigen (E58). Eine Kategorie steht dort, wo ihr erster Skill laut `order` steht, Skills ohne Kategorie (etwa aus einer neueren App) unter „Weitere“ am Ende.
-- **Skills für neue Modelle (E46, E55, Wunsch des Nutzers):** `default:` im Kopf gibt die Stufe bei neuen Modellen vor (`always`, `on-demand` oder `off`, ohne Angabe Bei Bedarf). Mitgeliefert: Immer für Konstruktionsablauf, Sauber modellieren und Normteile (E48), alle übrigen Bei Bedarf. Im aufgeklappten Skill stellt die Auswahl „Stufe bei neuen Modellen“ das für die ganze App um. Gespeichert wird nur, was vom Kopf abweicht, in `state.json` der App-Daten (`skill_defaults`, Einträge von vor E55 mit an/aus gelten als Immer/Bei Bedarf). Das offene Modell bleibt dabei, wie es ist. Ein neues Modell bekommt die Skills vor dem ersten Build, mit Kopie, Eintrag in `project.json` und `AGENTS.md`, also schon im Startcommit, und mit den Standardwerten. Weicht die Vorgabe von „Bei Bedarf“ ab, nennt die Karte sie („Bei neuen Modellen: Immer“). Lässt sich ein Skill nicht kopieren, bleibt er aus, das Anlegen geht weiter.
+- **Skills für neue Modelle (E46, E55, Wunsch des Nutzers):** `default:` im Kopf gibt die Stufe bei neuen Modellen vor (`always`, `on-demand` oder `off`, ohne Angabe Bei Bedarf). Mitgeliefert: Immer für Konstruktionsablauf, Sauber modellieren, Parametrische Modelle (E77) und Normteile (E48), alle übrigen Bei Bedarf. Im aufgeklappten Skill stellt die Auswahl „Stufe bei neuen Modellen“ das für die ganze App um. Gespeichert wird nur, was vom Kopf abweicht, in `state.json` der App-Daten (`skill_defaults`, Einträge von vor E55 mit an/aus gelten als Immer/Bei Bedarf). Das offene Modell bleibt dabei, wie es ist. Ein neues Modell bekommt die Skills vor dem ersten Build, mit Kopie, Eintrag in `project.json` und `AGENTS.md`, also schon im Startcommit, und mit den Standardwerten. Weicht die Vorgabe von „Bei Bedarf“ ab, nennt die Karte sie („Bei neuen Modellen: Immer“). Lässt sich ein Skill nicht kopieren, bleibt er aus, das Anlegen geht weiter.
- **Robustheit (E28):** Nichts wird still ersetzt: Weicht die Kopie im Projekt von der mitgelieferten Fassung ab (vom Agenten geändert, ältere App), meldet die Karte das, und vor dem Überschreiben oder Entfernen kommt sie nach `workspace-backups/<id>-skills/`. Fehlt die Datei eines eingeschalteten Skills, nennt das die Karte und der Projekt-Check, angelegt wird nichts. Fehlt `AGENTS.md`, wird der Skill trotzdem umgestellt, mit Warnung, die Datei wird nicht neu erzeugt. Nennt `AGENTS.md` einen eingeschalteten Skill nicht oder unter der anderen Stufe (etwa nach dem Zurückholen einer alten Fassung), steht das in der Karte. Skills, die nur im Projekt liegen (aus einer neueren App), bleiben gültig.
-*Skill-Inhalte (E45):* allgemeine Regeln, kurz gehalten (meist 40 bis 60 Zeilen samt Kopf), damit auch kleinere Modelle sie befolgen. Die Reihenfolge im Panel folgt `order`: Arbeitsweise (1 bis 2), Verfahren (10 bis 14), Konstruktionswissen (20 bis 24), Prüfen und Zeigen (30 bis 31). Den Gehäusebau gibt es nicht mehr (E47). In Projekten, die ihn eingeschaltet haben, bleibt die Kopie gültig, die Karte meldet „Diese App bringt den Skill nicht mit“.
+*Skill-Inhalte (E45):* allgemeine Regeln, kurz gehalten (meist 40 bis 60 Zeilen samt Kopf), damit auch kleinere Modelle sie befolgen. Die Reihenfolge im Panel folgt `order`: Arbeitsweise (1 bis 3), Verfahren (10 bis 14), Konstruktionswissen (20 bis 24), Prüfen und Zeigen (30 bis 31). Den Gehäusebau gibt es nicht mehr (E47). In Projekten, die ihn eingeschaltet haben, bleibt die Kopie gültig, die Karte meldet „Diese App bringt den Skill nicht mit“.
| Skill | Inhalt | Einstellungen |
|---|---|---|
| Konstruktionsablauf | Anforderungen klären und in `NOTES.md` festhalten, vom Groben ins Feine, kleine Schritte, kurzer Bericht | Fehlende Angaben (erst fragen oder annehmen), Detailgrad (Konzept, Prototyp, fertigungsreif) |
| Sauber modellieren (CadQuery) | Parameter, ein Teil je Funktion, Reihenfolge der Schritte, robuste Selektoren, typische Fehler, Gültigkeit prüfen | keine |
+| Parametrische Modelle (E77) | Konstruktionsabsicht (was die Größe bestimmt, was stehen bleibt, innen oder außen), Auswahl der Parameter (unabhängig, Kommazahl oder ganze Zahl, Auswahl mit Tabelle), Bereiche, in denen jeder Wert baut, alles Übrige abgeleitet, Formelemente, die Änderungen überstehen, Felder im Panel, Bereichsprüfung über eine Kopie des Projekts, spätere Änderungen | Höchstzahl der Parameter (15), Bereichsprüfung (jeder Parameter, nur Hauptmaße, nur auf Wunsch) |
| 3D-Druck (FDM) | überarbeitet: Materialhinweise, Prüfcode für Bauraum und Überhänge (nur ebene Flächen) | wie bisher |
| 3D-Druck Harz und Pulver | Wände, Ablauflöcher, Stützen und Saugwirkung, Spiel, Gewinde | Verfahren (SLA, SLS), Mindestwand, Spiel |
| CNC-Fräsen und Drehen | Innenradien, Taschentiefe, Aufspannungen, Bohrungen und Gewinde, Drehteile, Angaben für die Werkstatt | Material, kleinster Fräser, Achsen |
@@ -332,7 +333,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben
| Animation und Video (E58) | Aufbau einer Datei in `animations/`, Gelenke, Zeitleiste, Kamera, Texte, prüfen mit `soma anim info` und `check`, ansehen als Übersicht, Video nur auf Wunsch | keine |
| Technische Zeichnungen (E76) | Zweck klären und planen, Blatt und Maßstab, Ansichten und Projektionsmethode, Schnitte und Einzelheiten, Bemaßung nach ISO 129 (Funktionsmaße, jedes Maß einmal, nie tippen), Toleranzen und Hinweise, Zusammenbau mit Positionen und Stückliste, frei zeichnen mit ezdxf, bauen und das Bild ausschnittweise prüfen | Norm (ISO, ASME), Blattgröße, Allgemeintoleranz, Sprache auf der Zeichnung |
-Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuche, Mutternfalle, Tasche mit Innenradius, Blechwinkel mit gleicher Dicke in der Biegung, Bewegungsprüfung, Zeichnung einer Platte ohne Hinweise der Prüfung).
+Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuche, Mutternfalle, Tasche mit Innenradius, Blechwinkel mit gleicher Dicke in der Biegung, Bewegungsprüfung, Lagerplatte der Parametrik an allen Bereichsgrenzen, Zeichnung einer Platte ohne Hinweise der Prüfung).
*Normteile (E48, Wunsch des Nutzers; 35 Prüfungen in `app/test/fasteners.mjs`):*
@@ -447,7 +448,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- **Panel:** Eintrag „Parameters“ in der Leiste (Symbol Schieber, „Options“ bekommt das Zahnrad). Zeilen mit Name, darunter Name im Code und der Bereich des Agenten („30–200 mm“, „≥ 2 mm“, „3 options“, rot außerhalb, Wunsch des Nutzers), daneben das Feld nach Art: Zahlenfeld mit Einheit, Stepper, Schalter, Auswahl, Textfeld. Gruppen wie im Code (ohne Gruppe zuerst), einklappbar. Aufgeklappt: Schieber (bei min und max, gebaut wird beim Loslassen), Erklärung, Wert im Code mit Bereich, Sprung in den Code, „Send to agent“ (`[Parameter: "Length" (LENGTH) = 100 mm, set in the app, code default 60 mm, model.py line 10]`). Abweichende Werte orange mit Knopf zum Zurücksetzen, unten „N changed“ mit „Reset all“.
- **Ändern:** Enter, Verlassen des Felds, Schalter, Auswahl oder Loslassen des Schiebers schreiben die Datei und bauen gleich, auch bei ausgeschaltetem Auto-Build (wie Strg+S im Editor, E39). Pfeiltasten und Stepper sammeln kurz. Ein Wert gleich dem im Code entfernt den Eintrag. Ändert der Agent die Datei, baut der Watcher wie bei Code.
- **Melden statt reparieren (E28):** Ein Wert außerhalb des Bereichs wird eingetragen und gebaut, die Zeile ist rot, `soma build` warnt. Unpassende Werte (2.5 für eine ganze Zahl) gelten nicht, die Zeile ist rot. Werte ohne Parameter stehen in einem eigenen Abschnitt mit „Remove“. Eine unlesbare `parameters.json` wird gemeldet und nie überschrieben. Scheitert der Build nach einer Änderung, bietet das Panel „Back to <Wert davor>“ und „Send to agent“, nimmt aber nichts selbst zurück. Scheitert er vor den Parametern (Syntaxfehler), bleibt die Liste des vorigen Builds mit Hinweis bedienbar.
-- **Vorlage und Agent:** Die Vorlage macht LENGTH, WIDTH, HEIGHT und WALL zu Parametern (an allen Bereichsgrenzen gebaut). `AGENTS.md` (Regel 7) sagt, welche Werte Parameter werden (Hauptmaße, Anzahlen, Optionen, Stellungen, meist 3 bis 15), dass der Bereich über die ganze Spanne funktionieren soll und was mit `parameters.json` zu tun ist. Der Skill „Clean CadQuery modeling“ verweist darauf. Leerer Zustand mit „Ask the agent“.
+- **Vorlage und Agent:** Die Vorlage macht LENGTH, WIDTH, HEIGHT und WALL zu Parametern (an allen Bereichsgrenzen gebaut). `AGENTS.md` (Regel 7) sagt, welche Werte Parameter werden (Hauptmaße, Anzahlen, Optionen, Stellungen, meist 3 bis 15), dass der Bereich über die ganze Spanne funktionieren soll und was mit `parameters.json` zu tun ist. Der Skill „Clean CadQuery modeling“ verweist darauf, der Skill „Parametric models“ (E77) erklärt, wie gute Parameter aussehen und wie der Agent ihre Bereiche prüft. Leerer Zustand mit „Ask the agent“.
- **Auswertungen:** `soma analyze` (auch FEM), Animationen und Export führen das Modell über `run_model` aus und rechnen so mit den Werten des Nutzers (Kragarm 4 mm: 31.7 MPa, 8 mm im Panel: 7.7 MPa). Nach einer Änderung gelten Ergebnisse und Animationen als veraltet, in der App (`newestSourceMtime`) wie in `soma` (`animrun.newest_source`, für `soma anim` und `soma render --result`). Neu gerechnet wird nicht von selbst.
- **Grenzen:** Jede Änderung baut das ganze Modell, auch eine reine Stellung wie ein Kurbelwinkel (bei großen Modellen Sekunden). Ein Ergebnis merkt sich nicht, mit welchen Werten es gerechnet wurde. Getestet unter Windows.
@@ -458,6 +459,13 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- **Packen vor der ZIP:** Nach dem Snapshot packt `GitRepo.pack()` die Objekte (`git repack -a -d --keep-unreachable -n`), ähnliche Fassungen werden als Unterschied gespeichert. Commits und Hashes bleiben, nichts wird gelöscht (E35), auch nicht Unerreichbares. Ohne lose Objekte passiert nichts. Scheitert es, kommt eine Warnung, und die ZIP wird trotzdem geschrieben. Verlauf am Motor 81 statt 35 MB (erstes Packen 8.9 s, danach 0.4 s), am Hotwire 5 statt 4 MB.
- **Grenzen:** Was ältere Projekte schon im Verlauf haben (Analyseergebnisse, Bilder), bleibt drin. Jeder Commit mit geändertem Modell legt weiter eine neue STEP-Fassung ab, gepackt nur kleiner. Getestet unter Windows.
+*Skill „Parametric models“ (E77, Wunsch des Nutzers; Prüfungen in `app/test/skills.mjs` und `unit.mjs`):*
+
+- **Anlass:** `param()` (E74) sagt, wie ein Wert ins Panel kommt, aber nicht, welche Werte gute Parameter sind. Agenten machen sonst Maße frei, die voneinander abhängen, wählen Bereiche, in denen das Modell bricht, oder Selektoren, die bei einer anderen Lochzahl die falsche Kante treffen.
+- **Inhalt (`app/resources/skills/parametrik.md`):** Konstruktionsabsicht vor dem ersten `param()` (was die Größe bestimmt, was beim Ändern stehen bleibt, Innen- oder Außenmaß), höchstens `{{max_params}}` unabhängige Parameter, Kommazahl oder ganze Zahl bewusst, Auswahl mit Tabelle, Bereiche, die nicht voneinander abhängen, unmögliche Kombinationen mit eigener Meldung, nie still verkleinern, alles Übrige abgeleitet und nicht mit der Größe skaliert, Formelemente an berechneten Stellen statt über Indizes, Prüfungen je Teil als `assert`, Felder im Panel (Bezeichnung, Einheit, Schritt, Gruppe, Hilfe), stabile Namen, Bereichsprüfung, spätere Änderungen. Ein Codebeispiel (Lagerplatte mit Lochreihe und Lagerwahl) zeigt Tabelle, abgeleiteten Wert und Kombinationsprüfung.
+- **Bereichsprüfung ohne neuen Befehl:** Projekt in einen Ordner außerhalb kopieren (ohne `.git`, `.soma`, `output`, `exports`, `renders`), dort je Fall `parameters.json` schreiben und `soma build --project <Kopie>`. Fälle: jede Zahl an `min` und `max`, jede Option, jeder Schalter umgelegt, alle Maße gemeinsam an `min` und an `max`. Jeder Parameter allein muss bauen, Kombinationen dürfen mit eigener Meldung abbrechen. Die `parameters.json` des Nutzers bleibt unberührt, die App sieht die Kopie nicht. Geprüft an der Vorlage und zwei Beispielmodellen, je Fall 3 bis 5 s.
+- **Grenzen:** 113 Zeilen, länger als die übrigen Skills der Arbeitsweise. Kein Agent-Test bisher. Ein Befehl `soma params check` würde die Kopie und die Fälle übernehmen. Getestet unter Windows.
+
*Technische Zeichnungen (E76, Wunsch des Nutzers; Prüfungen in `app/test/drawing.mjs`):*
- **Grundidee:** Der Agent zeichnet selbst, soma liefert Werkzeuge statt automatischer Ansichten und Maße. Eine Zeichnung ist eine Python-Datei `drawings/*.py` mit `soma.drawing.Sheet`, mehrere Blätter je Datei möglich. Wie bei den Animationen bekommt sie das eben gebaute Modell als Modul `model`.
@@ -572,7 +580,8 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- Ladeanzeigen: Die Explosion deckt den Viewer während der Analyse ab (Klicks kämen sonst vor dem Ergebnis an), Abbrechen beendet sie. Messen zeigt seine Vorbereitung (Messdienst starten, Stand laden) nur in der eigenen Karte und lässt schon Klicks zu, deren Messung wartet. Den Stand lädt der Messdienst schon beim Einschalten des Messmodus und nach jedem neuen Build, solange er an ist. Zeitlimit dafür 10 Minuten statt 30 s
- Explosionsansicht (E56, E57, E59): Start bei 50 % des Schiebers mit einer Lücke von 5 % der Modelldiagonale, bei 100 % dreifach, mindestens eine halbe Lücke je Teil. Das größte Teil bleibt stehen. Strahltest mit Punkten 1 ‰ der Diagonale (mindestens 0,1 mm) unter der Oberfläche, Berührung unter 0,4 % (mindestens 0,5 mm), etwa 600 Punkte je Teil. Gruppen aus `group=` zählen nicht mehr. Referenzen bleiben stehen und zählen nicht mit, ausgeblendete Teile zählen mit (sonst spränge die Explosion beim Ausblenden). Wege sind anfangs an und zeigen den eigenen Weg ab dem Elternteil. Messen und Explosion schließen sich aus, ebenso Animation und Explosion.
- Terminal: Strg+V fügt den Text der Zwischenablage selbst ein (bracketed paste), sonst kam bei OpenCode nichts an. Ohne Text (Bild) geht `^V` an das Programm weiter
-- Parameter (E74): Dateiname `parameters.json` im Projektordner (sichtbar im Dateibaum, im Editor nur lesbar, Umbenennen gesperrt, Löschen erlaubt und gleichbedeutend mit „Reset all“). Ohne Werte verschwindet die Datei, damit ein Modell wie die Vorlage bleibt. Ein Wert gleich dem im Code wird nicht gespeichert, folgt also späteren Änderungen des Agenten. Fehler im Aufruf von `param()` (Startwert außerhalb des Bereichs, Startwert nicht unter den `options`) brechen den Build ab, Werte des Nutzers außerhalb des Bereichs nicht. Der Agent soll `parameters.json` nur auf Wunsch ändern, und wenn er einen vom Nutzer gesetzten Wert neu festlegen soll, im Code ändern und den Eintrag entfernen. Abgeleitete Werte zum Ansehen (ƒx im Entwurf), Varianten (benannte Wertesätze) und eine Prüfung der Bereichsgrenzen (`soma params check`) fehlen noch
+- Parameter (E74): Dateiname `parameters.json` im Projektordner (sichtbar im Dateibaum, im Editor nur lesbar, Umbenennen gesperrt, Löschen erlaubt und gleichbedeutend mit „Reset all“). Ohne Werte verschwindet die Datei, damit ein Modell wie die Vorlage bleibt. Ein Wert gleich dem im Code wird nicht gespeichert, folgt also späteren Änderungen des Agenten. Fehler im Aufruf von `param()` (Startwert außerhalb des Bereichs, Startwert nicht unter den `options`) brechen den Build ab, Werte des Nutzers außerhalb des Bereichs nicht. Der Agent soll `parameters.json` nur auf Wunsch ändern, und wenn er einen vom Nutzer gesetzten Wert neu festlegen soll, im Code ändern und den Eintrag entfernen. Abgeleitete Werte zum Ansehen (ƒx im Entwurf), Varianten (benannte Wertesätze) und ein Befehl für die Prüfung der Bereichsgrenzen (`soma params check`) fehlen noch. Bis dahin beschreibt der Skill „Parametric models“ (E77) die Prüfung über eine Kopie des Projekts
+- Skill „Parametric models“ (E77): Kennung `parametrik`, Kategorie Arbeitsweise mit `order` 3, ab Werk „Immer“ (jedes Modell hat Parameter), Einstellungen Höchstzahl der Parameter (15, wie „meist 3 bis 15“ in `AGENTS.md`) und Bereichsprüfung (`full`, `main`, `off`). Die Konstruktionsabsicht steht als Kommentar über den Parametern, nicht in `NOTES.md`. Bereichsprüfung über eine Kopie des Projekts statt über einen neuen Befehl
- Technische Zeichnungen (E76): PDF und DXF nach `output/drawings/` (Lieferdateien, deshalb im Verlauf und in der ZIP), das Bild für den Agenten nach `.soma/drawings/` (wie die Animationen nicht in Verlauf und ZIP). Ein Bild mit 200 dpi, längste Seite höchstens 7000 px. Schrift DejaVu Sans statt einer ISO-Schrift, weil sie überall mit matplotlib vorhanden ist. Schriftfeld mit festem Aufbau 180 mm breit, Felder Firma, Benennung, Gezeichnet, Datum (Standard heute), Zeichnungsnummer, Index, Werkstoff, Allgemeintoleranzen, Maßstab, Format, Projektion, Blatt. A4 hoch, A3 bis A0 quer. Verdeckte Kanten standardmäßig in den sechs Hauptansichten, nicht in iso und Schnitten. Schraffur 2.5 mm, Nachbarteile 45/135°, ab dem dritten Teil weiter. Skill-Kennung `zeichnung`, Kategorie „Check and present“ mit `order` 33, ab Werk „Bei Bedarf“, Einstellungen Norm (ISO/ASME), Blattgröße (A3), Allgemeintoleranz (ISO 2768-m) und Sprache (en). PDF und DXF entfernter Blätter bleiben liegen und werden nur genannt.
- `npm test` läuft über `test/run-all.mjs` mit vier Suiten gleichzeitig und freien Ports (5,5 bis 7 statt 8,5 Minuten, die Animation bestimmt die Dauer und wird unter Last 2 bis 3 Mal langsamer), Watchdog dann 15 Minuten. `soma` lädt cadquery erst in Befehlen, die es brauchen (`soma --version` 0,7 statt 4,4 s)