Ziel

Für projektbezogene KI-Skills eine kleine, kanonische Karte bereitstellen, damit Projektanforderungen nicht im Skill dupliziert werden müssen.

Systemrollen

  • Workspace-AGENTS.md außerhalb von Git: nur Bootstrap-Einstieg; verweist auf versionierte Agent-Regeln in .agents/skills/.
  • Versionierte Skill-Repo-AGENTS.md: kompakte Laufzeitregeln und repo-lokale Zusatzregeln für Skill-Repos unter .agents/skills/shared/ und .agents/skills/<projekt>/.
  • GitHub-Pages-Doku: kanonische Projektanforderungen, Vorgangsregeln, Link- und Spiegelregeln.
  • tagebuch: Provenienz, Suchfälle, Rundenprotokolle und Herleitung.
  • Skills: Verweis-Karte, skillinterne Werkzeuge, Befehlscaches und wiederkehrende operative Arbeitsgänge.

Was ein Skill hier finden soll

  • wo Vorgangsarbeit öffentlich unter work/jira/J01-<KEY>/ liegt
  • wo kanonische Projektregeln unter policies/, operations/, areas/ und decisions/ liegen
  • wo Projekt-, System- und Ablaufdefinitionen unter specs/ liegen
  • wo der Mirror nur abgeleitete Sicht ist und nicht SSOT
  • wo Provenienz und Quellenlage im tagebuch nachgesehen werden

Was ein Skill selbst tragen darf

  • eine knappe Projektkarte mit Links auf die kanonischen Quellen
  • ein versioniertes Repo-AGENTS.md für das eigene Skill-Repo
  • skillinterne Hilfen wie Cache-Rezepte und Skriptpfade
  • den konkreten wiederkehrenden Arbeitsgang des Skills

Was ein Skill nicht duplizieren soll

  • projektweite Anforderungen, die schon kanonisch in GitHub Pages stehen
  • vollständige Vorgangsdefinitionen aus work/jira/
  • Themenhistorien oder Meta-Register, wenn dafür bereits Doku oder Quellenregister existieren

Kanonische Einstiege

Quellen und Provenienz

  • Das tagebuch bleibt der Ort für Suchfälle, Rundenprotokolle und Herleitung.
  • Skills verweisen auf das Quellenregister oder auf gezielt passende Notizen, führen aber keine doppelte Projektgeschichte.