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

Plan: Stufen der Skills (E55), README nachgezogen

Kai-Jungsthoefel8cb7803079a5
diff --git a/PLAN.md b/PLAN.md
index 0ddb497..d1dd33b 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -67,8 +67,8 @@ Eine Desktop-App, in der ein Nutzer zusammen mit einem KI-Coding-Agenten seiner
│ └── model.step Hauptergebnis mit allen Bauteilen, benannt, farbig
├── exports/ Einzelexporte (Ort noch nicht festgelegt)
├── .soma/
-│ ├── project.json ID, App-/Framework-Version, api_version, aktive Skills, Hauptdatei
-│ ├── skills/ aktivierte Skills als Markdown
+│ ├── project.json ID, App-/Framework-Version, api_version, Stufen der Skills, Hauptdatei
+│ ├── skills/ eingeschaltete Skills (Bei Bedarf, Immer) als Markdown
│ ├── feedback/ Screenshots und Skizzen (nicht in Git)
│ ├── model.map.json und GLB-Cache (nicht in Git)
└── .git/ .gitignore
@@ -106,7 +106,7 @@ Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt
- **Terminal (E19):** Freies Terminal mit mehreren Tabs im Projektordner. Startbuttons für erkannte Agenten. Der zuletzt benutzte Agent startet beim Öffnen automatisch, **ohne Resume**. Der Nutzer installiert den Agenten selbst, die App hilft mit Erkennung und Hinweisen (E4).
- **`AGENTS.md` (E18):** Ganz app-verwaltet, Notizen stehen getrennt in `NOTES.md`. Beim Öffnen eines Projekts mit älterer Regelversion wird sie erneuert, dem Nutzer angezeigt und als Commit gesichert (E36). Der Verweis auf die Notizen steht ganz oben.
-- **Skills (E17):** Markdown-Regeln (z. B. 3D-Druck, Toleranzen, CNC-Fräsen), pro Projekt aktivierbar. Aktivierte Skills liegen in `.soma/skills/` und stehen mit vollem Pfad in `AGENTS.md`. Zunächst nur mitgelieferte, eigene Nutzer-Skills später.
+- **Skills (E17, E55):** Markdown-Regeln (z. B. 3D-Druck, Toleranzen, CNC-Fräsen), je Modell in drei Stufen: Aus, Bei Bedarf (der Agent liest sie, wenn das Thema aufkommt) und Immer. Eingeschaltete Skills liegen in `.soma/skills/` und stehen mit vollem Pfad in `AGENTS.md`, „Bei Bedarf“ mit Anlass. Zunächst nur mitgelieferte, eigene Nutzer-Skills später.
- **Rückmeldung an den Agenten (E11):** Markierungen (Viewer-Bild oder leere Fläche mit Zeichnung) landen als PNG in `.soma/feedback/`, Auswahlen (Bauteilname, Datei, Zeilen, Fläche) und Build-Fehler gehen als Text. Die App fügt Pfad oder Text in die Eingabezeile des Terminals ein, der Nutzer schickt selbst ab. Später kommt ein MCP-Server der App dazu.
## 7. Oberfläche und Viewer
@@ -267,16 +267,16 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben
- **Technik:** eine Schnittebene von three.js für alle betroffenen Materialien, die Füllung über den Schablonenpuffer (Rückseiten zählen hoch, Vorderseiten herunter, wo etwas übrig bleibt, zeichnet eine Platte in der Ebene), die Kontur aus den Dreiecken des Netzes.
- **Nebenbei behoben:** Ein nur lesbarer Reiter im Editor, dessen Datei gelöscht wurde, galt als Konflikt und blockierte das Speichern des Modells. Er schließt sich jetzt. Ein Konflikt erledigt sich auch, wenn die Datei wieder so ist wie zuletzt gelesen.
-*Skills (E17, E46; 41 Prüfungen in `app/test/skills.mjs`, 10 Einheitentests):*
+*Skills (E17, E46, E55; 47 Prüfungen in `app/test/skills.mjs`, 14 Einheitentests):*
-- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Schalter, Kurzbeschreibung und aufklappbar den Themen. Mitgeliefert sind 12 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten). Der Inhalt ist für den Agenten auf Englisch, Titel, Beschreibung und Themen für die Oberfläche auf Deutsch (im Kopf der Datei). Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.
-- **Einschalten** kopiert den Skill nach `.soma/skills/<id>.md`, trägt ihn in `project.json` (und die App-Kopie, E27) ein und listet ihn in einem eigenen Abschnitt am Ende der `AGENTS.md` (zwischen `<!-- soma:skills -->` und `<!-- /soma:skills -->`, bei älteren Projekten ohne diesen Abschnitt wird er angehängt). Die Vorlage hat den Abschnitt schon, leer. **Ausschalten** entfernt Kopie und Eintrag. Beides zählt als ungespeicherte Änderung und wandert mit Snapshot, Git und ZIP.
-- **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 aktiven 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 Schalten 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.
+- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 12 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten). Der Inhalt ist für den Agenten auf Englisch, Titel, Beschreibung und Themen für die Oberfläche auf Deutsch (im Kopf der Datei). 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. 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, Wunsch des Nutzers):** `default: on` im Kopf schaltet einen Skill bei neuen Modellen ein, mitgeliefert für Konstruktionsablauf, Sauber modellieren und Normteile (E48, Wunsch des Nutzers). Im aufgeklappten Skill stellt der Schalter „Bei neuen Modellen einschalten“ das für die ganze App um. Gespeichert wird nur, was vom Kopf abweicht, in `state.json` der App-Daten (`skill_defaults`). 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. Die Karte sagt „Bei neuen Modellen an“. 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 aktiven Skills, nennt das die Karte und der Projekt-Check, angelegt wird nichts. Fehlt `AGENTS.md`, geht der Skill trotzdem an, mit Warnung, die Datei wird nicht neu erzeugt. Nennt `AGENTS.md` einen aktiven Skill nicht (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.
+- **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.
+- **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). 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“.
@@ -289,7 +289,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben
| CNC-Fräsen und Drehen | Innenradien, Taschentiefe, Aufspannungen, Bohrungen und Gewinde, Drehteile, Angaben für die Werkstatt | Material, kleinster Fräser, Achsen |
| Laserschneiden | Schnittbreite bei Schlitzen und Zinken, Stege, Platten flach bauen, DXF über einen Schalter `FLAT` | Material, Plattenstärke, Schnittbreite |
| Blech | Biegungen als Rundungen innen R und außen R + T, Schenkel, Abstände, Freistiche, Abwicklungslänge | Material, Dicke, Innenradius, K-Faktor |
-| Toleranzen und Passungen | gekürzt: Der Laser-Teil und seine Einstellung wanderten zum Laserschneiden, die Kopfdurchmesser zu den Normteilen. Ein aktiver Verfahrens-Skill geht vor | Fertigung, Durchgangslöcher, Mindestabstand |
+| Toleranzen und Passungen | gekürzt: Der Laser-Teil und seine Einstellung wanderten zum Laserschneiden, die Kopfdurchmesser zu den Normteilen. Der Skill des Verfahrens geht vor | Fertigung, Durchgangslöcher, Mindestabstand |
| Verbindungen | Schrauben (Einschraubtiefe, Randabstand, Werkzeug, Längen), Schnapphaken, Scharniere, Stifte, Magnete, Kleben | Bevorzugte Schraube |
| Normteile | Schrauben, Muttern, Scheiben und Einsätze über `soma.fasteners` (E48), Mutternfallen mit `trap()`, Maße von Kugellagern, Stiften, Profilen | keine |
| Festigkeit und Steifigkeit | Gestaltungsregeln, Biegebalken als Überschlag, Werkstoffwerte, Gewicht | Sicherheitsfaktor |
@@ -360,13 +360,16 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- Schnitt: eine Ebene (kein Mehrfachschnitt, kein Schnitt nur durch ausgewählte Teile), Karte unten rechts. Anfangs mitten durchs Modell, weggeschnitten die Seite der Standardansicht. Bei „Fläche“ nur ebene Flächen, anfangs mitten durch deren Bauteil. Die Schnittfläche selbst ist nicht messbar, Messen geht über die Kontur. Der Schnitt wird nicht gespeichert
- Schnitt, Darstellung: Füllung in der abgedunkelten Bauteilfarbe mit Schraffur im Bildraum (Abstand und Breite fest in Pixeln), keine Füllung bei transparenten Teilen und Referenzen
- Skills (E17): Ablage in `.soma/skills/` wie in Abschnitt 4 (E17 nennt `skills/`). Inhalt englisch, Oberfläche deutsch. Die mitgelieferten Skills sind Entwürfe, ihre Werte (Wandstärken, Bohrungen, Senkungen, Einschmelzmuttern, Einschraubtiefen, Dehnungen, Werkstoffwerte) sind übliche Richtwerte, keine Normauszüge. Die Maße der Normteile folgen den genannten Normen (Nennmaße)
-- Skill-Inhalte (E45): Namen und Kennungen der neuen Skills, die Namen der Kategorien (E46), Skills ohne Einstellungen (Sauber modellieren, Normteile). Querverweise nur allgemein („ein aktiver Verfahrens-Skill“), weil jede Kombination möglich ist
+- Skill-Inhalte (E45): Namen und Kennungen der neuen Skills, die Namen der Kategorien (E46), Skills ohne Einstellungen (Sauber modellieren, Normteile). Querverweise nur allgemein („der Skill für das Verfahren“), weil jede Kombination möglich ist
- Skills, Laser und Blech: `soma export --format dxf` schneidet das Teil in halber Höhe parallel zu XY. Stehende Platten und Abwicklungen bekommen deshalb einen Schalter `FLAT` in `model.py`, der sie flach auf XY registriert. Ein Export, der die Platte selbst flach legt, wäre bequemer (offen)
- Skills, Toleranzen: Die Einstellung „Spiel für Laserteile“ ist entfallen (jetzt „Schnittbreite“ im Laser-Skill). In `project.json` gespeicherte alte Werte werden still übergangen, wie jede unbekannte Einstellung
-- Skills für neue Modelle (E46): ab Werk an sind die beiden Skills der Arbeitsweise und die Normteile (E48). Die Vorgabe gilt für die ganze App (nicht je Nutzerprofil oder Projektvorlage), nur für „Neu“ und den ersten Start, nicht für geöffnete ZIPs. Einstellungswerte gehören nicht dazu, neue Modelle starten mit den Standardwerten. Der Schalter steht im aufgeklappten Skill, eine Übersicht aller Vorgaben gibt es nicht
+- Skills für neue Modelle (E46, E55): ab Werk „Immer“ sind die beiden Skills der Arbeitsweise und die Normteile (E48), alle übrigen „Bei Bedarf“. Die Vorgabe gilt für die ganze App (nicht je Nutzerprofil oder Projektvorlage), nur für „Neu“ und den ersten Start, nicht für geöffnete ZIPs. Einstellungswerte gehören nicht dazu, neue Modelle starten mit den Standardwerten. Die Auswahl steht im aufgeklappten Skill, eine Übersicht aller Vorgaben gibt es nicht
+- Skill-Stufen (E55): `project.json` führt beide Listen ausdrücklich (`skills` für Immer, `skills_on_demand` für Bei Bedarf), was fehlt, ist aus. Ein Skill, den erst eine neuere App mitbringt, steht in bestehenden Modellen deshalb auf „Aus“, bis der Nutzer ihn umstellt (nichts ändert ein Modell still beim Öffnen). Alte Modelle bekommen keine Umstellung
+- Skill-Stufen: Der Anlass für `AGENTS.md` steht als englischer Nebensatz im neuen Kopffeld `when`. Die Liste „Bei Bedarf“ steht in Panel-Reihenfolge, „Immer“ in der Reihenfolge des Umstellens. Einstellungen lassen sich auch bei „Bei Bedarf“ ändern, der Hinweis in der Kopie nennt sie dann als vom Nutzer gesetzt. Die Sätze „The user set these values in the app“ in den Skills heißen jetzt neutral „Settings from the app“, weil die Werte bei Bedarf meist Standard sind
+- Skill-Stufen, Oberfläche: Umschalter mit drei Feldern unter der Kurzbeschreibung (orange die gewählte Stufe), Karte bei „Immer“ orange getönt, bei „Aus“ blasser Text. Die Vorgabe für neue Modelle als Auswahlliste
- Skills, 3D-Druck: Die Überhangsuche im Skill prüft nur ebene Flächen. Gekrümmte Flächen (waagerechte Bohrungen, Rundungen unten) prüft der Agent im Viewer
- Skills: Die Kopie im Projekt bleibt beim Update der App, wie sie ist (gilt für das Modell, wandert mit). Aus- und Einschalten übernimmt die neue Fassung, die alte kommt in die Sicherung. Einen eigenen Knopf „Aktualisieren“ gibt es nicht
-- Skills: Nach dem Schalten fügt die App nichts von selbst in die Eingabe des Agenten ein, nur auf „An Agent geben“
+- Skills: Nach dem Umstellen fügt die App nichts von selbst in die Eingabe des Agenten ein, nur auf „An Agent geben“
- Skill-Einstellungen: nur Zahlen mit Bereich und Auswahllisten, kein freier Text. Einstellbar nur mitgelieferte Skills (nur sie haben den Text mit Platzhaltern). Die Werte gelten je Modell, es gibt keine App-weiten Vorgaben (etwa „mein Drucker“). Welche Werte es gibt und ihre Bereiche sind Entwürfe
- Normteile (E48): Schnittstelle auf Englisch (`Screw`, `Nut`, `Washer`, `HeatSetInsert`) wie der Rest von `soma`, Fehlermeldungen deutsch. Lage über Auflagepunkt und Richtung ins Material. Senkung = Kopf plus Spiel des gewählten Durchgangslochs, Tiefe genau die Kopfhöhe (nicht DIN 974, der Skill „Toleranzen“ nennt für Zylinderköpfe etwas größere Senkungen, mit `recess=` einstellbar). Kernloch aus der Spalte „Soft“ (Regelwerte). Einsätze: Standard ruthex, Bohrung 1 mm tiefer als der Einsatz. Farben Stahlgrau und Messing
- Normteile: Alte DIN-Namen (DIN 912, DIN 933 …) sind ein Fehler mit Hinweis auf die ISO-Norm, weil manche Maße abweichen. Nur Regelgewinde. Muttern haben eine Bohrung im Nenndurchmesser (sie berühren den Schaft, überschneiden ihn nicht). Ein Einsatz ist dicker als seine Bohrung, Kollisionsprüfungen mit seinem Teil lässt der Agent aus (steht im Skill „Normteile“)
@@ -395,7 +398,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- **Format** von `model.map.json` (Entwurf `version 0` aus Phase 0 steht) und der Ausgabe von `soma check`
- **Toleranz des Meshers:** Feste 0,05 mm passt für kleine Teile, große brauchen eine an der Größe orientierte Toleranz (siehe Leistungsmessung)
- **Auswahlen des Agenten:** Flächen-IDs gelten nur pro Build, Verweise brauchen Bauteilname plus Geometrieangabe
-- **Inhalte** von `AGENTS.md` und den Skills, mit einem echten Agenten zu testen
+- **Inhalte** von `AGENTS.md` und den Skills, mit einem echten Agenten zu testen. Vor allem (E55): Liest ein Agent einen Skill „Bei Bedarf“ von selbst, wenn das Gespräch das Thema wechselt (etwa „jetzt für den 3D-Druck“), und hält er das in `NOTES.md` fest? Mit Claude Code und einem kleineren Modell prüfen
- **Projekt-Check:** Umfang und Spezifikation, Abdeckung aller Störfälle
## 12. Größte Risiken
diff --git a/app/README.md b/app/README.md
index 97fb5b4..631090e 100644
--- a/app/README.md
+++ b/app/README.md
@@ -15,14 +15,14 @@ Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal.
npm install
npm start # baut und startet
npm run typecheck
-npm run test:unit # Bausteine ohne Electron: Dateien und Ordner nach inputs/, Anlegen, Umbenennen und Papierkorb im Dateibaum, Markierung nach .soma/feedback/, Pfadschutz, Schreiben aus dem Editor mit Konfliktprüfung, App-Icon, Einstellungen, Kategorien und Standard der Skills (42 Prüfungen)
+npm run test:unit # Bausteine ohne Electron: Dateien und Ordner nach inputs/, Anlegen, Umbenennen und Papierkorb im Dateibaum, Markierung nach .soma/feedback/, Pfadschutz, Schreiben aus dem Editor mit Konfliktprüfung, App-Icon, Einstellungen, Kategorien, Stufen und Standard der Skills, Abschnitt in AGENTS.md (46 Prüfungen)
npm run test:smoke # echte App, unsichtbar: Projekt, Viewer, Auswahl, Panels, Terminal, Übergabe an den Agenten, Markierung (Zeichnen, Linie, Raster, Auswählen, Verschieben, Drehen, Skalieren, Farben, Bild aus dem Dateibaum), Dateibaum (Markierungen, Menü, Anlegen, Umbenennen, Papierkorb), Auto-Build, Fehlerfall, Export, Ansichtswürfel und Drehpunkt (79 Prüfungen)
npm run test:versions # Git-Verlauf, Speichern, Öffnen, Vorschau (auch markiert), Wiederherstellen, Störfälle (53 Prüfungen)
npm run test:editor # Editor: Höhe und Scrollen, Speichern nur auf Wunsch mit genau einem Build (nur bei Python und inputs/), Änderungen des Agenten, Konflikte mit Sicherung, Nur lesen, CRLF, Rückfragen bei Modellwechsel und Reiter schließen, Markdown als Dokument (37 Prüfungen)
npm run test:measure # Messen: Fläche, Kante, Punkt, Abstand paralleler Ebenen, zweier Bohrungen, zweier Punkte, Punkt zur Ebene, Verdecktes, neuer Build, Vorschau (21 Prüfungen)
npm run test:groups # Gruppen: eigene und importierte (STEP-Baugruppe), Baum, Aus-/Einblenden und Transparenz je Gruppe, Klick durch transparente Teile, Ausgabe-STEP (17 Prüfungen)
npm run test:section # Schnitt: X/Y/Z und an Fläche, Eingabe der Lage, Seite wechseln, gefüllte und schraffierte Schnittfläche, Klicks durch den Schnitt, Wandstärke an der Kontur messen, neuer Build (26 Prüfungen)
-npm run test:skills # Skills: Panel, Ein-/Ausschalten (Kopie, project.json, AGENTS.md), Einstellungen (Werte in der Kopie, Prüfung, Standard, vorab bei ausgeschaltetem Skill), Ansehen, An Agent geben, Sicherung geänderter Kopien, fehlende Dateien nur gemeldet, Snapshot und ZIP, Kategorien, Skills für neue Modelle (41 Prüfungen)
+npm run test:skills # Skills: Panel, Stufen Aus/Bei Bedarf/Immer (Kopie mit oder ohne Hinweis, project.json, zwei Listen in AGENTS.md), Einstellungen (Werte in der Kopie, Prüfung, Standard, vorab bei ausgeschaltetem Skill), Ansehen, An Agent geben, Sicherung geänderter Kopien, fehlende Dateien und falsche Listen nur gemeldet, Snapshot und ZIP, Kategorien, Stufen für neue Modelle (47 Prüfungen)
npm run test:fasteners # Normteile: Maße aus den Tabellen, Lage (at, direction, on, sunk), Bohrungen und Mutternfallen ohne Überschneidung, Einsätze, Fehlermeldungen, Rolle hardware, Codeblock des Skills „Normteile“, in der App Baum, Auswahl und export --all (35 Prüfungen)
npm test # alle neun
```
@@ -35,12 +35,12 @@ npm test # alle neun
| Pfad | Inhalt |
|---|---|
-| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Skills ein- und ausschalten: Kopie nach `.soma/skills/`, Abschnitt in `AGENTS.md`, Sicherung abweichender Kopien), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, `soma` und `git` im PATH), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `agents.ts` |
+| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, `soma` und `git` im PATH), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `agents.ts` |
| `src/preload/` | Schmale, feste Schnittstelle zum Renderer (kein Node-Zugriff dort) |
| `src/renderer/` | Oberfläche: `main.ts` (Verdrahtung: Kopfzeile, Menüs, Auswahl, Übergabe an den Agenten, Startseite), `viewer.ts` (three.js, Klick auf Code, Ansichten, Drehpunkt, Schnittebene mit gefüllter Schnittfläche und Kontur, Vorschaubild, Bild für die Markierung), `viewcube.ts` (Ansichtswürfel in 3D), `sectiontool.ts` (Schnitt: Karte, Ebene, Text für den Agenten), `skills.ts` (Panel „Skills“), `markup.ts` (Zeichenfläche der Markierung, Formen als bearbeitbare Objekte), `measuretool.ts` (Messen: Ablauf, Karte, Text für den Agenten), `parts.ts` (Bauteilkarte als Baum mit Gruppen, Auge und Transparenz), `code.ts` (Code-Panel mit Editor: CodeMirror 6, Speichern auf Wunsch, Abgleich mit Änderungen des Agenten, Konflikte, Umschalter für Markdown), `markdown.ts` (Markdown als Dokument: Tokens von `marked` direkt als DOM, ohne `innerHTML`), `filetree.ts` (Dateien-Panel), `versions.ts` (Verlaufsleiste), `terminals.ts` (xterm.js, Tabs, Einklappen, Einfügen), `ui.ts` (Menüs, Meldungen, Helfer), `icons.ts` (Symbole), `style.css` (Farben mit fester Bedeutung, siehe Kopf der Datei) |
| `src/shared/` | `types.ts` Typen des IPC-Vertrags, `editable.ts` welche Dateien der Editor nur zeigt (gilt in Renderer und Hauptprozess) |
| `resources/template/` | Vorlage für neue Projekte: `model.py`, `AGENTS.md`, `CLAUDE.md`, `NOTES.md`, `.gitignore` |
-| `resources/skills/` | Mitgelieferte Skills (E17), je eine Markdown-Datei: Kopf mit `title`, `summary`, `topics`, `category` (deutsch, Oberfläche), `name` (englisch, für `AGENTS.md`), `order`, `default: on` (bei neuen Modellen an) und optional Einstellungen als `var name: Standard \| Einheit \| Bezeichnung \| 10..85` oder `\| a, b=Anzeige`, darunter die Regeln für den Agenten auf Englisch mit Platzhaltern `{{name}}` |
+| `resources/skills/` | Mitgelieferte Skills (E17), je eine Markdown-Datei: Kopf mit `title`, `summary`, `topics`, `category` (deutsch, Oberfläche), `name` und `when` (englisch, für `AGENTS.md`: Name und Anlass), `order`, `default:` (Stufe bei neuen Modellen: `always`, `on-demand` oder `off`) und optional Einstellungen als `var name: Standard \| Einheit \| Bezeichnung \| 10..85` oder `\| a, b=Anzeige`, darunter die Regeln für den Agenten auf Englisch mit Platzhaltern `{{name}}` |
| `resources/icon.*` | App-Icon (E44) für Fenster und Taskleiste: `icon.svg` als Vorlage, `icon.ico` (16 bis 256 px) und `icon.png`. Neu erzeugen mit `python scripts/make-icon.py` (braucht Edge und Pillow, kleine Größen bekommen einen dickeren Strich) |
| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`) |
| `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `skills.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |