# Portabilität: UNIVERSAL
# Version: 1.1.0
# Zuletzt validiert: 2026-02-08 (Claude)
# Nächste Prüfung: 2026-08-08
# Ressourcen: [tools/_policies/CONCEPT_naming_convention.md]

NAMENSKONVENTIONEN
==================

Stand: 2026-02-08

ZEITSTEMPEL-FORMATE
-------------------
  Session-ID:   YYYYMMDD_HHMM         (20260111_0315)
  Chat-ID:      msg_YYYYMMDD_HHMMSS   (msg_20260111_031504)
  Dokument:     DD.MM.YYYY            (11.01.2026)
  JSON-Felder:  ISO 8601              (2026-01-11T03:15:04)

DATEIEN
-------
  Bericht:      Bericht_YYYYMMDD_HHMM.md
  Forensik:     REPORT_YYYY-MM-DD_Thema.md
  Konzept:      KONZEPT_Name.md oder CONCEPT_Name.md
  Analyse:      ANALYSE_Name.md
  Recherche:    RECHERCHE_Name.md
  Schema:       *_schema.md
  Template:     TEMPLATE_Name.md

TOOL-PRAEFIXE (tools/*.py)
--------------------------
Praefixe kennzeichnen den Typ und Einsatzzweck eines Tools.

  PRAEFIX   BEDEUTUNG                BEISPIELE
  -------   ----------------------   ---------------------------
  c_        CLI-optimiert für AI    c_encoding_fixer.py
            (Claude/recludOS)        c_json_repair.py
            - Klare, parsbare Outputs
            - Encoding-sicher (UTF-8)

  m_        Maintain/Wartung         m_migrate_triggers.py
            - Aufräum-Tools         m_cleanup_logs.py
            - Migrations-Scripts

  b_        BACH-Kern (System)       backup_manager.py
            - Von bach.py genutzt    bach_auto_discovery.py
            - Kritische Funktionen

  check_    Validatoren              check_my_tasks.py
            - Einmalige Prüfungen

  fix_      Quick-Fixes              fix_injectors.py
            - Repariert spezifische Bugs

SKILL-SPEZIFISCHE TOOLS (NEU)
-----------------------------
Tools die nur für einen Skill relevant sind:

  Namenskonvention: <skill>_<funktion>.py

  Beispiele:
    steuer_scanner.py       # Steuer-Expert spezifisch
    steuer_sync.py          # Steuer-Expert spezifisch
    task_scanner.py         # ATI-Agent spezifisch (in agents/ati/scanner/)

  Speicherort:
    - Allgemein:  tools/c_ocr_engine.py
    - Spezifisch: agents/_experts/steuer/steuer_scanner.py
    - Agent-Tool: agents/ati/scanner/task_scanner.py

  REGEL: Im Zweifel doppelt halten!
  Skill-spezifische Tools MUESSEN beim Export inkludiert werden.

PYTHON-TOOL-HEADER (NEU - Pflicht)
----------------------------------
Jedes Tool braucht einen Standard-Header:

  """
  Tool: tool_name
  Version: X.Y.Z
  Author: [author]
  Created: YYYY-MM-DD
  Updated: YYYY-MM-DD
  Anthropic-Compatible: True

  VERSIONS-HINWEIS: Prüfe auf neuere Versionen

  Description:
      Was das Tool tut.
  """

  __version__ = "X.Y.Z"
  __author__ = "[author]"

Template: system/skills/_templates/TEMPLATE_TOOL.py

SKILL-ORDNER-NAMEN
------------------
  Format: lowercase-mit-bindestrich

  Beispiele:
    agents/entwickler/
    agents/persoenlicher-assistent/
    agents/_experts/steuer/
    agents/_experts/foerderplaner/

SKILL-DATEIEN
-------------
  SKILL.md        Hauptdefinition (Pflicht)
  config.json     Konfiguration (Optional)
  README.md       Nur für Navigation (Nicht für Konzepte!)

TASK-IDS & PROJEKTE
-------------------
  IDs:         Numerisch (1, 2, 712) - Automatisch vergeben.
  Labels/Pfx:  Für die Beschreibung genutzte Gruppen:
               SYS_    System-Kern
               WF_     Workflow-Entwicklung
               GUI_    Frontend-Themen
               FIN_    Finanz-Modul
               HEALTH_ Forensik & Wartung
               SKILL_  Skill-Architektur (NEU)
               LANG_   Internationalisierung

VERBOTEN
--------
  Dateinamen:  / \ : * ? " < > | Umlaute

SIEHE AUCH
----------
  bach --help tools            Tool-Verwaltung und Ausführung
  bach --help skills           Skill-System
  system/tools/_policies/      Policy-Validatoren
  system/skills/_templates/    Standard-Templates
