docs: Python-Scripts dokumentiert, DSA5-Glossar hinzugefügt

- merge-config.py und merge-help-csv.py: Docstrings mit Aufrufkontext,
  Zweck, Idempotenz-Verhalten und Beispielen
- GLOSSAR.md: DSA5-Abkürzungen, Eigenschaften, Abenteuer-Schmiede-
  und BMAD-Fachbegriffe

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

skills/as-setup/scripts/merge-config.py

@@ -1,5 +1,33 @@
 #!/usr/bin/env python3
-"""Merge Abenteuer-Schmiede config into BMAD _config/config.yaml."""
+"""Merge Abenteuer-Schmiede config into BMAD _config/config.yaml.
+
+Called by: BMAD module installer (npx bmad-method install)
+When:      During module installation, NOT during as-setup workflow
+Purpose:   Adds default Abenteuer-Schmiede config variables to the
+           central BMAD config so agents can read project settings.
+Idempotent: Yes — skips if 'abenteuer-schmiede:' block already exists.
+
+Usage:
+    python merge-config.py <bmad-root-path>
+
+Example:
+    python merge-config.py /path/to/my-project
+
+This appends the following YAML block to _config/config.yaml:
+
+    abenteuer-schmiede:
+      abenteuer_name: ""
+      setting: ""
+      epoche: ""
+      spieleranzahl: "3-4"
+      erfahrungsstufe: "Durchschnittlich (300-600 AP)"
+      abenteuer_typ: "Gemischt"
+      geschaetzte_dauer: "Mittel (4-6 Abende)"
+      sprache: "Deutsch"
+
+These values are populated by the as-setup workflow (skills/as-setup/SKILL.md)
+when the user starts a new adventure project.
+"""
 
 import sys
 import os

skills/as-setup/scripts/merge-help-csv.py

@@ -1,5 +1,25 @@
 #!/usr/bin/env python3
-"""Merge Abenteuer-Schmiede module-help.csv into BMAD help.csv."""
+"""Merge Abenteuer-Schmiede module-help.csv into BMAD help.csv.
+
+Called by: BMAD module installer (npx bmad-method install)
+When:      During module installation, NOT during as-setup workflow
+Purpose:   Registers all Abenteuer-Schmiede skills/workflows in the
+           central BMAD help system so they appear in agent menus
+           and the BMAD help command.
+Idempotent: Yes — only adds entries whose canonicalId doesn't exist yet.
+
+Usage:
+    python merge-help-csv.py <bmad-root-path>
+
+Example:
+    python merge-help-csv.py /path/to/my-project
+
+Source file: skills/as-setup/assets/module-help.csv (10 entries)
+Target file: <bmad-root>/_config/help.csv
+
+CSV columns: canonicalId, moduleName, moduleCode, skillType, skillId,
+             skillName, description, filePath
+"""
 
 import csv
 import sys
@@ -30,7 +50,7 @@ def merge_help(bmad_root):
                 existing_ids.add(row[0])
                 existing_rows.append(row)
 
-    # Merge: only add rows that don't exist yet
+    # Merge: only add rows whose canonicalId doesn't exist yet
     added = 0
     for row in new_rows:
         if row[0] not in existing_ids: