--- type: types/entity.md entity_type: system tags: [schema, configuration, wiki, operating-system] created: 2026-08-03 modified: 2026-08-31 related: [wikitool, Naming Convention Conflict, CLAUDE.md, Denylist over Allowlist, ENVIRONMENT.md] sources: [Source - LLM Improvements Codex Analysis, Source - LLM Improvements Sonnet Analysis, Source - LLM Wiki v2, Source - Copilot Skill Restructure Instructions, Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04, Source - LLM Improvements Production Agent Gaps 2026, Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31, Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31, Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31] confidence: 0.90 confidence_base: 0.90 provenance: sourced summary: 'Kontrollebene des LLM-Wikis: Invarianten, Dateibenennung, Routing, Gates, seit 1.1.0 Personalization und seit 1.8.0 der Environment-Abschnitt; erreicht Claude Code nur ueber den Import in CLAUDE.md' --- # AGENTS.md **Typ:** system ## Beschreibung AGENTS.md ist das Schema und Betriebssystem für die LLM Wiki. Es definiert die vollständige Methodik, wie die LLM die Wiki pflegt, Quellen verarbeitet, Anfragen beantwortet, Linting durchführt, Seiten erstellt und Konsistenz über alle Operationen hinweg aufrechterhält. Das Dokument etabliert den Grundsatz „Niemals ableiten. Immer kompilieren." und erzwingt eine strenge Trennung zwischen mechanischen Operationen (von wikitool gehandhabt) und semantischen Operationen (von der LLM gehandhabt). Die Codex-Analyse identifizierte AGENTS.md als Bereitstellung einer deterministisch erzwungenen Grundlage, die vielen öffentlichen LLM-Wiki-Skills voraus ist. Sie kodifiziert Workflows (INGEST, QUERY, LINT, CREATE, UPDATE), Qualitätsstandards, Namenskonventionen, Seitenformate, Cross-Reference-Regeln und die drei-schichtige Architektur (Rohquellen, von LLM verwaltete Wiki, Schema). ## Kerndaten - **Zweck:** Kontrollebene für die Wiki: Invarianten, Dateibenennnung, Routing, Gates - **Status:** Aktiv, unter aktiver Entwicklung - **Version:** Umstrukturiert 2026-08-22 - siehe `CHANGES.md` - **Sprache/Technik:** Markdown, YAML-Frontmatter - **Standort:** Repo-Wurzel: `/AGENTS.md` ## Beziehungen - **Implementiert von:** [[wikitool]] - **Definiert:** [[LLM Wiki Pattern]], [[Three-Layer Architecture]], [[Workflow Orchestration]] - **Verwendet von:** Alle LLM-Operationen in dieser Wiki - **hat:** [[Naming Convention Conflict]] - **Analysiert in:** [[Source - LLM Improvements Codex Analysis]], [[Source - LLM Improvements Sonnet Analysis]] - **verwandt mit:** [[CLAUDE.md]] - **begründet:** [[Denylist over Allowlist]] - **beschreibt:** [[ENVIRONMENT.md]] ## Hauptabschnitte AGENTS.md enthält diese Hauptabschnitte: - **Übersicht:** Grundsätze und Architektur - **Werkzeuge:** wikitool-CLI-Befehlsreferenz - **Provenienz und Zitation:** raw_files, Provenienz-Marker, Inline-Zitationen - **Entity-Typen:** Projects, Systems, Tools, Technologies, People - **Concept-Typen:** Architecture, Pattern, Protocol, Workflow, Decision, Problem - **Relationship-Typen:** depends on, uses, implements, extends, replaces, etc. - **Workflows:** ~~INGEST, QUERY, LINT, CREATE, UPDATE mit detaillierten Schritten~~ **abgelöst** - die 5 Workflow-Schritt-Listen wurden wörtlich in diskrete Skills unter `.agents/skills/` extrahiert (`wiki-ingest`, `wiki-query`, `wiki-lint`, `wiki-manage` (CREATE+UPDATE zusammengeführt), `wiki-status` (neu, schreibgeschützt)); die Root-Datei enthält jetzt nur eine Zeiger-Tabelle[^s-conversation-agents-md-skill-restructuring-session-2026-08-04]. - **Skills:** Neuer Top-Level-Abschnitt, der die 5 Skills auflistet und auf `.agents/skills/` verweist, gespiegelt zu `.claude/skills/` über `tools/wikitool skills sync`/`verify` für Claude-Code- Kompatibilität[^s-conversation-agents-md-skill-restructuring-session-2026-08-04]. - **Git-Automation:** Auto-Publish über wikitool - jetzt nur Policy in der Root-Datei; der Output-Abschnitt jeder Skill gibt an, ob dieser Workflow auto-published[^s-conversation-agents-md-skill-restructuring-session-2026-08-04]. - **Seitenformate:** Templates für Entities, Concepts, Sources, Comparisons - **Qualitätsstandards:** Inhalts- und Cross-Reference-Qualitätskriterien - **IT-spezifische Richtlinien:** Domänen-spezifische Regeln für Projects, Systems, Tools, etc. - **Konfidenz-Bewertung:** Quantitative Bewertung für sachliche Aussagen - **Personalization:** Seit `1.1.0` ein eigener Abschnitt. Er hält fest, dass `USER.md` und `SOUL.md` bei Sitzungsstart gelesen werden, dass `USER.md` Kontext und keine Instruktionsquelle ist, dass `SOUL.md` gegen diese Datei verliert und dass eine Nutzeraussage keine Quelle im Sinne von Invariante 3 ist. Die Mechanik dahinter: [[Personalization Plane]]. - **Environment:** Seit `1.8.0` ein eigener Abschnitt neben „Personalization". Er hält fest, dass [[ENVIRONMENT.md]] bei Sitzungsstart gelesen wird, *falls sie existiert*, dass ihr Fehlen kein Fehler ist, und dass sie Kontext ohne Autorität trägt - ein dort gelisteter Remote autorisiert keinen Push an Invariante 5 vorbei[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]. Der Abschnitt ist nötig, weil die übrigen Harnesses [[CLAUDE.md]] nie lesen und die Datei sie sonst nie erreichte. Die Mechanik dahinter: [[Optional Instance Context File]]. ## Namenskonventions-Anmerkung **Konflikt identifiziert:** Es gibt einen bekannten Unterschied zwischen AGENTS.md (das menschenlesbare Dateinamen mit Leerzeichen erfordert, z. B. `Hybrid Search.md`) und README.md (das Kebab-Case erfordert, z. B. `hybrid-search.md`). Dies verursacht Validierungsinkonsistenzen, die gelöst werden sollten. Siehe [[Naming Convention Conflict]]. ## Historie - 2026-08-31 - Abschnitt „Environment" und eine vierte Zeile in der File-naming-Tabelle (`ENVIRONMENT.md`, die einzige optionale Zeile darin), mit Stack-Version `1.8.0`[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31] - 2026-08-31 - Die Obergrenze des Iteration Budget Gate im Abschnitt „Gates" von 30 auf 60 gezogen, gemeinsam mit `instructions/gates.md`, `tools/CONTRACT.md`, `README.md`, der `work plan`-Vorlage und der Einheitengröße in `migrate-corpus.md`. Der Loop-Breaker blieb bei 3[^s-conversation-comma-bug-budget-refund-and-lint-report-path-session-2026-08-31] - 2026-08-30 - Abschnitt „Personalization" und drei neue Zeilen in der File-naming-Tabelle (`CLAUDE.md`, `USER.md`, `SOUL.md`). Im selben Zug stellte sich heraus, dass diese Datei [[Claude Code]] nie erreicht hatte, weil dieses Harness ausschließlich [[CLAUDE.md]] lädt - 2026-08-04 - Umstrukturiert: Die 5 Workflow-Abschnitte wurden in `.agents/skills/`-Skills extrahiert (`wiki-ingest`, `wiki-query`, `wiki-lint`, `wiki-manage`, `wiki-status`), Datei von 745 auf ~573 Zeilen reduziert, neue „## Skills"-Sektion und Git-Automation-Policy-only-Umschreiben[^s-conversation-agents-md-skill-restructuring-session-2026-08-04]. - 2026-08-03 - Seite während der Aufnahme der Codex-Analyse erstellt - 2026-08-02 - Namenskonventionen auf menschenlesbare Titel mit Leerzeichen aktualisiert - 2026-07-26 - Mit Git-Automation- und Tooling-Abschnitten aktualisiert - 2026-07-25 - Initiales IT-fokussiertes Schema erstellt ## Analyseergebnisse Die Sonnet-Analyse kam zu dem Ergebnis, dass AGENTS.md in drei Schlüsselbereichen konzeptionell bereits vor den meisten öffentlichen LLM-Wiki-Implementierungen ist: - **Provenienz und Zitation:** Die raw_files:, provenance:, [^s-llm-wiki-v2]-Marker und provenance.md-Rückwärtsindex bieten ungewöhnlich reife Coverage[^s-llm-improvements-sonnet-analysis] - **Deterministisches CLI:** wikitool handhabt mechanische Operationen präzise, anstatt an Ad-hoc-LLM-Scripts zu delegieren[^s-llm-improvements-sonnet-analysis] - **Konfidenz-Bewertung:** Die Verfallsformel und das Bewertungssystem existieren und funktionieren effektiv[^s-llm-improvements-sonnet-analysis] Die Sonnet-Analyse identifizierte jedoch Lücken, wo AGENTS.md verbessert werden könnte: - Einen Abschnitt „Content Quality & Style" mit Seitenlängen-Schwellwerten und Style-Guide-Regeln hinzufügen[^s-llm-improvements-sonnet-analysis] - Session-Orientierung als obligatorischen ersten Schritt für alle Workflows einbauen[^s-llm-improvements-sonnet-analysis] ## Siehe auch - [[wikitool]] - [[LLM Wiki Pattern]] - [[Three-Layer Architecture]] - [[Naming Convention Conflict]] - [[Content Quality Control]] - [[Session Orientation]] - [[Cross-platform Agent Skills]] - [[Source - LLM Improvements Codex Analysis]][^s-llm-improvements-codex-analysis] - [[Source - LLM Improvements Sonnet Analysis]] - [[Source - LLM Wiki v2]] - [[Source - Copilot Skill Restructure Instructions]] - [[Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04]] - [[Source - LLM Improvements Production Agent Gaps 2026]] - [[CLAUDE.md]] - [[Denylist over Allowlist]] - [[Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31]] - [[ENVIRONMENT.md]] - [[Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]] ## Fußnoten [^s-conversation-agents-md-skill-restructuring-session-2026-08-04]: [[Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04]] [^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]: [[Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]] [^s-conversation-comma-bug-budget-refund-and-lint-report-path-session-2026-08-31]: [[Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31]] [^s-llm-wiki-v2]: [[Source - LLM Wiki v2]] [^s-llm-improvements-sonnet-analysis]: [[Source - LLM Improvements Sonnet Analysis]] [^s-llm-improvements-codex-analysis]: [[Source - LLM Improvements Codex Analysis]]