83153026f8
Template: layer-2 overlay mirror + layer-3 projects with fictional construction-company lessons incl. the full promotion chain (2 projects -> org standard -> anonymized community distillate). Claude adapter builds self-contained agent-skill bundles with the section-3 contribution behaviour and the canonical manual trigger prompt. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PDKeXvpT6tENSvyQGLV1Uq
SkillFactor Org-Repo — Vorlage (Schicht 2 + 3)
Privates Wissens-Repo einer Organisation. Strukturell ein Spiegel der öffentlichen Community-Schicht: gleiche Berufs-Slugs, gleiche Competence-Slugs — dadurch kann euer spezifisches Wissen das allgemeine gezielt ergänzen oder überschreiben (Lade-Kaskade: Community → Org → Projekt; spezifischer schlägt allgemeiner).
Struktur
professions/<beruf-slug>/competences/<skill-slug>.md Schicht 2: Org-Overlay
projects/<kunde-slug>/<projekt-slug>/lessons/ Schicht 3: Projektwissen
<yyyy-mm-dd>-<slug>.md
- Schicht 2 (Overlay): Firmenstandards, Prozesse, Kalkulationsregeln,
bevorzugte Partner — OHNE Kunden-/Projektbezug. Datei-Frontmatter nach
schemas/lesson.schema.json(layer: 2). - Schicht 3 (Projekte): Kunden-/Projektbezug ausdrücklich erwünscht.
Frontmatter layer: 3 mit
customer+project(Pflicht). Jede Lesson referenziert die Competence-URIs der Community-Schicht (competences:) — so ist sie über den Kunden UND über die Kompetenz auffindbar.
Einrichtung (Gitea)
- Privates Repo anlegen:
$GITEA_URL/<org>/skillfactor-knowledge(Sichtbarkeit: privat). Diese Vorlage hineinkopieren. - Teamrechte pro Projektordner: Gitea vergibt Rechte pro Repo, nicht
pro Ordner. Empfohlenes Muster: pro schutzbedürftigem Kunden ein
eigenes Repo
skillfactor-projekt-<kunde>mit identischerprojects/<kunde>/…-Struktur und eigenem Gitea-Team; das Haupt-Repo hält Schicht 2 + unkritische Projekte. Alternativ (ein Repo): Branch- Schutz aufmain+ CODEOWNERS jeprojects/<kunde>/für die Reviews. - Branch-Schutz aktivieren: keine Direkt-Commits auf
main, Review erforderlich — Lessons kommen IMMER als Pull Request (zweistufiges Gate: Nutzer bestätigt Abgabe, Maintainer bestätigt Aufnahme). - Agent-Anbindung: SkillFactor-MCP-Gateway mit
GITEA_TOKEN(Scope: dieses Repo) verbinden — sieheservices/skillfactor-mcp/SPEC.md.
Beförderung (Wissen steigt durch Bewährung auf)
- Gleiche Erkenntnis in ≥ 2 Projekten → Vorschlag: ins Overlay (Schicht 2)
heben. Beispiel unten:
projects/kunde-a/.../2026-05-12-...+projects/kunde-b/.../2026-06-03-...→ Overlay-Lesson mitsource: promotion+promoted_from. - Bewährtes Overlay-Wissen ohne Firmenspezifika → anonymisiertes
Zweit-Destillat als PR an die Community (Beispiel:
professions/project-manager/competences/_promotion-beispiel-community-destillat.md). - Harte Regel: Aus
projects/fließt NIE etwas automatisch nach außen. Der Weg in die Community führt immer über ein explizit bestätigtes, generalisiertes, anonymisiertes Zweit-Destillat.
Anonymisierung (auch intern)
Rollen statt Klarnamen, wo möglich ("der Bauleiter des AG", "die Projektleiterin"), keine privaten Kontaktdaten. Richtung Community zusätzlich: keine Firmen-/Projekt-/Ortsbezüge, nur das übertragbare Muster.