# 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)

1. Privates Repo anlegen: `$GITEA_URL/<org>/skillfactor-knowledge`
   (Sichtbarkeit: privat). Diese Vorlage hineinkopieren.
2. **Teamrechte pro Projektordner:** Gitea vergibt Rechte pro Repo, nicht
   pro Ordner. Empfohlenes Muster: pro schutzbedürftigem Kunden ein
   eigenes Repo `skillfactor-projekt-<kunde>` mit identischer
   `projects/<kunde>/…`-Struktur und eigenem Gitea-Team; das Haupt-Repo
   hält Schicht 2 + unkritische Projekte. Alternativ (ein Repo): Branch-
   Schutz auf `main` + CODEOWNERS je `projects/<kunde>/` für die Reviews.
3. 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).
4. Agent-Anbindung: SkillFactor-MCP-Gateway mit `GITEA_TOKEN` (Scope:
   dieses Repo) verbinden — siehe `services/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 mit
  `source: 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.