torben/chemenu
1
1
Fork 0
Code Issues 26 Pull Requests Actions Packages Releases 32 Activity
Files
main
chemenu/kb/entities/systems/AGENTS.md.md
T
torben 54d9540c08
CI / verify (push) Successful in 56s
Details
Release / release (push) Successful in 36s
Details
stack: Konfidenz-Mechanismus ersatzlos entfernt, Korpus migriert (schliesst #60, #86) 
Files changed:
- .wikitool-kb.json
- AGENTS.md
- CHANGES.md
- INSTALL-MCP.md
- INSTALL.md
- README.md
- VERSION
- instructions/capture-session.md
- instructions/dev/issue-tracking.md
- instructions/german-terminology.md
- instructions/kb-profiles.md
- instructions/migrate-corpus.md
- instructions/migrations/5.0.0-confidence-removal.md
- instructions/private-instance.md
- instructions/setup-instance.md
- instructions/wiki-lint/SKILL.md
- instructions/wiki-manage/SKILL.md
- instructions/wiki-query/SKILL.md
- kb/CONTRACT.md
- kb/CONVENTIONS.md
- kb/CONVENTIONS.md.template
- kb/concepts/architectures/Consolidation Tiers.md
- kb/concepts/architectures/Context Isolation.md
- kb/concepts/architectures/Cross-platform Agent Skills.md
- kb/concepts/architectures/Episodic Memory.md
- kb/concepts/architectures/Hybrid Search.md
- kb/concepts/architectures/Implementation Spectrum.md
- kb/concepts/architectures/Knowledge Graph.md
- kb/concepts/architectures/LLM Wiki Pattern.md
- kb/concepts/architectures/MCP-Leseserver.md
- kb/concepts/architectures/Memory Lifecycle.md
- kb/concepts/architectures/OKF Compatibility.md
- kb/concepts/architectures/Optional Instance Context File.md
- kb/concepts/architectures/Personalization Plane.md
- kb/concepts/architectures/Procedural Memory.md
- kb/concepts/architectures/RAG.md
- kb/concepts/architectures/Scale Ceiling.md
- kb/concepts/architectures/Semantic Memory.md
- kb/concepts/architectures/Three-Layer Architecture.md
- kb/concepts/architectures/Token Economics.md
- kb/concepts/architectures/Working Memory.md
- kb/concepts/decisions/Delete Rather Than Anonymize.md
- kb/concepts/decisions/Denylist over Allowlist.md
- kb/concepts/decisions/Diff-Reviewable Agent Edits.md
- kb/concepts/decisions/Dual Licensing by File Plan.md
- kb/concepts/decisions/Issue Label Scheme.md
- kb/concepts/decisions/KB Stack Versioning.md
- kb/concepts/decisions/Structural Enforcement over Documented Rule.md
- kb/concepts/patterns/Audit Trail.md
- kb/concepts/patterns/BM25.md
- kb/concepts/patterns/Command Round-Trip Integrity.md
- kb/concepts/patterns/Confidence Scoring.md
- kb/concepts/patterns/Contradiction Resolution.md
- kb/concepts/patterns/Entity Extraction.md
- kb/concepts/patterns/Filter on Ingest.md
- kb/concepts/patterns/Forgetting.md
- kb/concepts/patterns/Graph Traversal.md
- kb/concepts/patterns/Mesh Sync.md
- kb/concepts/patterns/Quality Scoring.md
- kb/concepts/patterns/Reciprocal Rank Fusion.md
- kb/concepts/patterns/Self-Healing.md
- kb/concepts/patterns/Shared vs Private.md
- kb/concepts/patterns/Typed Relationships.md
- kb/concepts/patterns/Vector Search.md
- kb/concepts/patterns/Work Coordination.md
- kb/concepts/problems/Ambient Environment Dependency.md
- kb/concepts/problems/Detect-Repair Asymmetry.md
- kb/concepts/problems/Green Suite Blind Spot.md
- kb/concepts/problems/Naming Convention Conflict.md
- kb/concepts/problems/Write-Once Frontmatter Fields.md
- kb/concepts/protocols/CPPC.md
- kb/concepts/protocols/Modbus.md
- kb/concepts/protocols/SSD TRIM.md
- kb/concepts/workflows/Anti-Cramming Heuristic.md
- kb/concepts/workflows/Bulk Operations.md
- kb/concepts/workflows/CI Integration.md
- kb/concepts/workflows/Checkpoint Audit.md
- kb/concepts/workflows/Claude Code Auto Mode.md
- kb/concepts/workflows/Content Quality Control.md
- kb/concepts/workflows/Crystallization.md
- kb/concepts/workflows/Event-Driven Automation.md
- kb/concepts/workflows/Hooks.md
- kb/concepts/workflows/Index Scaling.md
- kb/concepts/workflows/Iteration and Cost Limits.md
- kb/concepts/workflows/KB Migration.md
- kb/concepts/workflows/Knowledge Compounding.md
- kb/concepts/workflows/Lint Workflow.md
- kb/concepts/workflows/Mass-Update Gate.md
- kb/concepts/workflows/Multi-Agent Collaboration.md
- kb/concepts/workflows/Privacy and Governance.md
- kb/concepts/workflows/Publish-Remote Gate.md
- kb/concepts/workflows/Quality and Self-Correction.md
- kb/concepts/workflows/Semantic Lint Automation.md
- kb/concepts/workflows/Session Orientation.md
- kb/concepts/workflows/Split Merge Reclassify.md
- kb/concepts/workflows/Split Threshold.md
- kb/concepts/workflows/Stub Threshold.md
- kb/concepts/workflows/Supersession.md
- kb/concepts/workflows/User Management.md
- kb/concepts/workflows/Workflow Extraction.md
- kb/concepts/workflows/Workflow Orchestration.md
- kb/entities/people/Andrej Karpathy.md
- kb/entities/people/E3DC GmbH.md
- kb/entities/people/Rohit Gupta.md
- kb/entities/people/Vannevar Bush.md
- kb/entities/projects/BCDModule.md
- kb/entities/projects/Chemenu.md
- kb/entities/projects/andybalholm-edl.md
- kb/entities/projects/goresponsiveness.md
- kb/entities/projects/ha-core.md
- kb/entities/projects/hacs-e3dc.md
- kb/entities/projects/hacs-integration-blueprint.md
- kb/entities/projects/llm-wiki-skills.md
- kb/entities/projects/plugnburn-edl.md
- kb/entities/projects/wiki-skills-vanillaflava.md
- kb/entities/projects/wiki-skills.md
- kb/entities/systems/AGENTS.md.md
- kb/entities/systems/CLAUDE.md.md
- kb/entities/systems/E3DC.md
- kb/entities/systems/ENVIRONMENT.md.md
- kb/entities/systems/Memex.md
- kb/entities/systems/Tolkien Gateway.md
- kb/entities/technologies/Arch Linux.md
- kb/entities/technologies/Disk Encryption.md
- kb/entities/technologies/Docker.md
- kb/entities/technologies/GRUB.md
- kb/entities/technologies/Gitea Actions.md
- kb/entities/technologies/Gitea.md
- kb/entities/technologies/Go.md
- kb/entities/technologies/Home Assistant.md
- kb/entities/technologies/Kernel PM Governors.md
- kb/entities/technologies/LVM.md
- kb/entities/technologies/Linux Kernel.md
- kb/entities/technologies/MQTT.md
- kb/entities/technologies/OPC UA.md
- kb/entities/technologies/Python.md
- kb/entities/technologies/Rust.md
- kb/entities/technologies/Wine GE.md
- kb/entities/technologies/Wine-Staging.md
- kb/entities/technologies/acpi-cpufreq.md
- kb/entities/technologies/amd-pstate.md
- kb/entities/technologies/iii Engine.md
- kb/entities/tools/AUR.md
- kb/entities/tools/Act Runner.md
- kb/entities/tools/Agent Memory.md
- kb/entities/tools/Aura.md
- kb/entities/tools/Bottles.md
- kb/entities/tools/ChatGPT.md
- kb/entities/tools/Claude Code.md
- kb/entities/tools/Codex CLI.md
- kb/entities/tools/Dataview.md
- kb/entities/tools/GPG.md
- kb/entities/tools/GitHub Copilot.md
- kb/entities/tools/Gitea MCP Server.md
- kb/entities/tools/Lutris.md
- kb/entities/tools/Marp.md
- kb/entities/tools/Mistral Vibe.md
- kb/entities/tools/NotebookLM.md
- kb/entities/tools/Obsidian Web Clipper.md
- kb/entities/tools/Obsidian.md
- kb/entities/tools/OpenAI Codex.md
- kb/entities/tools/OpenCode.md
- kb/entities/tools/Pi.md
- kb/entities/tools/Proton.md
- kb/entities/tools/Steam.md
- kb/entities/tools/Wine.md
- kb/entities/tools/awesome-llm-wiki.md
- kb/entities/tools/farzaa gist.md
- kb/entities/tools/gdeploy.md
- kb/entities/tools/makepkg.md
- kb/entities/tools/pascalandy schema.md
- kb/entities/tools/qmd.md
- kb/entities/tools/wikitool.md
- kb/index.md
- kb/log.md
- raw/CONTRACT.md
- tools/CONTRACT.md
- tools/README.md
- tools/chemenu/api.py
- tools/chemenu/cli.py
- tools/chemenu/commands/confidence_decay.py
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/commands/doctor.py
- tools/chemenu/commands/index_build.py
- tools/chemenu/commands/new_page.py
- tools/chemenu/commands/search.py
- tools/chemenu/commands/touch.py
- tools/chemenu/commands/version_cmd.py
- tools/chemenu/conventions.py
- tools/chemenu/corpus_diff.py
- tools/chemenu/frontmatter_io.py
- tools/chemenu/lint_core.py
- tools/chemenu/mcp/server.py
- tools/chemenu/page.py
- tools/chemenu/search/base.py
- tools/chemenu/search/filters.py
- tools/chemenu/search/ripgrep.py
- tools/chemenu/search/service.py
- tools/chemenu/search/types.py
- tools/chemenu/tests/conftest.py
- tools/chemenu/tests/test_api.py
- tools/chemenu/tests/test_confidence_decay.py
- tools/chemenu/tests/test_corpus_diff.py
- tools/chemenu/tests/test_docs_verify.py
- tools/chemenu/tests/test_frontmatter_io.py
- tools/chemenu/tests/test_index_build.py
- tools/chemenu/tests/test_kb_scan.py
- tools/chemenu/tests/test_lint.py
- tools/chemenu/tests/test_mcp_server.py
- tools/chemenu/tests/test_new_page.py
- tools/chemenu/tests/test_page_ops.py
- tools/chemenu/tests/test_provenance.py
- tools/chemenu/tests/test_raw_cmd.py
- tools/chemenu/tests/test_search.py
- tools/chemenu/tests/test_touch.py
- tools/chemenu/tests/test_type_resolver.py
- tools/chemenu/tests/test_version_cmd.py
- tools/chemenu/tests/test_xref.py
- tools/chemenu/version.py
- types/concept.md
- types/concept.schema.yaml
- types/entity.md
- types/entity.schema.yaml
- types/instruction.md
- types/type-spec.md
2026-09-10 19:51:48 +02:00

10 KiB
Raw Permalink Blame History

type, entity_type, tags, created, modified, related, sources, provenance, summary
type entity_type tags created modified related sources provenance summary
types/entity.md system
schema
configuration
wiki
operating-system
2026-08-03 2026-08-31
depends-on
wikitool
exemplifies
Naming Convention Conflict
evidenced-by
Source - LLM Improvements Codex Analysis
evidenced-by
Source - LLM Improvements Sonnet Analysis
owns
ENVIRONMENT.md
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
sourced 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

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-Tabelle1 .
  • 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ät1 .
  • Git-Automation: Auto-Publish über wikitool - jetzt nur Policy in der Root-Datei; der Output-Abschnitt jeder Skill gibt an, ob dieser Workflow auto-published1 .
  • 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 vorbei2 . 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.02

  • 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 33

  • 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-Umschreiben1 .

  • 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:, 4 -Marker und provenance.md-Rückwärtsindex bieten ungewöhnlich reife Coverage5
  • Deterministisches CLI: wikitool handhabt mechanische Operationen präzise, anstatt an Ad-hoc-LLM-Scripts zu delegieren5
  • Konfidenz-Bewertung: Die Verfallsformel und das Bewertungssystem existieren und funktionieren effektiv5

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ügen5
  • Session-Orientierung als obligatorischen ersten Schritt für alle Workflows einbauen5

Siehe auch

Fußnoten

Beziehungen

Reference in New Issue View Git Blame Copy Permalink