Regeln, Standards, Kontextstruktur und Werkzeuge übernommen; 2nd-brain- Inhalte (Stacks, Ansible-Inventar, Architektur, Knowledge) entfernt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.