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>
This commit is contained in:
Kenearos 2026-04-12 19:21:27 +02:00
parent af6bcacd94
commit 7d4412782e
3 changed files with 115 additions and 3 deletions

View file

@ -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