Files

ai/common/ – Standards & Verabredungen

Wie wir Dinge tun. Verbindlicher Standard; Abweichungen nur begründet (im Ergebnis bzw. Stack-/Projekt-README). Verbesserungen sind erwünscht – Ablauf: agents.md § 5 „AI-Basis verbessern“. Jede Datei hat unten ein Änderungsprotokoll.

Datei Inhalt
agents.md Arbeitsweise der Agenten, Qualitätscheckliste, Basis verbessern, Rollen
bash.md Bash-Standard: .env + _functions.sh, Optionen, Logging (becho…), Trap, Präambel = Hilfe
ansible.md Ansible: Layout, .env.sh, Präambel, hostlist, Rollen, Facts, Secrets, Tags
docker.md Docker-Compose-Standard (GELF, Traefik, Bind-Mounts, .env, README-Pflicht)
coding.md Allgemeine Code-Regeln, Namen, Konfiguration, Python, Lint/Test
markdown.md Markdown-/Doku-Konventionen, READMEs, Projekt-context.md
architecture.md Architektur-Skizze (arc42-light), ADRs, Lösungsgrundsätze

templates/

Pfad Inhalt
templates/bash/ script_template.sh, _functions.sh (Referenz, Version in B_FUNCTIONS_VERSION), .env.example
templates/ansible/ .env.sh, ansible.cfg, inv/, playbooks/{example,mini_check}.yml, roles/example/, files/example/
templates/docker/ docker-compose.yml, .env.example, Stack-README.md
templates/markdown/ knowledge_entry.md, adr.md

Vorlagen werden kopiert, nicht verlinkt. bin/_functions.sh ist eine Kopie von templates/bash/_functions.sh – beide gleich halten.