feat: add own skills

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Sascha KönigandClaude Opus 5.5 committed 2026-11-01 15:59:55 +01:00
1 parent 02e2797fbd
commit ac6208717c
41 files changed
+4632

No files matched your search

+82
View File
@@ -0,0 +1,82 @@
---
name: az-datenanalyse
description: Datenanalyse mit dem AZ-Python-Datenstack (pandas/NumPy/openpyxl) — greift bei jeder Aufgabe, Excel- oder CSV-Dateien auszuwerten, umzuformen, zusammenzufassen oder Kennzahlen zu berechnen und das Ergebnis als Datei zurückzugeben. Bringt dem Agenten den zentralen Datenstack-Interpreter, den korrekten Ausführungsweg und die Sackgassen-Vermeidung bei (python aus dem PATH hat KEINE Datenpakete; pip/uv-Paketbefehle sind gesperrt).
---
# Datenanalyse mit dem AZ-Datenstack
Du arbeitest auf einer AZ-Agenten-Workstation. Für Datenanalyse steht dir ein
zentral ausgerollter Python-Datenstack bereit — aber nur über den Weg unten.
Die üblichen Verfahren (einfach `python` aufrufen, fehlende Pakete per pip
nachinstallieren) funktionieren hier bewusst nicht.
## Der zentrale Datenstack
- **Interpreter (IMMER diesen verwenden):**
`C:\ProgramData\az-fleet\datastack-venv\Scripts\python.exe`
- **Enthaltene Pakete:** pandas, NumPy, openpyxl (Excel lesen/schreiben —
`.xlsx`, nicht `.xls`).
- Der Datenstack wird zentral vom Fleet gepflegt und versioniert. Es gibt
keine anderen Datenpakete — plane deine Lösung mit genau diesen.
## So führst du eine Analyse aus
1. Skript mit dem Edit-Tool **im Arbeitsordner des Nutzers** schreiben
(z. B. `analyse.py`).
2. Ausführen per Bash — PowerShell-Form mit absolutem Interpreter-Pfad:
```powershell
& 'C:\ProgramData\az-fleet\datastack-venv\Scripts\python.exe' .\analyse.py
```
3. Ergebnis prüfen und dem Nutzer als Datei zurückgeben (z. B. Ergebnis-
Excel in den Arbeitsordner schreiben und den Pfad nennen).
**Wichtig:** Dieser Aufruf löst EINEN Bestätigungsdialog beim Nutzer aus.
Das ist beabsichtigt (Sicherheitskontrolle der AZ-Fleet-Konfiguration) und
kein Fehler. Fahre normal fort.
## Sackgassen vermeiden
- **`python` / `py` aus dem PATH sind das System-Python — OHNE pandas.**
`import pandas` scheitert dort. Nutze niemals das System-Python für
Datenanalyse.
- **Paketbefehle sind gesperrt und werden still blockiert.** Versuche
NIEMALS: `pip install …`, `python -m pip …`, `uv pip install …`, `uv add`,
`bun install` oder ähnliches. Das ist zentrale Fleet-Kontrolle — kein
Workaround, kein `--user`, kein `ensurepip`.
- **Fehlt ein Paket** (z. B. matplotlib): Löse die Aufgabe mit den
vorhandenen Mitteln (pandas kann rechnen, filtern, aggregieren; openpyxl
schreibt Excel inklusive einfacher Formatierung) oder sage dem Nutzer
klar, dass die IT das Paket zentral nachliefern muss (Fleet-Antrag).
Suche nicht nach Installationswegen.
## Typisches Muster (Excel rein → Kennzahlen → Excel raus)
```python
import pandas as pd
quelle = r"C:\Pfad\Zum\Arbeitsordner\eingabe.xlsx"
ziel = r"C:\Pfad\Zum\Arbeitsordner\ergebnis.xlsx"
df = pd.read_excel(quelle, sheet_name=0)
ergebnis = df.groupby("Kategorie")["Betrag"].agg(["sum", "mean", "count"])
with pd.ExcelWriter(ziel, engine="openpyxl") as writer:
ergebnis.to_excel(writer, sheet_name="Kennzahlen")
df.to_excel(writer, sheet_name="Rohdaten", index=False)
print(ergebnis)
print("Geschrieben:", ziel)
```
Pfade immer vom Nutzer erfragen oder aus dem Arbeitsordner ableiten — nie
raten.
## Datenschutz-Kurzregel
In Skripten, Prompts und Ergebnissen gelten die Regeln der AZ-Datenleitlinie:
keine personenbezogenen Daten (Namen, Adressen, Telefonnummern, E-Mail von
Menschen) — Menschen anonymisieren oder weglassen; keine Zugangsdaten; keine
besonders schützenswerten Kunden- und Rüstungsdaten. Im Zweifel: nachfragen
statt raten.
+68
View File
@@ -0,0 +1,68 @@
---
name: az-hilfe
description: Einstiegs- und Orientierungshilfe für die Agenten-Workstation der AZ-Gruppe — greift, wenn ein Anwender fragt, was sein Agent kann, welches Artefakt wofür da ist, wie man etwas beiträgt oder an wen man sich bei Problemen wendet.
---
# AZ-Agent — Hilfe & Onboarding
Du bist der Guide für Anwender der AZ-Agenten-Workstation. Wer diesen Skill aufruft,
will orientiert werden — nicht mit Technik-Details überschüttet werden. Antworte auf
Deutsch, freundlich und in kurzen Schritten.
> **Status: Entwurf.** Dieses Skill ist der erste Baustein des Company-Default-Sets
> und wird mit den kommenden Artefakten (Commands, Agenten, MCP-Anbindungen)
> mitwachsen. Solange ein Bereich noch leer ist, sage das ehrlich.
## Erste Orientierung: Was ist hier installiert?
Die Workstation erhält ihre Standard-Artefakte zentral aus dem Repository
`az-agent-defaults` — gespiegelt über das Fleet-Repo. Es gibt vier Arten:
| Frage des Anwenders | Artefakt-Art | Wo es liegt |
|---|---|---|
| „Mach X, wenn Y" — Verhalten beibringen | Skill | `skills/` |
| Wiederkehrenden Prompt als Tastendruck (/slash) | Command | `commands/` |
| Eigenes Agenten-Profil / Prüf-Subagenten | Agent | `agents/` |
| Werkzeug anbinden (API, Datenquelle) | MCP-Server | `mcp/` |
**Aktuell verfügbar:** dieser Hilfe-Skill selbst. Commands, Agenten-Definitionen
und MCP-Anbindungen folgen (in Vorbereitung). Versprich nichts, was nicht
ausgeliefert ist.
## Typische Anfragen und gute Antworten
- **„Was kann mein Agent überhaupt?"** → Nenne die vier Artefakt-Arten oben und
was davon heute live ist. Beispiel geben: dieser Skill hier ist eins.
- **„Ich will, dass der Agent immer X tut, wenn Y."** → Das ist ein **Skill**.
Erkläre: Verhaltens-Anweisungen werden zentral gepflegt (Beitragshinweise
unten), nicht lokal auf der Workstation gebastelt.
- **„Ich tippe jeden Tag dasselbe …"** → Kandidat für einen **Command** — noch in
Vorbereitung; Wunsch aufnehmen und an die IT weiterreichen.
- **„Kann der Agent auch auf Tool Z zugreifen?"** → Das ist eine **MCP-Anbindung**
— sicherheitsrelevant, läuft über die IT (keine lokalen Einträge).
- **„Mein Kollege hat einen Skill, ich nicht."** → Auslieferung erfolgt zentral im
Fleet-Rollout: App neu starten; bleibt der Skill weg, IT kontaktieren.
## Selbst beitragen
Änderungen laufen **zentral über die IT** im Repository `az-agent-defaults`:
1. Wohin gehört der Beitrag? → Tabelle oben („Wohin gehört mein Beitrag?").
2. Das Repo-README beschreibt je Artefakt-Typ verbindliche Guard-Regeln
(Struktur, Frontmatter, Pflichtfelder) — dort steht auch je ein Minimalbeispiel.
3. Beitrag als Commit/PR einreichen; die IT prüft und rollt aus. Erst nach
Rollout und App-Neustart ist das Artefakt auf den Workstationen.
Anwender sollten **nie** lokal in `~\.agents\skills` (oder vergleichbare
Spiegel-Verzeichnisse) editieren — lokale Änderungen werden vom nächsten
Rollout überschrieben.
## Bei Problemen
- Artefakt fehlt / verhält sich falsch → IT kontaktieren, mit Name des
Artefakts und kurzem Ablauf des Problems.
- Nichts funktionstüchtig ändern: Diagnose ja, lokale Reparatur nein —
sie überlebt den nächsten Rollout nicht.
Führe darüber hinaus keine Aktionen aus. Dieser Skill orientiert — er verändert
nichts.
+119
View File
@@ -0,0 +1,119 @@
---
name: basecamp-meins-meetings
description: Use when maintaining Sascha Koenig's personal Basecamp project "Meins": saving meeting summaries, extracting follow-up todos, creating project structure, or running weekly todo reviews / week-to-week assessments.
compatibility: opencode
---
# Basecamp Meins Meetings
## Core rules
- Always load/use the `basecamp` skill before Basecamp CLI actions.
- Target project: `🔒 Meins` (known ID: `43475695`). If the ID fails, resolve by project name `Meins`.
- Default meeting folder: Docs & Files → `Meetings` (known folder ID: `10028633782`). If missing, create/find it before writing.
- Avoid duplicates: inspect folders, todolists, documents, and todos before creating anything.
- Use `--json`/`--jq` for Basecamp reads; use `--no-subscribe` for documents unless the user asks for notifications.
- Treat transcripts as imperfect. Mark uncertain names/terms explicitly instead of inventing certainty.
## Default personal structure
Ensure these exist when the user asks to structure the project:
**Docs & Files folders**
- `00 Eingang & Notizen`
- `01 Entscheidungen & Leitplanken`
- `02 Projekte & Initiativen`
- `03 Prozesse & Automatisierung`
- `04 Wissen & Referenzen`
- `Wochenreviews` (create when running the first weekly review)
**To-do lists**
- `01 Inbox` — unsorted capture
- `02 Nächste Schritte` — active next actions
- `03 Wartet auf Rückmeldung` — blocked/delegated items
- `04 CEO Meeting Follow-ups` — meeting follow-ups
- `05 Backlog / Später` — parked topics
## Meeting-to-Basecamp workflow
1. Inspect project structure: `basecamp files list --in 43475695 --json` and `basecamp todolists list --in 43475695 --json`.
2. Summarize the transcript in German with these sections:
- Executive Summary
- Entscheidungen / Leitplanken
- Themenblöcke
- Offene Fragen
- Risiken & unklare Begriffe
- Angelegte To-dos
3. Create the document in `Meetings` with title: `YYYY-MM-DD – <kurzer Meetingtitel>`.
4. Extract only actionable todos. Each todo needs:
- prefix by topic (`SAN/BDE:`, `AZ-Welt:`, `Buchhaltung:`, etc.)
- concrete next action
- description with context, definition of done, blocker/dependency if known
- assignee `me`
- due date only if explicit or reasonably inferable; otherwise leave undated or ask
5. Put todos into the best list:
- immediate work → `02 Nächste Schritte`
- blocked/delegated → `03 Wartet auf Rückmeldung`
- CEO transcript follow-ups → `04 CEO Meeting Follow-ups`
- vague/later → `05 Backlog / Später`
6. Verify by re-reading the document/list and report links + counts.
## Weekly todo review workflow
Use when the user asks for a weekly review, week-to-week assessment, todo evaluation, or “was ist diese Woche wichtig?”.
1. Read all todolists in `Meins`, then fetch incomplete todos per list. Also fetch completed todos to identify last-week wins when available.
2. Classify every open todo:
- `🔥 Diese Woche erledigen/entscheiden` — due now, strategically important, or blocking others
- `⚠️ Überfällig` — due date passed
- `⏳ Wartet auf Rückmeldung` — delegated, blocked, or needs another person
- `🧹 Aufräumen` — unclear, duplicate, stale, or no longer relevant
- `📦 Backlog` — valid but not for this week
3. Score each important todo on four dimensions:
- urgency: overdue / due this week / later / no date
- clarity: next action obvious? definition of done present?
- momentum: new / idle 7+ days / idle 30+ days
- ownership: Sascha / waiting on someone / unclear
4. Produce a review with:
- top 5 priorities for the coming week
- overdue items and recommended action
- stale or unclear items to rewrite/delete/move
- waiting-on list with who/what is needed
- completed items since last review if detectable
- concrete recommendations: keep, do, defer, delegate, delete, or clarify
5. Before mutating existing todos in bulk, ask for approval. After approval, apply changes in small batches and verify.
6. Save a weekly review document in `Wochenreviews` titled `YYYY-MM-DD – Wochenreview To-dos`, unless the user only wants a chat summary.
## Weekly review output template
```md
# Wochenreview To-dos – YYYY-MM-DD
## Kurzfazit
[2–4 Sätze]
## Top 5 für diese Woche
1. [Todo] — Warum jetzt / nächster Schritt
## Überfällig
- [Todo] — Empfehlung: do / defer / delete / clarify
## Wartet auf Rückmeldung
- [Todo] — wartet auf [Person/Sache], nächster Nachfasspunkt
## Aufräumen
- [Todo] — Grund und empfohlene Aktion
## Erledigt seit letztem Review
- [Todo]
## Vorgeschlagene Änderungen
- [konkrete Basecamp-Änderungen, erst nach Freigabe ausführen]
```
## Common mistakes
- Do not create final-looking todos from unclear transcript fragments; mark them as clarification tasks.
- Do not silently notify people from the personal project.
- Do not treat the weekly review as just a list dump; it must include judgment and recommendations.
- Do not close, delete, or move many todos without explicit approval.
@@ -0,0 +1,133 @@
---
name: basecamp-weekly-meeting-prep
description: Use when preparing Sascha Koenig's weekly meeting / weekly leadership sync from the personal Basecamp project "Meins", including agenda creation, todo review, blockers, decisions, follow-ups, and optional Basecamp prep documents.
compatibility: opencode
---
# Basecamp Weekly Meeting Prep
## Core rules
- Always load/use the `basecamp` skill before Basecamp CLI actions.
- Also use `basecamp-meins-meetings` when the task touches meeting notes, follow-up todos, or weekly todo assessment.
- Target project: `🔒 Meins` (known ID: `43475695`). If the ID fails, resolve by project name `Meins`.
- Default prep document location: Docs & Files → `Meetings` or `Wochenreviews` if the user wants a weekly-review-style document.
- Do not create/move/close many todos without explicit approval. Preparation may read freely; mutation needs confirmation.
- Use `--json`/`--jq` for reads and `--no-subscribe` for personal prep documents unless the user asks otherwise.
## Purpose
Prepare Sascha for a weekly meeting by turning Basecamp state into a sharp agenda:
- what happened since the last weekly
- what is overdue or stuck
- what needs a decision
- what should be escalated
- which topics deserve airtime
- what follow-ups should be captured after the meeting
## Inputs to inspect
1. All todolists in `Meins`, especially:
- `02 Nächste Schritte`
- `03 Wartet auf Rückmeldung`
- `04 CEO Meeting Follow-ups`
- `05 Backlog / Später`
2. Recent documents in:
- `Meetings`
- `Wochenreviews` if present
- `01 Entscheidungen & Leitplanken` if relevant
3. Recent completed todos if available.
4. Any user-supplied meeting context, transcript, rough notes, or agenda request.
## Preparation workflow
1. Inspect Basecamp structure and resolve folder/list IDs.
2. Fetch open todos per relevant list; include due dates, descriptions, assignees, and URLs.
3. Identify recent completions or changes since the last weekly if detectable.
4. Read the latest meeting notes / weekly review documents when relevant.
5. Classify topics:
- `Entscheidung nötig` — needs CEO/leadership decision
- `Blockiert` — waiting on a person, external input, unclear mandate
- `Überfällig` — due date passed or urgency high
- `Update reicht` — progress information only
- `Nicht besprechen` — valid but no airtime this week
6. Build a meeting agenda with a recommended order:
- urgent blockers first
- decisions second
- short updates third
- backlog/strategic topics last
7. Draft exact talking points in Sascha's voice: direct, pragmatic, internally usable, no inflated wording.
8. If requested, create a Basecamp prep document and verify its link.
## Weekly prep output template
```md
# Weekly Vorbereitung – YYYY-MM-DD
## Kurzfazit
[2–4 Sätze: Lage, Fokus, größte Risiken]
## Agenda-Vorschlag
1. [Thema] — Ziel: Entscheidung / Klärung / Update
2. ...
## Entscheidungen nötig
- [Thema]
- Kontext:
- Optionen:
- Empfehlung:
- Konkrete Frage im Meeting:
## Blocker / Eskalationen
- [Thema] — blockiert durch [Person/Sache], gewünschte Entscheidung oder Hilfe
## Überfällige / kritische To-dos
- [Todo] — Empfehlung: erledigen / verschieben / delegieren / streichen
## Updates, die kurz reichen
- [Thema] — 1–2 Sätze Status
## Nicht diese Woche besprechen
- [Thema] — Grund
## Gesprächsnotizen / Formulierungen
- „[präzise Formulierung für schwierige Themen]“
## Nach dem Meeting erfassen
- potenzielle Follow-up-To-dos
- Entscheidungen, die dokumentiert werden müssen
```
## Basecamp document workflow
When saving the prep:
1. Create or reuse a folder:
- preferred: `Meetings` for agenda/prep docs
- alternative: `Wochenreviews` for recurring review docs
2. Title: `YYYY-MM-DD – Weekly Vorbereitung`.
3. Use `--no-subscribe` unless notifications are explicitly requested.
4. Re-read the document with `basecamp files show <id> --in 43475695 --json` and report the link.
## After-meeting workflow
When the user provides meeting notes after the weekly:
1. Summarize decisions separately from discussion.
2. Convert only concrete commitments into todos.
3. Put follow-ups into the most appropriate list:
- immediate action → `02 Nächste Schritte`
- waiting/delegated → `03 Wartet auf Rückmeldung`
- leadership/CEO follow-up → `04 CEO Meeting Follow-ups`
- later → `05 Backlog / Später`
4. Create/update the meeting document only after checking for duplicates.
5. Verify created todos and document links.
## Common mistakes
- Do not turn every todo into an agenda item; weekly airtime is limited.
- Do not hide uncomfortable topics. Surface blockers and overdue items clearly.
- Do not over-draft corporate language; use practical, direct internal wording.
- Do not make unsupported assumptions from unclear transcripts; mark uncertainty.
- Do not mutate Basecamp in bulk during preparation without explicit approval.
+98
View File
@@ -0,0 +1,98 @@
---
name: lead-meeting-followup
description: |
Follow up a recorded meeting for Sascha: pull the Sally recording, write the German
"📝 Meeting-Zusammenfassung" into the right Basecamp project, then propose rule-compliant
Basecamp to-dos (and optional OKF decisions) and create them after approval.
Use when the user wants to: document / summarize / follow up a meeting, file meeting notes
or a transcript in Basecamp, or turn meeting action items into to-dos.
Triggers: "Meeting nachbereiten", "Meeting-Zusammenfassung", "letztes Meeting nach Basecamp".
compatibility: opencode, claude-code
---
# lead-meeting-followup
The single path for meeting follow-up in the `lead-*` family. One run = one recording → one Basecamp document → approved to-dos.
## Sources of truth
Read before acting; these hold the facts, this skill holds only behaviour:
- `/home/sascha.koenig/p/PM/.okf/processes/meeting-runden.md`: round profiles (filing project, Sally search term, participants)
- `/home/sascha.koenig/p/PM/.okf/processes/it-basecamp-regeln.md`: to-do rules, the six 👥 IT lists, approval protocol
- `/home/sascha.koenig/p/PM/.okf/systems/basecamp.md`: project, list and folder IDs
- `/home/sascha.koenig/p/PM/.okf/organization/*.md`: people and their Basecamp person IDs
An ID that fails: resolve by name, carry on, and mention the mismatch in the final report.
Load the `basecamp` skill before any Basecamp CLI call. Check flags with `basecamp <cmd> --agent --help`; they evolve.
## Steps
### 1. Pick the recording
Use the Sally MCP tools (`search_appointments`, `get_recordings`, `get_summary`, `get_transcription`; read each tool's schema for its arguments). List Sascha's ~5 most recent recordings (title, date) and let the user pick; default to the newest.
Fetch the full transcription and Sally's summary. Sally's summary and task suggestions are raw material; the transcript is authoritative. For a long transcript, hand extraction to a subagent if the harness offers one: ask for goals, decisions, next steps, action items (task / owner / deadline), open questions, risks, links, in German, one line each.
**Done when** you hold the transcript-grounded notes and the meeting date, title and participants.
### 2. Settle the project
Match the recording title against the Sally search terms in `meeting-runden.md`. On a match, propose that round's filing project and let the user confirm in one word. Otherwise ask, offering a shortlist from `basecamp projects list --json` (names matching participants or keywords) plus free text.
**Done when** the user has confirmed a project and you hold its numeric ID.
### 3. Draft and clarify
Fill `assets/template.md`. Keep every header, emoji and section exactly; write German in the meeting's tone.
- **Header block:** from recording metadata. Protokoll = the assistant unless a note-taker is named. Bezug = the chosen project. Every header line keeps its two trailing spaces (Markdown hard break); without them Basecamp collapses the header into one line.
- **Ziel:** from the opening minutes, the stated purpose.
- **Kurzfazit:** 3–5 sentences covering the three bullets (Erkenntnis / Entscheidung / offener Punkt).
- **Entscheidungen:** only what was actually agreed, with context and scope; leave the list minimal when nothing was decided.
- **Nächste Schritte** (higher-level follow-ups) vs. **To-dos** (concrete assigned actions): each item lives in exactly one of the two.
- **Kontext & Links:** project, meeting link, `sally://recording/<id>`.
Speech-to-text garbles names and jargon: mark every doubt as `[unklar: …]` while drafting, then ask the user about all of them in one batch and apply the answers.
**Done when** the draft holds zero `[unklar]` markers.
### 4. Post the document
Posting is the expected next action; go straight ahead without a "should I post?" gate. Fixes after posting happen by updating the document.
1. Find the `Meetings` folder in the project (`basecamp files list --in <project> --json`); create it if missing.
2. Create the document `YYYY-MM-DD – <Meetingtitel>` (meeting date, never today's) in that folder with `--no-subscribe`. Pass the long Markdown from a temp file in the scratchpad.
3. Read it back and keep its URL.
**Done when** the document is readable in Basecamp and you have its URL.
### 5. Propose, approve, create
Draft one to-do per item in "📌 To-dos" and "➡️ Nächste Schritte" (skip when both are empty), following `it-basecamp-regeln.md`:
- **Title:** verb first, actionable.
- **Description:** why it matters, definition of done, dependency, link to the summary document.
- **Owner:** exactly one, resolved to a Basecamp person ID via the OKF profiles or `basecamp people list`.
- **Due date:** always one. A deadline named in the meeting is resolved against the meeting date; otherwise propose a date and label it `Vorschlag`.
- **List:** the best existing list. In 👥 IT one of the six rule lists. Where no list fits, say so and propose the closest one; list creation is reserved for the Friday close.
Add, under the same approval, a proposal "als OKF-Decision anlegen?" for each decision whose reach goes beyond this meeting.
Present everything as one numbered list (title, owner, due date, list, description). The user approves as a batch, drops items by number, or edits single items. Act on an explicit answer only.
Create the approved to-dos (`basecamp todos create … --assignee <id> --due <date> --list <id> --in <project> --json`). Write approved decisions as `type: Decision` concepts in `/home/sascha.koenig/p/PM/.okf/decisions/` with `status: draft`, source `sally://recording/<id>`, and a link to the summary document; validate the bundle with the `validate` skill.
**Done when** every approved item exists and you report: document URL, to-do URLs, OKF files, and any ID mismatches from the sources-of-truth check.
## Guardrails
- Every decision, owner and deadline in the document traces back to the transcript.
- The project is always confirmed by the user, even when a round profile suggests it.
- Every to-do carries context; a bare title is incomplete.
- To-dos and OKF decisions wait for explicit approval; the summary document does not.
## Template refresh
`assets/template.md` is a local copy of the Basecamp document "📝 Meeting-Zusammenfassung" (project 👥 IT- und Projektabstimmung CZ/DE `47617617`, document `10159592734`). Refresh it only on request by re-fetching that document.
@@ -0,0 +1,90 @@
📋 Vorlage: Meeting-Zusammenfassung
📅 Datum: [TT.MM.JJJJ]
🕘 Zeit: [Start – Ende]
📍 Ort / Link: [Raum oder Meeting-Link]
👤 Moderation: [Name]
✍️ Protokoll: [Name]
👥 Teilnehmende: [Namen / Abteilungen]
🔗 Bezug: [Projekt / Nachricht / Termin / Link]
---
# 🎯 Ziel des Meetings
Was soll am Ende des Meetings klar sein?
1. [Ziel 1]
2. [Ziel 2]
3. [Ziel 3]
---
# 🧭 Kurzfazit
Kurze Zusammenfassung in 3–5 Sätzen:
- [Wichtigste Erkenntnis]
- [Wichtigste Entscheidung / Richtung]
- [Wichtigster offener Punkt]
---
# ✅ Entscheidungen / Festlegungen
1. **[Entscheidung oder Festlegung]**
- Kontext: [Warum wurde das so festgelegt?]
- Gilt für: [Bereich / Prozess / Zeitraum]
- Einschränkung / offener Punkt: [falls vorhanden]
2. **[Entscheidung oder Festlegung]**
- Kontext: [Warum wurde das so festgelegt?]
- Gilt für: [Bereich / Prozess / Zeitraum]
- Einschränkung / offener Punkt: [falls vorhanden]
---
# ➡️ Nächste Schritte
1. [Nächster Schritt] — Verantwortlich: [Name] — Bis: [Datum / offen]
2. [Nächster Schritt] — Verantwortlich: [Name] — Bis: [Datum / offen]
3. [Nächster Schritt] — Verantwortlich: [Name] — Bis: [Datum / offen]
---
# 📌 To-dos
- ☐ [Aufgabe] — Verantwortlich: [Name] — Bis: [Datum / offen]
- ☐ [Aufgabe] — Verantwortlich: [Name] — Bis: [Datum / offen]
- ☐ [Aufgabe] — Verantwortlich: [Name] — Bis: [Datum / offen]
---
# ❓ Offene Fragen
- [Frage 1]
- [Frage 2]
- [Frage 3]
---
# ⚠️ Risiken / Abhängigkeiten
1. **[Risiko / Abhängigkeit]**
- Auswirkung: [Hoch / Mittel / Niedrig]
- Umgang damit: [Gegenmaßnahme / Klärung]
2. **[Risiko / Abhängigkeit]**
- Auswirkung: [Hoch / Mittel / Niedrig]
- Umgang damit: [Gegenmaßnahme / Klärung]
---
# 🗂️ Kontext & Links
- Projekt: [Basecamp-Projekt / Link]
- Bezug / Vorbereitung: [Nachricht / Dokument / Link]
- Anlagen / Transkript: [Datei / Link]
---
# 💬 Notizen / Details
Platz für zusätzliche Notizen, Diskussionspunkte oder fachliche Details.
+120
View File
@@ -0,0 +1,120 @@
---
name: lead-meeting-prep
description: |
Prepare one of Sascha's recurring meeting rounds: compare against the last Sally summary of
the same round, pull the round's Basecamp state from the cockpit, and write a German agenda
with "Seit letztem Mal", decisions, blockers and talking points.
Use when the user wants to prepare a recurring meeting or build its agenda.
Triggers: "Meeting vorbereiten", "Weekly vorbereiten", "Agenda für …".
compatibility: opencode, claude-code
---
# lead-meeting-prep
Prepares one recurring round (Weekly GF, Regeltermin …) in the `lead-*` family. One run = one round → one German prep in the chat. A 1:1 with a team member is out of scope: point the user to `lead-radar person <name>` and stop. Follow-up after the meeting belongs to `lead-meeting-followup`.
## Sources of truth
Read before acting; these hold the facts, this skill holds only behaviour:
- `/home/sascha.koenig/p/PM/.okf/processes/meeting-runden.md`: round profiles (participants, Bezug, filing location, Sally search term, Meins lists)
- `/home/sascha.koenig/p/PM/.okf/systems/basecamp.md`: project, list and folder IDs
- `/home/sascha.koenig/p/PM/.okf/processes/it-basecamp-regeln.md`: approval protocol for any Basecamp write
An ID that fails: resolve by name, carry on, and mention the mismatch in the final report.
The run is read-only. Load the `basecamp` skill before any Basecamp CLI call; check flags with `basecamp <cmd> --agent --help`.
## Steps
### 1. Identify the round
Match the user's wording (round name, participant, or an appointment from Sally/calendar) against the profiles in `meeting-runden.md`. On a unique match, name the round and go on; otherwise ask, listing the profiles.
Collect every field of that profile marked `offen` that this run needs (Sally search term, participants, Turnus) and ask about all of them in one question. Keep the answers for this run and for step 5.
**Done when** you hold the round, its Bezug projects (Basecamp IDs), its Meins lists, its filing location and a Sally search term (or the user's explicit "keiner").
### 2. Last time: Sally
Use the Sally MCP tools (`search_appointments`, `get_recordings`, `get_summary`, `get_transcription`; read each tool's schema for its arguments). Search with the round's search term, take the most recent past appointment that has a recording, and fetch its summary. Pull the transcription only where the summary is too thin to tell what was promised or decided.
Extract every promise and decision from that meeting as one line each: what, who, by when. When Sally finds nothing (no term, no hit, not authenticated), say so in the prep and continue without "Seit letztem Mal".
**Done when** you hold the date and recording ID of the last meeting and its full promise/decision list, or a stated reason why there is none.
### 3. Current state: Basecamp
Run from `/home/sascha.koenig/p/PM`:
```bash
python3 tools/it-cockpit/cockpit.py --json --scope runde --projects <id,id,…> # Bezug projects of the round
python3 tools/it-cockpit/cockpit.py --json --scope meins # 🔒 Meins by list → the round's Meins lists
```
`runde` returns per project `offen` (count), `ueberfaellig`, `diese_woche`, `still_30d`, `wartend_nachfassen`, each item with title, list, assignees, due, `still_tage`, description and URL. For a round whose Bezug is the whole portfolio (Weekly GF), use `--scope portfolio` instead of `runde`. Report anything under `errors` or `drift` in the prep footer. The cockpit takes 1–2 minutes; run both calls in parallel if the harness allows.
Then trace each promise from step 2 to its current state: find the matching to-do (by title, owner, or via `basecamp` search/show for detail), and note done / in progress / overdue / not found.
**Done when** every promise from step 2 has a state, and every item in the round's Meins lists and in `ueberfaellig` is classified (step 4 categories).
### 4. Write the prep
Classify each topic as `Entscheidung nötig`, `Blockiert`, `Überfällig`, `Update reicht` or `Nicht besprechen`. Order the agenda: blockers, decisions, short updates, backlog/strategy last. Airtime is limited: put a topic on the agenda only when it needs the other participants; the rest goes under "Updates" or "Nicht diese Woche". Surface uncomfortable topics plainly; mark anything uncertain as `[unklar: …]`.
Write in Sascha's voice: direct, pragmatic, plain internal German (see `sascha-internal-communication-style` for wording). Fill this template in the chat; leave out a section only when it is empty, and say so in one line:
```md
# <Runde> – Vorbereitung YYYY-MM-DD
## Kurzfazit
[2–4 Sätze: Lage, Fokus, größte Risiken]
## Seit letztem Mal (<Datum letzter Termin>)
- [Zusage/Entscheidung] — [wer] → **[erledigt / läuft / überfällig / nicht auffindbar]**, [Stand in einem Satz, Link]
## Agenda-Vorschlag
1. [Thema] — Ziel: Entscheidung / Klärung / Update
2. ...
## Entscheidungen nötig
- [Thema]
- Kontext:
- Optionen:
- Empfehlung:
- Konkrete Frage im Meeting:
## Blocker / Eskalationen
- [Thema] — blockiert durch [Person/Sache], gewünschte Entscheidung oder Hilfe
## Überfällige / kritische To-dos
- [Todo](URL) — Empfehlung: erledigen / verschieben / delegieren / streichen
## Updates, die kurz reichen
- [Thema] — 1–2 Sätze Status
## Nicht diese Woche besprechen
- [Thema] — Grund
## Gesprächsnotizen / Formulierungen
- „[präzise Formulierung für schwierige Themen]“
```
**Done when** every promise from step 2 appears in "Seit letztem Mal", every overdue item appears in the prep, and each agenda item names its goal.
### 5. Close out
End with a short footer: sources used (Sally recording ID, cockpit scopes), ID mismatches, drift/errors.
Then offer, as one numbered list, only what applies:
1. **Profile fields:** the `offen` values the user answered in step 1, as exact replacement lines for `meeting-runden.md`. After an explicit yes, edit the profile (only those lines) and validate the bundle with the `validate` skill.
2. **Basecamp prep document:** on request only. Location from the round profile, default 🔒 Meins → folder `Meetings`; title `YYYY-MM-DD – <Runde> Vorbereitung` (meeting date); `--no-subscribe`; pass the Markdown from a temp file in the scratchpad; read it back and report the URL.
3. **To-do changes** the prep suggests (owner, due date, move, park, complete): propose them per the approval protocol in `it-basecamp-regeln.md` and execute only approved items, each with a short reason comment.
**Done when** the prep is delivered and every offered write is either executed after an explicit yes or left untouched.
## Guardrails
- Every "Seit letztem Mal" line traces back to the Sally summary/transcript; every state traces to a Basecamp item or reads "nicht auffindbar".
- Basecamp, OKF and Sally stay unchanged unless the user explicitly approves a write from step 5.
+195
View File
@@ -0,0 +1,195 @@
---
name: lead-profile
description: "Maintains OKF Person profiles of colleagues in /home/sascha.koenig/p/PM/.okf/organization/: create (minimal stub or full profile via interview wizard), verify, link, refresh, data-subject requests, offboarding. Use when: new colleague / onboarding profile, quarterly or stale profile review, upgrading a minimal stub, Auskunfts- or Löschanfrage, colleague leaves. Trigger: 'Mitarbeiterprofil', 'Kollegen-Profil', 'Profil für NN anlegen', 'Profil aktualisieren', 'Skill-Matrix für NN', 'Belbin-Rolle für NN'."
compatibility: opencode, claude-code
---
# lead-profile
Maintains OKF Person profiles in `/home/sascha.koenig/p/PM/.okf/organization/` (fixed path, called `ORG/` below; bundle root `/home/sascha.koenig/p/PM/.okf/`). Profiles serve project planning, delegation and personnel development — never performance assessment.
**Scope: profile maintenance only.** Questions like "wer hat Kapazität", "wem delegiere ich", "wer kennt sich aus mit X" or team composition belong to `lead-radar`, which reads these profiles. This skill writes them.
Skill text is English; everything written into profiles and all messages to the user are German.
## Principles
1. **Job-relevant only.** No private data, no performance ratings, no salary. See [references/gdpr-de.md](references/gdpr-de.md).
2. **Self-report over outside rating.** Colleagues maintain their skills; the manager verifies.
3. **Fresh.** Every full profile has `stale_after` (180 days); review is due after that.
4. **Linked, not duplicated.** Project membership links to `../projects/`, never copied.
5. **Department-agnostic.** Examples are IT; the schema fits every department.
## Two profile levels
| Level | Allowed when | Content | Frontmatter |
|---|---|---|---|
| **Minimal stub** | always, no privacy notice needed (organisational master data) | Name, role, e-mail, Basecamp-Person-ID, Zammad-Login, manager, department. Nothing else | `consent.notice_given_at: null`, `consent.scope: stammdaten`, tag `minimal-stub`, `sensitivity: internal` |
| **Full profile** | only after the privacy notice was given (date in `consent.notice_given_at`) | everything in [assets/person-template.md](assets/person-template.md) | `sensitivity: confidential`, `stale_after`, `verified` |
Every field beyond the stub's list requires the notice. Upgrading a stub to a full profile is an explicit operation (see *upgrade*), never a side effect of an edit.
## Identity fields (both levels, required)
The IT cockpit parses these two lines, so keep this exact form:
```
- **Basecamp-Person-ID**: `52087611`
- **Zammad-Login**: `vorname.nachname@azintec.com`
```
ID as a backticked number. Zammad-Login backticked, or the plain word `offen` when unknown. Resolve the Basecamp ID via `basecamp people list --in <projekt-id>` (project IDs in `/home/sascha.koenig/p/PM/.okf/systems/basecamp.md`) or the auto-enrichment report.
## Operations
### stub — create a minimal stub
1. Copy [assets/stub-template.md](assets/stub-template.md) to `ORG/<vorname>-<nachname>.md`.
2. Fill only the stub fields, each fact with a footnote source. Example: `ORG/maximilian-radtke.md`.
3. Run *link*, then *validate*.
### create — full profile via interview wizard
Starts on "Erstelle Profil für [Name]", "Profil-Interview mit [Name]", "Profile-Wizard für [Name]", "Mitarbeiterprofil anlegen: [Name]". An existing profile goes to *refresh* or *upgrade* instead; a plain skill-level question is answered directly without the wizard.
Load [references/interview-guide.md](references/interview-guide.md) and work through it phase by phase, **one question per message**. Present multiple-choice questions (skill levels, Belbin, availability) as numbered options the user answers by number; a harness choice tool may be used if available.
```
Phase 0 Pre-flight → privacy notice given? (no → stop; offer a stub instead)
Phase 1 Auto-enrichment → bash scripts/auto-enrich.sh "<Name>"
Phase 2 Identity → title, location, tenure, manager, e-mail, Basecamp-Person-ID, Zammad-Login
Phase 3 Background → education, stations, certificates
Phase 4 Skills assessment → 5–15 questions with behavioural anchors
Phase 5 Team profile → optional (Belbin, CliftonStrengths, working style)
Phase 6 Capacity → availability, projects, engagement type
Phase 7 Growth → skills, roles, mentoring
Phase 8 Draft review → show draft, user approval
Phase 9 Verify plan → checklist, next steps
```
Filling the file: copy [assets/person-template.md](assets/person-template.md) to `ORG/<vorname>-<nachname>.md`; frontmatter `title`, `description`, `tags`, `generated.at` (today), `stale_after` (today + 180 days), `consent.notice_given_at` (notice date). Start the skills matrix with 3–5 core skills. Belbin/CliftonStrengths only when already known. `status: draft` until *verify*.
**Hard gates.** The profile file is written only after the user approved the draft (Phase 8). Belbin roles and CliftonStrengths come only from the user or a test, never guessed. A skill level ≥3 needs evidence (ticket, certificate, commit), otherwise level ≤2. Ask only job-relevant fields (performance, salary etc. are forbidden, Option A). One question per message. Phase 0 must pass before anything beyond stub data is collected.
**Wizard resources**
| Resource | When |
|---|---|
| [scripts/auto-enrich.sh](scripts/auto-enrich.sh) | Phase 1, run once |
| [references/interview-guide.md](references/interview-guide.md) | before wizard start |
| [references/skill-anchors-cheatsheet.md](references/skill-anchors-cheatsheet.md) | Phase 4, anchors for the top-10 IT skills |
| [references/competence-catalog-it.md](references/competence-catalog-it.md) | Phase 4, IT |
| [references/competence-catalog-template.md](references/competence-catalog-template.md) | Phase 4, non-IT |
| [references/gdpr-de.md](references/gdpr-de.md) | Phase 0, privacy notice template |
**Auto-enrichment sources** (only sources every AZ department head can reach): Basecamp full-text search + person record from creator fields; the OKF bundle at `/home/sascha.koenig/p/PM/.okf`; NixOS user configs (optional, IT-only, `$NIX_DIR`). Deliberately excluded: the private `m3ta-brain` vault and agent session logs. To skip NixOS: `NIX_DIR=/dev/null`.
### upgrade — stub to full profile
Explicit request only ("Profil für NN ausbauen"). Run the wizard from Phase 0 against the existing stub: privacy notice date required. Then set `consent.notice_given_at`, remove `consent.scope: stammdaten` and the `minimal-stub` tag, set `sensitivity: confidential`, add `stale_after` and `verified: []`, replace the stub notice with the full template sections. Identity fields stay as they are.
### verify — review
1. The colleague reads the draft and adds/corrects (job-relevant skills only).
2. The manager confirms skill levels with concrete evidence (project, certificate, ticket).
3. Fill the `verified` array: `- by: "human:<manager-slug>", at: "YYYY-MM-DD"`.
4. Set `status: stable`.
5. Add to `/home/sascha.koenig/p/PM/.okf/log.md`: `YYYY-MM-DD: Profil <slug> angelegt/aktualisiert`.
### link — connect
1. **Projects**: in each linked `../projects/<x>.md`, check the person appears in the team or DRI field; add if missing.
2. **Decisions**: link `../decisions/<x>.md` where the person signed off.
3. **Department**: add to the member list in `../organization/<abteilung>.md` where one exists.
### refresh — maintain
1. **Triggers**: `stale_after` reached, project end, role change, new certification, quarterly review.
2. The colleague updates skill levels and `generated.at`.
3. The manager re-verifies: new entry in `verified`.
4. Move `stale_after` to today + 180 days.
5. Update `log.md`.
### dsar — data-subject rights
Auskunft (Art. 15), Berichtigung (Art. 16), Löschung (Art. 17) etc.: follow the DSAR workflow in [references/gdpr-de.md](references/gdpr-de.md). Erasure rewrites git history (`git filter-repo`, force push): present the exact commands and run them only after the user's explicit go.
### offboard — colleague leaves
1. Set `stale_after` to exit date + 6 months (retention limit of the privacy notice).
2. Remove the person from team/DRI fields in active `../projects/` (history entries stay) and note the exit date in the profile's identity section.
3. Add to `log.md`.
4. When `stale_after` is reached: delete the profile and its links per the erasure workflow in *dsar*.
## Field catalogue (full profile)
Template with all fields: [assets/person-template.md](assets/person-template.md).
| Block | Fields | Required? |
|---|---|---|
| **Frontmatter** | `type: Person`, `title`, `description`, `tags`, `status`, `generated`, `verified`, `stale_after`, `consent` | type/status/generated/consent yes |
| **Identity** | title/role, e-mail, Basecamp-Person-ID, Zammad-Login, manager, department, location, timezone, tenure | yes |
| **Background** | career, certifications | yes (may be "k.A.") |
| **Skills matrix** | technical, domain, soft skills, each level 0–5 | yes (at least 3 skills) |
| **T-shape** | depth (specialist), breadth (generalist) | recommended |
| **Team profile** | Belbin (primary/secondary), CliftonStrengths top 5, working-style notes | optional |
| **Current capacity** | availability %, active projects, engagement preference | yes |
| **Growth plan** | skills to develop, roles of interest, mentoring | yes |
| **Project history** | excerpt, with links | recommended |
| **Sources / evidence** | footnotes for specific claims | for assessment claims |
## Frameworks
| Framework | Required? | When | Reference |
|---|---|---|---|
| **Skills matrix 0–5** | yes | always, core of every profile | [references/framework-skills-matrix.md](references/framework-skills-matrix.md) |
| **Belbin (9 roles)** | optional | team size 4+, when staffing is due | [references/framework-belbin.md](references/framework-belbin.md) |
| **CliftonStrengths** | optional | only if the colleague took the Gallup test | [references/framework-cliftonstrengths.md](references/framework-cliftonstrengths.md) |
| **T-shape** | recommended | specialist vs generalist | [references/framework-t-shape.md](references/framework-t-shape.md) |
## GDPR duties (short form)
Full legal basis and templates: [references/gdpr-de.md](references/gdpr-de.md). Hard rules:
1. **Legal basis**: § 26 Abs. 1 BDSG + Art. 6 Abs. 1b DSGVO. No consent needed for job-relevant data.
2. **Data minimisation**: job-relevant fields only. Private life, family, hobbies, union membership → forbidden without voluntary consent.
3. **Never**: performance ratings, 9-box, potential assessments, salary, disciplinary measures, health/sick-leave data. These never go into a profile of this skill.
4. **Privacy notice** before any full profile (date in `consent.notice_given_at`). Minimal stubs hold master data only and need none.
5. **Staleness**: `stale_after` required on full profiles; review or deletion after 180 days at the latest.
6. **Private repo only.** Never push to a public remote.
7. **No AI scores** from non-job data (social scoring, Art. 5 KI-VO).
## Own competence catalogues (non-IT departments)
IT example: [references/competence-catalog-it.md](references/competence-catalog-it.md). For sales, HR, production, finance etc.:
1. Define **3–7 competence families**.
2. Name **3–10 concrete skills** per family.
3. Write **level-3 anchors** ("kann selbstständig …").
4. Write **level-5 anchors** ("setzt Standards, coacht andere").
Template and examples: [references/competence-catalog-template.md](references/competence-catalog-template.md).
## Validate & finish
1. Run OKF validation via the `validate` skill on `/home/sascha.koenig/p/PM/.okf` (strict). Fix every `ERROR` (§11); `WARN` is soft.
2. Parse the frontmatter: `python3 -c "import yaml; yaml.safe_load(open('FILE.md').read().split('---')[1])"`.
3. Check the identity lines match the cockpit form above.
4. Commit only when the user asks: `generated.by` set, message `add: person profile <slug>`, private repo only.
## References
| File | When |
|---|---|
| [references/framework-skills-matrix.md](references/framework-skills-matrix.md) | before any skill rating; when unsure about a level |
| [references/framework-belbin.md](references/framework-belbin.md) | team-role profiling |
| [references/framework-cliftonstrengths.md](references/framework-cliftonstrengths.md) | colleague presents CliftonStrengths results |
| [references/framework-t-shape.md](references/framework-t-shape.md) | specialist-vs-generalist career planning |
| [references/gdpr-de.md](references/gdpr-de.md) | before every full profile; DSAR; yearly LIA review |
| [references/competence-catalog-it.md](references/competence-catalog-it.md) | IT profiles |
| [references/competence-catalog-template.md](references/competence-catalog-template.md) | non-IT department |
| [references/interview-guide.md](references/interview-guide.md) | before wizard start |
| [references/skill-anchors-cheatsheet.md](references/skill-anchors-cheatsheet.md) | Phase 4 anchors |
| [assets/person-template.md](assets/person-template.md) | create / upgrade |
| [assets/stub-template.md](assets/stub-template.md) | stub |
| [scripts/auto-enrich.sh](scripts/auto-enrich.sh) | wizard Phase 1 |
@@ -0,0 +1,125 @@
---
type: Person
title: "Vorname Nachname — Rolle"
description: "1-Zeilen-Zusammenfassung für Projektplanung"
tags: [vorname-nachname, abteilung, role]
status: draft
sensitivity: confidential
generated:
by: "process:chiron-agent"
at: "YYYY-MM-DD"
verified: []
stale_after: "YYYY-MM-DD"
consent:
basis: "§26 Abs. 1 BDSG"
notice_given_at: "YYYY-MM-DD"
---
<!-- VERWENDUNG (diesen Block nach dem Ausfüllen löschen):
1. Kopiere diese Datei nach /home/sascha.koenig/p/PM/.okf/organization/<vorname>-<nachname>.md
2. Ersetze alle Platzhalter (YYYY, ..., "k.A.")
3. Frontmatter: generated.at heute, stale_after = heute + 180 Tage
4. Status bleibt "draft" bis verify-Array gefüllt ist (Phase 2)
5. Ausführliche Anleitung: /home/sascha.koenig/.agents/skills/lead-profile/SKILL.md
RECHTLICH (DSGVO):
- Vor Anlage Privacy Notice mitteilen (references/gdpr-de.md)
- Datum der Mitteilung eintragen in consent.notice_given_at
- KEINE Performance-Ratings, KEINE Privatdaten — siehe GDPR-Pflichten in SKILL.md
KENNUNGEN: Basecamp-Person-ID und Zammad-Login exakt in der Form
**Basecamp-Person-ID**: `123` / **Zammad-Login**: `x` lassen (Cockpit parst sie).
-->
# Vorname Nachname
## Identität
- **Titel / Rolle**: z. B. IT-Spezialist, Sales Manager, HR Business Partner
- **E-Mail**: vorname.nachname@azintec.com
- **Basecamp-Person-ID**: `12345678`
- **Zammad-Login**: `vorname.nachname@azintec.com` (oder: offen)
- **Vorgesetzter**: [Name](../organization/<vorgesetzter-slug>.md)
- **Abteilung**: [Abteilung](../organization/<abteilung>.md)
- **Standort**: z. B. DE-Hof, CZ-Pilsen
- **Zeitzone**: CET/CEST
- **Tenure (seit)**: YYYY-MM
## Hintergrund
- **Ausbildung / Studium**: z. B. Fachinformatiker Systemintegration (2018-2021)
- **Bisherige Stationen**: kurz, aber repräsentativ
- **Zertifikate**: berufliche, mit Jahr (z. B. „Linux Foundation Certified Engineer, 2024")
## Skills-Matrix
Ausführliche Level-Definitionen: `~/.agents/skills/lead-profile/references/framework-skills-matrix.md`
Beispiel-Katalog IT: `~/.agents/skills/lead-profile/references/competence-catalog-it.md`
### Technical
| Skill | Level (0–5) | Zuletzt assessiert | Quelle | Beleg |
|---|---|---|---|---|
| Beispiel: Sage100 | 3 | 2026-08 | project | [DVL-Redesign](../projects/dvl-prozess-neugestaltung.md) |
| Beispiel: Linux/NixOS | 1 | 2026-08 | self | — |
### Domain (Fachwissen)
| Bereich | Level | Beleg |
|---|---|---|
| Beispiel: Intrastat-Meldepflichten | 4 | DVL-Prozess dokumentiert |
### Soft Skills
| Skill | Level | Beleg |
|---|---|---|
| Beispiel: Stakeholder-Kommunikation | 3 | moderiert Bossi-Meetings |
## T-Shape
Siehe `~/.agents/skills/lead-profile/references/framework-t-shape.md`.
- **Depth** (Specialist, Level ≥3):
- Beispiel: Sage100 / Intrastat — Level 4
- **Breadth** (Generalist, Level 1–3):
- Beispiel: Linux-Basics — Level 2
- Beispiel: Excel / Datenanalyse — Level 3
## Team-Profil
Siehe `~/.agents/skills/lead-profile/references/framework-belbin.md` und `framework-cliftonstrengths.md`.
- **Belbin primär**: z. B. Implementer (nur wenn Test oder klare Selbstauskunft)
- **Belbin sekundär**: z. B. Completer Finisher
- **Belbin-Assessment-Quelle**: self / observer / official-test / unknown
- **CliftonStrengths Top 5**: nur wenn Gallup-Test vorliegt, sonst Feld löschen
- **CliftonStrengths-Domäne dominant**: z. B. Executing + Strategic Thinking
- **Arbeitsstil-Notizen**: z. B. „morgens produktiver; bevorzugt schriftliche Updates; arbeitet gerne fokussiert an einem Projekt"
## Aktuelle Kapazität
- **Verfügbarkeit**: X% (restliche Zeit reserviert für [Grund])
- **Aktuelle Projekte**:
- [Projektname](../projects/<projekt-slug>.md) — Rolle — X% Allocation — bis YYYY-MM
- **Bevorzugte Engagement-Art**: embedded / consultant / advisory / lead
- **Arbeitszeiten**: z. B. Mo-Fr 08:00–17:00, freitags home office
## Wachstumsplan
- **Skills zu entwickeln**: z. B. Linux, Docker, Projektmanagement
- **Rollen von Interesse**: z. B. Project Lead, Architect
- **Offen für Mentoring**: ja/nein (als Mentor oder Mentee)
## Projekt-Historie (auszugsweise)
- [Projekt](../projects/<slug>.md) — Beitrag — Zeitraum
- [Projekt](../projects/<slug>.md) — Beitrag — Zeitraum
## Quellen / Belege
Spezifische Behauptungen mit Footnote belegen. Label muss mit `sources[].id` im Frontmatter matchen (falls Frontmatter um Sources erweitert wurde).
[^dvl-meeting]: Bossi-Meeting 30.07.2026, Quelle: Basecamp-Todo-URL
## Verwandte Konzepte
- [Abteilung](../organization/<abteilung>.md)
- [Aktive Projekte](../projects/<slug>.md)
- [Relevante Entscheidungen](../decisions/<slug>.md)
@@ -0,0 +1,47 @@
---
type: Person
title: "Vorname Nachname — Abteilung, Rolle"
description: "Abteilung. Rolle in einem Satz. Minimal-Stub."
tags: [vorname-nachname, abteilung, minimal-stub]
status: draft
sensitivity: internal
generated:
by: "<harness>/<model>"
at: "YYYY-MM-DD"
consent:
basis: "§26 Abs. 1 BDSG"
notice_given_at: null
scope: stammdaten
sources:
- id: bc-person-record
title: "Basecamp-Personenliste, abgefragt DD.MM.YYYY"
resource: "basecamp people list --in <projekt-id>"
---
<!-- MINIMAL-STUB (diesen Block nach dem Ausfüllen löschen):
Nur Organisations-Stammdaten: Name, Rolle, E-Mail, Kennungen, Vorgesetzter, Abteilung.
Keine Skills, Kapazität, Team-Profil, Wachstumsplan, Hintergrund — die erst nach
Privacy Notice über das Upgrade zum Vollprofil (siehe lead-profile SKILL.md).
Kennungen exakt in der Form **Basecamp-Person-ID**: `123` / **Zammad-Login**: `x`
lassen (Cockpit parst sie). Zammad-Login unbekannt → „offen" ohne Backticks.
-->
# Vorname Nachname
> **Minimal-Stub.** Enthält nur Organisations-Stammdaten (Name, Rolle, Kennungen). Skills, Kapazität, Team-Profil und Wachstumsplan erst nach Datenschutz-Information (`consent.notice_given_at`), angelegt über `lead-profile`.
## Identität
- **Name**: Vorname Nachname
- **Rolle**: z. B. IT-Spezialist
- **E-Mail**: vorname.nachname@azintec.com[^bc-person-record]
- **Basecamp-Person-ID**: `12345678`[^bc-person-record]
- **Zammad-Login**: `vorname.nachname@azintec.com`
- **Vorgesetzter**: [Name](/organization/<vorgesetzter-slug>.md)
- **Abteilung**: [Abteilung](/organization/<abteilung>.md)
## Related
- [Relevantes Konzept](/processes/<slug>.md)
[^bc-person-record]: Basecamp-Personenliste, DD.MM.YYYY.
@@ -0,0 +1,147 @@
# IT-Kompetenzkatalog (AZ-Gruppe Beispiel)
Konkreter Katalog für IT-Teams. Andere Abteilungen (Sales, Vertrieb, HR, Produktion, Finance) → [competence-catalog-template.md](competence-catalog-template.md).
Jeder Skill hat:
- **Konkrete Beschreibung** (eine Zeile)
- **Level-3-Anker** (was muss jemand selbstständig können, um Level 3 zu haben)
- **Level-5-Anker** (was macht einen SME aus)
## 1. ERP / Domain
### Sage100 (Sage KHK)
- **Beschreibung**: ERP-System für Buchhaltung, Artikelstamm, Intrastat, Aufträge
- **L3**: konfiguriert selbstständig SAN-Validierungsregeln; pflegt Artikelstämme; prüft Intrastat-Meldungen; kennt Geschäftsart-999-Logik
- **L5**: entscheidet über Sage100-Migrationsstrategie (Strangler-Fig); kennt Customizing besser als externe Consultants
### PIM / CRM-Systeme
- **Beschreibung**: Product Information Management (zukünftig), Raynet CRM
- **L3**: kann Produktstämme erfassen und synchronisieren; kennt Datenmodell
- **L5**: baut eigene PIM-Workflows; integriert Dritt-Systeme via API
### Intrastat-Meldepflichten
- **Beschreibung**: Statistische Meldungen an Destatis für innergemeinschaftliche Lieferungen
- **L3**: versteht Meldepflichten, kann korrekte Meldungen erzeugen, löst Einzelfälle
- **L5**: entwickelt interne Prozesse neu; verhandelt mit Destatis bei Spezialfällen
### DVL (Direktlieferungen)
- **Beschreibung**: CZ→Kunde Direktlieferungen, müssen aus Intrastat gefiltert werden
- **L3**: kennt Prozess, kann Buchungen korrekt taggen
- **L5**: redesign den Prozess (z. B. via Sage Geschäftsart 999); schult IT und Finance
## 2. Infrastructure / Betriebssysteme
### Windows Server / Terminal Server
- **Beschreibung**: Bestehende Windows-Infrastruktur (Terminal Server für Sage100-Clients)
- **L3**: verwaltet TS-Sessions, AD-Benutzer, GPOs
- **L5**: baut Migrationspfade zu Linux/NixOS; konsolidiert Windows-Footprint
### Linux (insbesondere NixOS)
- **Beschreibung**: Linux-Admin, Fokus NixOS als deklaratives System
- **L3**: schreibt NixOS-Module; debugt Services; kennt systemd-Unit-Grundlagen
- **L5**: baut eigene NixOS-Hosts von Grund auf; hält Module-Code-Reviews; entscheidet über Hosting-Architektur
### Docker / Podman
- **Beschreibung**: Container-Engine für Applikationen
- **L3**: schreibt Dockerfile/Podman-Container; debugt Container; kennt Volume-Management
- **L5**: baut Multi-Stage-Builds; kennt Security-Implications (Rootless, SELinux); entscheidet über Container-Strategie
### Traefik / Reverse Proxy
- **Beschreibung**: Traefik als TLS-Termination und Routing
- **L3**: konfiguriert Routers und Services; kennt Let's Encrypt-Integration
- **L5**: baut eigene Middlewares; troubleshootet im Produktiv-Betrieb
### Kubernetes (Ziel)
- **Beschreibung**: Container-Orchestrierung (aktuell Evaluierung, noch nicht produktiv)
- **L3**: deployed Apps via Helm; debugt Pods
- **L5**: entscheidet über K8s-vs-NixOS-Cluster-Strategie; baut Multi-Node-Cluster
## 3. Programmierung
### Go
- **L3**: schreibt Idiomatic Go; kennt Module-System; schreibt Tests
- **L5**: baut Production-Grade-Services mit Observability
### Rust
- **L3**: kennt Borrow-Checker, schreibt Idiomatic Rust, kennt Cargo
- **L5**: baut komplexe Async-Systeme; entscheidet über Crate-Architektur
### Python
- **L3**: schreibt Idiomatic Python 3; kennt pytest, typing
- **L5**: baut Production-Systeme mit CI/CD; kennt Performance-Optimierung
### Bash / Shell
- **L3**: schreibt produktive Bash-Scripts mit error handling; kennt coreutils
- **L5**: baut Shell-Tooling als komplette CLIs (mit argument parsing, subcommands)
### SQL (PostgreSQL)
- **L3**: schreibt Joins, Aggregate, kennt Explain-Analyze; debugt langsame Queries
- **L5**: baut Schema-Designs, kennt Indexing-Strategien, migriert große Datenmengen
## 4. Automation / DevOps
### Infrastructure-as-Code (Nix)
- **L3**: schreibt deklarative NixOS-Module; kennt Nix-Flakes
- **L5**: baut eigene Nixpkgs-Packages; orchestriert Multi-Host-Setups
### CI/CD (GitHub Actions, GitLab CI)
- **L3**: schreibt Workflows/Pipelines; kennt Caching
- **L5**: baut Self-Hosted-Runner-Setup; entscheidet über Pipeline-Architektur
### Monitoring (Prometheus, Grafana)
- **L3**: schreibt Exporter; baut Dashboards; kennt PromQL-Basics
- **L5**: baut Alert-Strategie; integriert Distributed-Tracing
### n8n / Workflow-Automation
- **L3**: baut Workflows; kennt Webhook-Integration
- **L5**: baut komplexe Multi-Step-Workflows mit Error-Handling und Retry-Logik
## 5. Security / Compliance
### NIS2
- **Beschreibung**: EU-Richtlinie für Cybersicherheit bei kritischen Infrastrukturen
- **L3**: kennt Anforderungen; kann Maßnahmen umsetzen (RBAC, Logging, Incident-Response)
- **L5**: baut Compliance-Programm; verhandelt mit Behörden
### DSGVO
- **L3**: kennt Prinzipien; kann Datenschutz-Folgenabschätzung schreiben
- **L5**: verhandelt mit Aufsichtsbehörden; baut Compliance-Framework
### Backup / Disaster Recovery
- **L3**: konfiguriert Backups (z. B. restic, borg); kennt Restore-Prozesse
- **L5**: baut Multi-Site-DR-Strategien; testet RTO/RPO
## 6. Soft Skills / Methoden
### Projektmanagement
- **L3**: führt kleine Projekte (3-5 Personen); schreibt klare Briefings
- **L5**: leitet Programme (Multi-Projekt); kennt Portfolio-Management
### Dokumentation
- **L3**: schreibt verständliche Runbooks; kennt audience-aware Stil
- **L5**: baut Wissensmanagement-Systeme (OKF, Handbooks)
### Wissensvermittlung (Mentoring)
- **L3**: onboarding neuer Kollegen; erklärt Konzepte verständlich
- **L5**: baut strukturierte Trainings-Programme; wirkt an Career-Ladder-Mentoring mit
### Stakeholder-Management
- **L3**: moderiert Meetings mit nicht-IT-Stakeholdern; übersetzt Fachsprache
- **L5**: verhandelt mit C-Level; baut Stakeholder-Maps
## Anwendung
Beim Ausfüllen des Profils:
1. **Nicht alles ausfüllen.** Starte mit den 5 Kern-Skills der Person.
2. **Beleg für Level ≥3.** Z. B. „Sage100 L4: DVL-Redesign geleitet (Ticket #12345)".
3. **Wachstumsplan** aus breadth-Feldern ableiten, die zu depth entwickelt werden sollen.
## Quellen / Belege-Vorlagen
- Ticket-Referenzen: `[Basecamp-Todo #12345](https://3.basecamp.com/.../todos/12345)`
- PRs/Merges: `[PR #42](https://code.m3ta.dev/.../pulls/42)`
- Zertifikate: „Linux Foundation Certified Engineer, 2024"
- Meeting-Notizen: „Bossi-Meeting 30.07.2026 (Basecamp-URL)"
Siehe auch: [framework-skills-matrix.md](framework-skills-matrix.md) für die Level-Semantik.
@@ -0,0 +1,116 @@
# Kompetenzkatalog-Vorlage (für nicht-IT-Abteilungen)
Vorlage für Abteilungsleiter außerhalb IT, die die Profil-Pflege nach `lead-profile` übernehmen wollen. IT-Beispiel: [competence-catalog-it.md](competence-catalog-it.md).
## Schema
Jeder Katalog-Eintrag folgt diesem Format:
```markdown
### Skill-Name
- **Beschreibung**: 1-Zeilen-Erklärung, was der Skill umfasst
- **L3-Anker**: was jemand selbstständig können muss (konkret, verhaltens-basiert)
- **L5-Anker**: was einen SME/Strategic Owner ausmacht
```
⚠️ Verhaltensanker **müssen konkret** sein. Schlecht: „kennt sich aus mit Salesforce". Gut: „konfiguriert selbstständig Workflows, kennt Datenmodell, migriert Custom Fields ohne Produktions-Ausfall".
## 4 Schritte zum eigenen Katalog
### Schritt 1 — Kompetenz-Familien definieren (3–7 Stück)
Fragen zur Identifikation:
- Welche **Wertschöpfungs-Prozesse** hat die Abteilung? (z. B. Sales: Akquise, Closing, Account-Management)
- Welche **Systeme/Tools** werden intensiv genutzt? (z. B. Salesforce, SAP, Excel)
- Welche **rechtlichen/regulatorischen** Anforderungen bestehen? (z. B. HGB, HCC, Arbeitsrecht)
- Welche **Methoden** werden angewendet? (z. B. Scrum, Kanban, Marktforschung)
Pro Familie 3–10 konkrete Skills definieren.
### Schritt 2 — Skills pro Familie benennen
| Familie | Skills (Beispiele) |
|---|---|
| **Akquise** | Kaltakquise, LinkedIn-Outreach, Networking-Events, Referral-Generierung |
| **Verhandlung** | Preisverhandlung, Vertragsdesign, Mehrweg-Verhandlung, Eskalation |
| **Account-Mgmt** | Key-Account-Planung, QBR-Vorbereitung, Upselling, Churn-Prävention |
### Schritt 3 — Level-3-Verhaltensanker
Pro Skill eine konkrete Handlung, die jemand **selbstständig, ohne Aufsicht** ausführen muss:
```markdown
### Salesforce (CRM)
- **L3**: konfiguriert Opportunities, kennt Custom Fields, baut Standard-Reports,
arbeitet mit Approval-Prozessen. Führt selbstständig Datenbereinigungen durch.
- **L5**: baut eigene Salesforce-Apx-Trigger; integriert Drittsysteme via API;
schult das Team im Rollout neuer Features.
```
### Schritt 4 — Level-5-Verhaltensanker
Pro Skill die SME-Qualitäten:
- Coacht andere auf Level 3
- Entscheidet über Tool/Prozess/Standard
- Vertritt die Abteilung in Cross-Functional-Gremien
## Beispiel-Kataloge (Skizzen)
### Sales
- **CRM-Systeme**: Salesforce / HubSpot / Raynet
- **Verhandlung**: Preisverhandlung, Vertragsrecht, Mengenrabatt-Strategien
- **Pipeline-Management**: Forecasting, Win/Loss-Analyse, Stagnation-Intervention
- **Kommunikation**: Kaltakquise, Präsentation, Briefing, QBR
- **Recht**: HGB, AGB, Exportkontrolle, Incoterms
- **Daten**: Excel-Fortgeschritten, PowerBI, Vertrieb-Kennzahlen
### Vertrieb / Operations
- **Prozess**: Auftragsabwicklung, Retouren-Management, Beschwerden
- **Logistik**: Incoterms, Frachtorganisation, Zoll
- **Systeme**: SAP SD, Sage Vertrieb, WMS
- **Kunden**: Key-Account-Pflege, Beschwerde-Management, Ausbildung von Kunden
- **Compliance**: Exportkontrolle, Embargo-Prüfung
### HR / Personal
- **Arbeitsrecht**: Kündigungsschutz, Befristungen, Arbeitszeitgesetz
- **Recruiting**: Sourcing, Interview-Führung, Einstellung
- **Payroll**: Entgeltabrechnung, Sozialversicherung, Steuer
- **Entwicklung**: Karrierepfade, Trainings-Bedarf, Mentoring-Programme
- **Betriebsrat**: Mitbestimmung, Betriebsvereinbarungen, Anhörungsverfahren
### Produktion / Fertigung
- **Sage-PP**: Produktionsplanung, Stücklisten, Arbeitspläne
- **Materialwirtschaft**: Bestandsführung, Disposition, Lieferanten-Management
- **Lean**: 5S, KVP, Wertstromanalyse, Kanban
- **Qualität**: QM-Systeme (ISO 9001), Reklamations-Management
- **Maschinen**: CNC-Programmierung, Instandhaltung, Rüstoptimierung
### Finance / Controlling
- **Buchhaltung**: Sage100 FiCo, DATEV, HGB-Bilanzierung
- **Controlling**: Plan-/Ist-Vergleich, Abweichungsanalyse, Forecast
- **Reporting**: Management-Reporting, KPI-Definition, Dashboards
- **Steuer**: USt-Voranmeldung, ZM, Jahresabschluss
- **Zahlungsverkehr**: SEPA, Zahlungsanbindungen, Kreditoren-Management
## Warnungen
1. **Zu viele Skills** (> 10 pro Familie) → Bewertungs-Erschöpfung. Lieber 5 schlanke.
2. **Zu wenige** (< 3 pro Familie) → Differenzierung geht verloren.
3. **Vage Anker** → Rating Drift. Jeder Level-3-Anker muss mit „kann selbstständig…" beginnen.
4. **Mixing with Performance-Ratings** → verboten (siehe [gdpr-de.md](gdpr-de.md)). Kompetenz-Bewertung ist NICHT Leistungsbeurteilung.
## Wartung des Katalogs
- **Quartals-Review**: neue Tools aufnehmen, obsolete streichen.
- **Kollegen-Feedback einholen**: welche Skills fehlen? Welche Anker sind unrealistisch?
- **Versionierung**: Katalog-Version in Profile-Frontmatter referenzieren, damit Bewertungen vergleichbar bleiben.
## Quellen
- Personio — Skills Matrix Guide
- Sprad — Engineering Skills Matrix Templates
- CircleCI — 7 Steps to Building a Competency Matrix
- GitLab Engineering Career Matrix Handbook
Siehe auch: [framework-skills-matrix.md](framework-skills-matrix.md) für die 0–5 Skala.
@@ -0,0 +1,69 @@
# Belbin Team Roles Framework
Quelle: Dr. Meredith Belbin (Henley Management College). Neun Verhaltens-Cluster für Team-Composition und Projektstaffing.
## Die 9 Rollen
| Rolle | Familie | Stärke | Erlaubte Schwäche | Projektphase wo stark |
|---|---|---|---|---|
| **Plant (PL)** | Thinking | Kreativ, ideenreich, löst schwierige Probleme | Ignoriert Details; schwer zu kommunizieren | Initiierung, Konzeption |
| **Monitor Evaluator (ME)** | Thinking | Nüchtern, strategisch, gute Urteilskraft | Antriebslos; überkritisch | Entscheidungs-Review |
| **Specialist (SP)** | Thinking | Tiefes Fachwissen, selbst-startend | Schmaler Fokus; an den Detail hängend | Fachliche Tiefe |
| **Co-ordinator (CO)** | People | Reif, selbstbewusst; delegiert; identifiziert Talente | Kann manipulativ wirken; schiebt eigene Arbeit ab | Steuerung/Governance |
| **Teamworker (TW)** | People | Kooperativ, diplomatisch; verhindert Reibung | Unentschlossen in Crunch-Momenten | Konfliktphasen |
| **Resource Investigator (RI)** | People | Extrovertiert, enthusiastisch; knüpft Kontakte | Überoptimistisch; verliert Interesse | Externe Recherche, Stakeholder |
| **Shaper (SH)** | Action | Dynamisch, herausfordernd; treibt voran | Provokativ; verletzt Gefühle | Umsetzung unter Druck |
| **Implementer (IMP)** | Action | Praktisch, zuverlässig; wandelt Ideen in Aktion | Inflexibel; langsam bei Neuem | Operative Umsetzung |
| **Completer Finisher (CF)** | Action | Gewissenhaft; findet Fehler; perfektioniert | Neigt zu Sorge; delegiert ungern | QA, Go-Live |
## Wann welche Rollen gebraucht werden
| Phase | Starke Rollen gebraucht |
|---|---|
| **Initiierung** (Projektidee, Konzept) | Plant, Resource Investigator |
| **Definition** (Anforderungen, Design) | Monitor Evaluator, Specialist |
| **Governance** (Steering, Lenkung) | Co-ordinator |
| **Umsetzung** (Bauen, Konfigurieren) | Shaper, Implementer |
| **Abschluss** (QA, Rollout) | Completer Finisher, Teamworker |
## Balancing-Prinzip
> „A good performance of a team is connected with balanced team in terms of team roles among the members." — Belbin
- **Ideale Teamgröße**: 4–6 Personen.
- Meist hat jede Person **2–3 bevorzugte Rollen** (kann sich über Zeit ändern).
- **Nicht jede Rolle ist immer nötig** — nach Phase auswählen.
- Eine Person kann eine sekundäre Rolle übernehmen, wenn die primäre nicht gebraucht wird.
## Anwendung für Projektstaffing
1. **Projekt-Anforderungen** definieren: welche Phasen kommen, welche Rollen brauche ich pro Phase?
2. **Bestand prüfen**: welche Belbin-Rollen haben die Kandidaten bereits im Profil?
3. **Gap-Analyse**: fehlen Rollen? → Person mit sekundärer Rolle bitten, oder extern holen.
4. **Konflikte vermeiden**: zwei starke Shaper im Team → Spannung; zwei Plants → konkurrierende Ideen.
## Wichtige Hinweise
- Belbin ist **kein Persönlichkeitstest** (wie MBTI), sondern ein Verhaltens-Präferenz-Modell am Arbeitsplatz.
- **Self-Perception Inventory (SPI)** ist der offizielle Test (8 Sektionen, je 10 Items, kostenpflichtig). Ohne formellen Test ist die Selbstauskunft eine Annäherung.
- **Observer Assessment** (Fremdeinschätzung durch Kollegen) erhöht die Verlässlichkeit deutlich.
- Belbin nicht mit DISC oder MBTI vermischen — das verwirrt.
## Im Profil abbilden
```yaml
team_profil:
belbin_primary: Implementer # aus Test oder Selbstauskunft
belbin_secondary: Completer Finisher
belbin_assessment_source: self # self / observer / official-test
belbin_assessed_at: 2026-08-03
```
## Quellen
- Belbin.com — The Team Role Company
- Bushuyev et al. (2026) — Using Belbin's Model for Designing Project Teams (DOI 10.56889/yqcj7546)
- Lubchenko & Sulimova (2017) — Transitions between team roles in software development
- Mindtools — Belbin Team Roles
Siehe auch: [framework-cliftonstrengths.md](framework-cliftonstrengths.md) für alternative Rollen-Taxonomie.
@@ -0,0 +1,97 @@
# CliftonStrengths (Gallup) Framework
Quelle: Gallup Inc., ehemals „StrengthsFinder". 34 Talent-Themes in 4 Domains. Basiert auf dem Ansatz: **Stärken-basierte Entwicklung** statt Schwächen-Fokus.
## Die 4 Domains
| Domain | Frage beantwortet | Beispiel-Themes |
|---|---|---|
| **Executing** | Wie macht die Person Dinge? | Achiever, Arranger, Belief, Consistency, Deliberative, Discipline, Focus, Responsibility, Restorative |
| **Influencing** | Wie übernimmt die Person Verantwortung und spricht an? | Activator, Command, Communication, Competition, Maximizer, Self-Assurance, Significance, Woo |
| **Relationship Building** | Wie baut und pflegt die Person Beziehungen? | Adaptability, Connectedness, Developer, Empathy, Harmony, Includer, Individualization, Positivity, Relator |
| **Strategic Thinking** | Wie nimmt die Person Informationen auf und analysiert sie? | Analytical, Context, Futuristic, Ideation, Input, Intellection, Learner, Strategic |
## Die 34 Themes (Kurzbeschreibung)
| Theme | Domain | Kern |
|---|---|---|
| Achiever | Executing | Hoher Energie-Antrieb; will jeden Tag etwas fertigbringen |
| Arranger | Executing | Liebt Komplexität; orchestriert Ressourcen |
| Belief | Executing | Wertegesteuert; tief verankerte Kernüberzeugungen |
| Consistency | Executing | Setzt Regeln gleich für alle durch; fair |
| Deliberative | Executing | Sorgfältig;识别und managt Risiken |
| Discipline | Executing | Liebt Routinen, Struktur, Planbarkeit |
| Focus | Executing | Setzt Prioritäten; lässt sich nicht ablenken |
| Responsibility | Executing | Übernimmt Ownership psychologisch |
| Restorative | Executing | Liebt es, Probleme zu lösen |
| Activator | Influencing | Machen sofort; ungeduldig mit Analyse |
| Command | Influencing | Übernimmt Kontrolle in Krise; trifft harte Entscheidungen |
| Communication | Influencing | Gute Storyteller; macht Dinge greifbar |
| Competition | Influencing | Misst sich an anderen; will gewinnen |
| Maximizer | Influencing | Aus gut herausragend machen |
| Self-Assurance | Influencing | Starkes Vertrauen in eigene Fähigkeiten |
| Significance | Influencing | Will Bedeutung haben; wirkt wichtig |
| Woo | Influencing | Gewinnt Menschen; liebt Erstkontakt |
| Adaptability | Relationship | Lebt im Moment; flexibel |
| Connectedness | Relationship | Glaubt an Zusammenhänge; alles ist verbunden |
| Developer | Relationship | Erkennt und fördert Potential in anderen |
| Empathy | Relationship | Spürt was andere fühlen |
| Harmony | Relationship | Sucht Konsens; vermeidet Konflikt |
| Includer | Relationship | Will niemanden ausschließen |
| Individualization | Relationship | Sieht jeden als einzigartig |
| Positivity | Relationship | Enthusiastisch; bringt Energie |
| Relator | Relationship | Tiefe enge Beziehungen zu wenigen |
| Analytical | Strategic | Sucht Daten und Beweise |
| Context | Strategic | Lernt aus der Vergangenheit |
| Futuristic | Strategic | Inspirierte durch Zukunftsvision |
| Ideation | Strategic | Generiert neue Ideen; verbindet Konzepte |
| Input | Strategic | Sammelt Information, Gegenstände |
| Intellection | Strategic | Denkt gerne nach; liebt Diskussion |
| Learner | Strategic | Liebt den Lernprozess selbst |
| Strategic | Strategic | Sieht Muster; findet Alternativen |
## Wichtigste Gallup-Erkenntnis
> *„Strengths awareness had twice the influence on a team's performance than the composition of a team's strengths. In other words, it's not which strengths a team has but rather how well teammates know each other's strengths."* — Gallup, 11.441 Teams Studie
**Implikation**: Das Profil ist nicht das Ziel — das **Gespräch über das Profil** ist das Ziel. Teams sollen sich gegenseitig ihre Stärken mitteilen.
## Wie Top-5 ermitteln
CliftonStrengths ist **kostenpflichtig** (~25 USD für Standard-Test, ~60 USD für Top-5 + alle 34):
1. Test unter gallupstrengthscenter.com machen (ca. 30 Minuten, 177 Fragen).
2. Top-5-Themes erhalten + Entwicklungs-Report.
3. Im Profil eintragen.
**Kein Test → keine CliftonStrengths-Daten im Profil**. Freitext-Raten ist nicht zuverlässig und sollte vermieden werden.
## Im Profil abbilden (nur wenn Test vorliegt)
```yaml
team_profil:
cliftonstrengths_top5: [Strategic, Learner, Achiever, Ideation, Input]
cliftonstrengths_domains_dominant: [Strategic Thinking, Executing]
cliftonstrengths_assessed_at: 2026-06-15
cliftonstrengths_report_path: optional/link/zum/report.pdf # oder weglassen
```
## Anwendung für Team-Composition
1. **Team Grid** (Gallup-Tool): alle Top-5 der Teammitglieder in einer Matrix → welche Domains sind über-/unterrepräsentiert?
2. **Pairing**: gleiche Stärken → Konkurrenz; komplementäre Stärken → Synergie.
3. **Aufgaben-Matching**: Executing-Dominant für Umsetzungs-Projekte; Strategic für Strategie-Arbeit.
## Kontra-Indikationen
- CliftonStrengths **nicht** für Performance-Beurteilung verwenden.
- **Nicht** als alleiniges Hiring-Kriterium.
- Ergebnisse sind **Privatsache** des Kollegen — Veröffentlichung im Profil ist freiwillig.
## Quellen
- Gallup CliftonStrengths offizielle Website
- Gallup Research: „Best Teams People Know What Makes Person Unique"
- Gallup Team Grid Tool
Siehe auch: [framework-belbin.md](framework-belbin.md) für verhaltens-basierte Rollen-Taxonomie.
@@ -0,0 +1,90 @@
# Skills-Matrix 0–5 Framework
Quelle: Upleashed 0–5-Methodik (skillsmatrixtemplate.com), übernommen von GitLab, CircleCI, Sprad. Standard-Skala der reife Kompetenz-Frameworks.
## Die 0–5-Skala
| Level | Label | Bedeutung | Bewährungsprobe |
|---|---|---|---|
| **0** | Nicht gebraucht | Skill für diese Rolle nicht erforderlich | — |
| **1** | In Training | ≤75 % Training absolviert; Qualität noch nicht belegt | Anfängerkurs abgeschlossen |
| **2** | Developing | Kann alleine arbeiten, aber Output muss verifiziert werden | Senior schaut drüber vor Go-Live |
| **3** | Capable | **Standard-Ziel**. Selbstständig, konsistente Qualität. | Arbeitet eigenständig,enger Feedback-Schleife |
| **4** | SME / Trainer | Coacht andere; owned den Skill im Team | Hat mindestens 2 Kollegen auf Level 3 gebracht |
| **5** | Strategic Owner | Setzt Standards, cross-funktional; definiert neue Prozesse | Entscheidet über Tool-Auswahl, Architektur |
**Level 3 ist das Default-Ziel** für einsatzbereite Skills. Wer Level 3 hat, darf ohne Aufsicht ans Projekt.
## Verhaltensanker schreiben
Schlecht: „Level 3 = gut in Sage100". Das ist Rating Drift.
Gut: „Level 3 Sage100 = kann selbstständig Intrastat-Validierungsregeln konfigurieren, Artikelstämme anlegen und Buchungen prüfen. Braucht bei komplexen Customizing-Fragen Support."
Jeder Skill braucht:
- **Konkrete Handlung** („konfiguriert X", „führt Y durch")
- **Selbstständigkeits-Grad** („ohne Aufsicht", „mit Review")
- **Beleg-Kriterium** (welches Ergebnis muss sichtbar sein?)
## Kompetenz-Familien (Standard-7)
Empfohlene Familien für Technical Roles (Personio, Sprad übernommen):
| Familie | Misst |
|---|---|
| **Technical Execution / Craft** | Zuverlässiges Liefern; Navigieren in fremden Codebases/Systemen |
| **Quality & Testing** | Code/System-Qualität, Test-Disziplin, Reviews |
| **System Design & Architecture** | Lösungsstrukturierung für Skalierung und Langlebigkeit |
| **Reliability & On-Call** | Uptime-Ownership, Monitoring, Incident-Response |
| **Product & Delivery Ownership** | Verstehen von User-Bedürfnissen, End-to-End-Lieferung |
| **Collaboration & Communication** | Cross-team, Dokumentation, Konfliktlösung |
| **Leadership & Mentoring** | Coaching, Wissensweitergabe, technische Richtung |
Für nicht-Technical Rollen (Sales, HR, Produktion): adaptiv übersetzen. Vorlage in [competence-catalog-template.md](competence-catalog-template.md).
## Bewertungsmethoden (Assessment Source)
| Quelle | Verlässlichkeit | Wann verwenden? |
|---|---|---|
| **Self-Assessment** | Niedrig (Subject Bias) | Pflicht als Startpunkt — Kollege kennt Eigenwahrnehmung |
| **Manager-Assessment** | Mittel | Verifiziert durch Beobachtung, aber einseitige Perspektive |
| **Peer-Assessment** | Hoch | Bestes Signal — Kollegen sehen die tägliche Arbeit |
| **Certification** | Sehr hoch | Externer Beleg, aber nicht praxisnah |
| **Project Evidence** | Sehr hoch | Konkretes Ergebnis aus Ticket/PR/Merge/Abschluss |
**Empfehlung**: Self + Manager + mind. 1 Beleg (Cert oder Projekt-Evidence) für Level ≥3.
## Kalibrierung gegen Rating Drift
Rating Drift = zwei Bewerter interpretieren Level 3 unterschiedlich. Abhilfe:
1. **Kalibrierungs-Session**: Vorgesetzte vergleichen ihre Bewertungen für dieselbe Person, diskutieren Abweichungen.
2. **Beleg-Pflicht** für Level ≥3: kein Beleg = max. Level 2.
3. **Anker-Beispiele**: ein realer Kollege (anonymisiert) als „das ist Level 3 in Skill X".
4. **Quartals-Refresh**: nach jedem Major-Projekt re-assessen, nicht jährlich.
## Spezifische Beispiele
### Sage100-Validierungsregeln (DVL/Intrastat)
- **L1**: weiß, was Sage100 ist; hat Buchungen gesehen
- **L2**: kann unter Anleitung Artikelstämme pflegen; kennt Intrastat-Basics
- **L3**: **konfiguriert selbstständig SAN-Validierungsregeln; löst DVL-Meldungen auf; arbeitet mit der Geschäftsart-999-Logik**
- **L4**: hat das aktuelle DVL-Redesign gepragt; coacht Kollegen
- **L5**: entscheidet über Sage100-Migrationsstrategie; kennt das System besser als die meisten Sage-Consultants
### Linux/NixOS
- **L1**: kann sich einloggen, Dateien listen
- **L2**: installiert Pakete via apt/nix; kennt Bash-Basics
- **L3**: **konfiguriert NixOS-Module; debugt Services; schreibt eigene systemd-Units**
- **L4**: baut eigene NixOS-Hosts von Grund auf; hält Code-Reviews
- **L5**: entscheidet über Infrastruktur-Architektur (K8s vs NixOS-Cluster)
## Quellen
- skillsmatrixtemplate.com — Upleashed 0–5 Framework
- Sprad Blog — Engineering Skills Matrix Templates
- CircleCI Engineering Competency Matrix
- GitLab Engineering Career Matrix
- Personio Skills Matrix Guide
Siehe auch: [competence-catalog-it.md](competence-catalog-it.md) für vollständigen IT-Katalog.
@@ -0,0 +1,85 @@
# T-Shape Framework
Quelle: IDEO (Tim Brown), übernommen von Valve, McKinsey, Spotify. Visuelles Modell für Specialist-vs-Generalist-Profile.
## Konzept
Ein **T-shaped Professional** hat:
- **Horizontal bar** (Breite): Generalisten-Kompetenz in mehreren Bereichen. Weiß genug, um mit anderen Fachrichtungen zu sprechen, Schnittstellen zu verstehen, in anderen Kontexten zu arbeiten.
- **Vertical bar** (Tiefe): Specialist-Expertise in mindestens einem Bereich. Zählt zu den Besten im eigenen Feld.
```
┌───────────────────┐ ← breadth (horizontal)
│ │ │ │ │ │ 3-5 verwandte Bereiche mit Level 2-3
│ │ │ │ │ │
│ │ │ │ │ │
└───┼───┴───┴───┴───┘
│
│ ← depth (vertical)
│ 1-2 Bereiche mit Level 4-5
│
▼
```
**Anders als ein I-shaped** (nur Specialist, keine Breite) und ein „generalist with no depth" (breit aber flach).
## Warum T-Shape für Projektstaffing
1. **Cross-funktionale Teams**: T-Shapes können across-Disziplinen arbeiten.
2. **Substituierbarkeit**: Bei Ausfall kann jemand mit ähnlicher Breite einspringen (mit Learning Curve).
3. **Karriere-Planung**: eine Person kann von I-Shape (Junior) zu T-Shape (Senior) zu Π-Shape (zwei Spezialgebiete, Staff-Level) wachsen.
## Im Profil abbilden
```yaml
t_shape:
depth: # vertikale Säule
- area: "Sage100 / Intrastat"
level: 4
evidence: "DVL-Redesign Lead, SAN-Regeln custom built"
- area: "SQL / PostgreSQL"
level: 3
evidence: "self-taught via DVL-Projekt"
breadth: # horizontale Bar
- area: "Linux/NixOS basics"
level: 2
- area: "Bash scripting"
level: 2
- area: "Excel/data wrangling"
level: 3
- area: "Stakeholder communication"
level: 3
```
## Was in `depth` vs `breadth` gehört
| Kriterium | depth | breadth |
|---|---|---|
| Level | ≥ 3, ideal 4–5 | 1–3 |
| Beleg erforderlich | ja (Projekt, Cert) | nein |
| Anzahl | 1–2 (max. 3) | 3–7 |
| Identitäts-stiftend | ja („ich bin die Person für X") | nein |
## Karriere-Progression
| Form | Beschreibung | Level im Career-Ladder |
|---|---|---|
| **I-Shape** | Nur Specialist, keine Breite | Junior / Entry |
| **T-Shape** | Eine Tiefe + moderate Breite | Mid / Senior |
| **Π-Shape** (Pi) | Zwei Spezialgebiete + Breite | Staff |
| **Comb-Shape** | Mehrere Tiefen, generalistisch | Principal / Distinguished |
## Anwendung für Projektplanung
1. **Tiefe zuerst matchen**: Welches Projekt braucht jemand mit Level 4+ in Skill X? → depth-Feld filtern.
2. **Breite für Substitution**: Wer kann einspringen, wenn der Specialist ausfällt? → breadth-Feld filtern.
3. **Karriere-Planung**: Welches breadth-Feld will jemand zu depth entwickeln? → Wachstumsplan-Feld.
## Quellen
- Valve New Employee Handbook (PDF), p. 46
- IDEO Tim Brown — „The T-Shaped Professional" (LinkedIn article)
- McKinsey „Agile Teams Need T-Shaped People"
Siehe auch: [framework-skills-matrix.md](framework-skills-matrix.md) für die Level-Definitionen.
+176
View File
@@ -0,0 +1,176 @@
# DSGVO / BDSG für Mitarbeiter-Profile (Deutschland)
Verbindliche Lektüre **vor** jeder Profil-Anlage. Dieser Skill ist für AZ-Gruppe (kein Betriebsrat), die rechtliche Basis ist dort einfacher. Für andere Unternehmen mit Betriebsrat gelten zusätzliche Pflichten — siehe Ende.
## Rechtsgrundlagen
### Für AZ-Gruppe (kein Betriebsrat)
- **§ 26 Abs. 1 BDSG** (Datenverarbeitung für Zwecke des Beschäftigungsverhältnisses) i.V.m. **Art. 6 Abs. 1 lit. b DSGVO** (Vertragserfüllung).
- Eine **Einwilligung ist nicht erforderlich** für Daten, die für die Durchführung des Arbeitsverhältnisses objektiv erforderlich sind — dazu zählt die Projektplanung und Kompetenz-Erfassung.
- **Privacy Notice** (Datenschutz-Information) muss den Kollegen dennoch mitgeteilt werden (Transparenz-Pflicht, Art. 13 DSGVO).
### Für Unternehmen mit Betriebsrat (nicht AZ-Gruppe)
- **Mitbestimmung** nach § 87 Abs. 1 Nr. 6 BetrVG (Einführung technischer Einrichtungen zur Leistungs- und Verhaltenskontrolle).
- **Betriebsvereinbarung** als zusätzliche Rechtsgrundlage.
- ECJ-Urteil Dez 2024 (C-65/23): Betriebsvereinbarung **kann unrechtmäßige Verarbeitung nicht legitimieren** — d.h. auch mit BV müssen die Art. 5/6 DSGVO-Prinzipien eingehalten werden.
- Skill-Nutzung in solchen Unternehmen → mit Betriebsrat abstimmen, bevor Profile angelegt werden.
## Datenminimierung (Art. 5 Abs. 1 lit. c DSGVO)
> „Personenbezogene Daten müssen dem Zweck angemessen und erheblich sowie auf das für die Zwecke der Verarbeitung notwendige Maß beschränkt sein."
Konkret: nur Daten erfassen, die für **Projektplanung und Personalentwicklung** objektiv gebraucht werden.
### ✅ Erlaubt (keine Einwilligung nötig, § 26 BDSG)
- Name, berufliche Kontaktdaten (Firma-E-Mail, Firma-Telefon)
- Rolle, Titel, Abteilung, Vorgesetzter
- Standort (Büro), Zeitzone, reguläre Arbeitszeiten
- Berufliche Skills und Level (selbst- oder manager-bewertet)
- Zertifikate (beruflich erworbene)
- Beruflicher Werdegang (Ausbildung, bisherige Stationen, soweit offengelegt)
- Aktuelle Projekt-Zugehörigkeiten
- Belbin-Präferenzen (freiwillig, sobald bekannt)
- CliftonStrengths-Top-5 (freiwillig, wenn Test vorliegt)
- Arbeitsstil-Präferenzen (kommunikativ vs still; morgen- vs abend-aktiv)
### ❌ Verboten ohne explizite freiwillige Einwilligung
- Familienstand, Kinder, private Wohnanschrift
- Private Hobbys, Vereinsmitgliedschaften
- Gewerkschaftszugehörigkeit
- Politische Meinung, Religion, Weltanschauung
- Private Kontaktdaten (Privat-Handy, Privat-E-Mail)
- Private Social-Media-Accounts
### 🚫 Niemals in diesem Skill (Option A — globale Regel)
Diese Felder gehören in kein Profil dieses Skills, auch nicht mit Einwilligung:
- **Performance-Ratings** (Leistungsbeurteilungen)
- **9-Box-Platzierungen** (Performance × Potential)
- **Potenzialeinschätzungen** (für Nachfolgeplanung)
- **Gehalt, Boni, Vergütungsband**
- **Disziplinarische Maßnahmen** (Abmahnungen, Verwarnungen)
- **Krankenstand, Gesundheitsdaten, Krankheiten**
- **Behinderungen, medizinische Accommodations**
- **Private Vorstrafen, soweit arbeitsrechtlich nicht relevant**
Begründung: Diese Daten gehören in **separat access-geschützte HR-Systeme** (z. B. DATEV, Personio-Vertraulich-Bereich), nicht in ein OKF-Bundle, das über Git synchronisiert wird. Self-Scoring mit solchen Daten verstößt gegen Art. 5 KI-VO (Social Scoring Verbot).
## Privacy Notice Template
Vor Profil-Anlage dem Kollegen aushändigen. Textblock zum Kopieren:
```
DATENSCHUTZ-INFORMATION MITARBEITERPROFIL
Zweck: Projektplanung, Kapazitätssteuerung, Personalentwicklung,
Delegation-Entscheidungen.
Rechtsgrundlage: § 26 Abs. 1 BDSG i.V.m. Art. 6 Abs. 1 lit. b DSGVO
(Durchführung des Arbeitsverhältnisses).
Datenkategorien: Name, Rolle, berufliche Skills, Zertifikate, Arbeitszeiten,
Projekt-Zugehörigkeiten, freiwillig: Belbin-/CliftonStrengths-
Profile.
Empfänger: Vorgesetzte, Projekt-Manager, ggf. weitere Abteilungsleiter
bei cross-funktionaler Zusammenarbeit. Keine Weitergabe an
Dritte außerhalb der Unternehmensgruppe.
Speicherdauer: Bis 6 Monate nach Beendigung des Arbeitsverhältnisses.
Profile werden quartalsweise überprüft (stale_after = 180 T).
Ihre Rechte: Auskunft (Art. 15), Berichtigung (Art. 16), Löschung
(Art. 17), Einschränkung (Art. 18), Datenübertragbarkeit
(Art. 20), Widerspruch (Art. 21), Beschwerde bei Aufsicht.
Verantwortlicher: [Name des Unternehmens, Datenschutzbeauftragter Kontakt]
Widerruf: freiwillige Angaben (Belbin, CliftonStrengths, Arbeitsstil-
Notizen) können jederzeit widerrufen werden.
```
Datum der Mitteilung ins Frontmatter: `consent.notice_given_at: YYYY-MM-DD`.
## Legitimate Interest Assessment (LIA) Skeleton
Bei alternativer Rechtsgrundlage (Art. 6 Abs. 1 lit. f DSGVO) — empfohlen für Profile von Personen ohne direkten Arbeitsvertrag (Freelancer, Consultants):
```
LIA — MITARBEITERPROFIL
(1) Zweck: Projektplanung und Personalentwicklung.
(2) Berechtigtes Interesse: effiziente Projektabwicklung, Vermittlung der
richtigen Skills an die richtige Aufgabe, Vermeidung von Single Points
of Failure.
(3) Notwendigkeit: Profile sind die einzige praktikable Methode, um diese
Informationen im Team zugänglich zu machen. Alternative: mündliche
Weitergabe → unzuverlässig, führt zu same-bias bei Projektbesetzungen.
(4) Abwägung: Interesse der Verarbeitung überwiegt das Interesse der
betroffenen Person an Nichtverarbeitung, da ausschließlich
berufsrelevante Daten verarbeitet werden, keine sensiblen Kategorien,
und Datensubjekt hat Self-Service-Zugriff auf eigene Daten.
(5) Ergebnis: Verarbeitung zulässig.
```
## Git-spezifische Risiken
### Repo MUSS private sein
```bash
# Niemals:
git remote add origin https://github.com/public-repo/...
# Richtig:
git remote add origin git@code.m3ta.dev:private/pm.git # oder GitHub private repo
```
### Git History ist permanent
Selbst wenn eine Datei gelöscht wird, bleibt sie in der Git-History. Für DSAR (Art. 17 Löschung) ist das komplex:
```bash
# Datei aus der kompletten History entfernen:
git filter-repo --invert-paths --path .okf/organization/sascha-koenig.md
git push --force-with-lease
```
⚠️ **Force-Push** kann kollidieren — Koordination mit allen Contributors erforderlich.
### Workflow für DSAR-Anfragen (Art. 15 / Art. 17)
1. **Auskunft** (Art. 15): alle Dateien mit Bezug zur Person auflisten. `git log --all --diff-filter=A -- .okf/organization/<slug>.md` zeigt alle Commits, die die Datei angerührt haben.
2. **Löschung** (Art. 17): Datei löschen + `git filter-repo` + Force-Push + Cache-Invalidierung bei Teamkollegen (lokale Klons).
3. **Berichtigung** (Art. 16): direkt im Profil ändern, Commit mit `<old> → <new>` Hinweis.
## Social Scoring Verbot (Art. 5 KI-VO)
Die EU-KI-Verordnung verbietet KI-Systeme, die „Social Scoring" durchführen — also Personen basierend auf persönlichem Verhalten oder Persönlichkeitsmerkmalen scoren, in einem Kontext der nicht mit der Datengrundlage zusammenhängt.
**Erlaubt**: matchen von Skills an Projektanforderungen (beruflich, kontextuell passend).
**Verboten**:
- Scores aus privaten Social-Media-Aktivitäten ableiten.
- Disziplinarische Maßnahmen in „Zuverlässigkeits-Scores" einbeziehen.
- Persönliche Eigenschaften (Alter, Geschlecht, Nationalität) in Matchings verwenden.
- Performance-Ratings für Projektbesetzung verwenden (im Konflikt mit Option A).
## Quellen
- § 26 BDSG (Bundesdatenschutzgesetz)
- Art. 5, 6, 9, 13, 15-21 DSGVO
- ECJ C-65/23 (Dezember 2024) — Betriebsvereinbarung und DSGVO
- BAG 8 AZR 209/21 — Workday/SAP-Datenverarbeitung
- DSN-Group.de — Skill-Matrix Datenschutz
- Osborne Clarke — KI-Systeme und Skill-Matrix
- Hans-Böckler-Stiftung — Beschäftigtendatenschutz
Siehe auch: SKILL.md für den Workflow inkl. Privacy-Notice-Pflicht.
@@ -0,0 +1,193 @@
# Interview-Guide für den Interaktiven Wizard
Strukturierter Frage-Katalog für den Profile-Erstellungs-Workflow. Der Agent arbeitet ihn **Phase für Phase** ab, fragt **eine Frage pro Nachricht** (nicht Block-Fragen), und stellt Multi-Choice-Entscheidungen (z. B. Skill-Levels) als Auswahlfrage mit nummerierten Optionen.
Lies diese Datei, wenn der User sagt: „Erstelle Profil für [Name]", „Profil-Interview mit [Name]", „Profile-Wizard starten", oder wenn Phase 2 des [SKILL.md-Workflows](../SKILL.md) ansteht.
## Wizard-Prinzipien
1. **Eine Frage pro Nachricht** — niemals 5 Fragen auf einmal. Das ist bewusst so entschieden (Pattern aus `brainstorming`-Skill).
2. **Auswahlfragen** — bei Skill-Levels, Belbin etc. die Optionen nummeriert auflisten; der User antwortet mit der Nummer. Bietet der Harness ein Auswahl-Tool, darf es genutzt werden.
3. **Freie Eingabe für Freitext** — Name, Arbeitsstil-Notizen etc. normal im Chat.
4. **Skip erlaubt** — jedes Feld darf mit „k.A." oder „überspringen" beantwortet werden, wenn Kollege es nicht beantworten will.
5. **Beleg statt Behauptung** — bei Level ≥3 nach Beleg fragen (Ticket, Zertifikat, Commit).
6. **Auto-Enrichment vorab** — vor dem Interview `scripts/auto-enrich.sh "<Name>"` laufen lassen und dem User die belegten Fakten zeigen. Dann nur noch Lücken abfragen.
7. **HARD-GATE vor Profil-Schreiben** — das Profil wird erst geschrieben, wenn User den Entwurf bestätigt hat.
## Phasen-Übersicht
```
Phase 0: Pre-Flight → 1 Frage (Privacy Notice)
Phase 1: Auto-Enrichment → Script + Präsentation
Phase 2: Identität → 5-6 Fragen
Phase 3: Hintergrund → 3 Fragen
Phase 4: Skills Assessment → 5-15 Fragen (nach Katalog)
Phase 5: Team-Profil → 3-5 Fragen (optional)
Phase 6: Kapazität → 3 Fragen
Phase 7: Wachstum → 3 Fragen
Phase 8: Draft-Review → User-Approval
Phase 9: Verify-Plan → Checkliste
```
## Phase 0 — Pre-Flight
**Frage 1**: „Bevor wir starten: Hast du [Kollege] die Datenschutz-Information (Privacy Notice) für das Profil mitgeteilt? Wann?"
- Antwort als Datum (YYYY-MM-DD) speichern
- Wenn „nein" → Wizard pausieren, Privacy Notice zuerst aushändigen (Template in [gdpr-de.md](gdpr-de.md)). Bis dahin ist nur ein Minimal-Stub erlaubt (siehe SKILL.md)
- Wenn „weiß nicht" → Wizard abbrechen, darf nicht ohne Consent weiter
## Phase 1 — Auto-Enrichment
**Action**: Führe `bash ~/.agents/skills/lead-profile/scripts/auto-enrich.sh "<Name>"` aus.
**Präsentation**: Zeige dem User den Output formatiert:
- „Aus Basecamp habe ich X Treffer gefunden — zentrale Erkenntnisse: …"
- „Im OKF-Bundle wird [Kollege] in Y Dateien erwähnt: …"
- „NixOS-Config gefunden? → Linux-Level mind. 2"
- „Diese X Felder lassen sich aus Quellen belegen, der Rest braucht Self-Auskunft."
**Frage danach**: „Soll ich mit diesen belegten Fakten das Grundgerüst bauen und dich dann nur noch nach den Lücken fragen? (ja/nej)"
## Phase 2 — Identität
**Frage 2.1** (freie Eingabe): „Wie lautet die offizielle Titelbezeichnung von [Kollege]? (z. B. IT-Administrator, Sales Manager, HR Business Partner)"
**Frage 2.2** (freie Eingabe): „Welches Büro / welcher Standort? (z. B. Hof, Plauen, CZ-Pilsen)"
**Frage 2.3** (freie Eingabe): „Seit wann ist [Kollege] dabei? (Monat/Jahr genügt)"
**Frage 2.4** (freie Eingabe): „Wer ist der direkte Vorgesetzte? (oder: bist du es selbst?)"
**Frage 2.5** (nur falls nicht aus Basecamp bekannt): „Kannst du die E-Mail-Adresse bestätigen? (z. B. vorname.nachname@azintec.com)"
**Frage 2.6** (nur falls nicht aus Auto-Enrichment bekannt): „Basecamp-Person-ID und Zammad-Login von [Kollege]? (Zammad-Login darf „offen" bleiben)"
## Phase 3 — Hintergrund
**Frage 3.1** (freie Eingabe): „Welche Ausbildung / welches Studium hat [Kollege]? (z. B. Fachinformatiker Systemintegration 2018-2021, BWL Bachelor)"
**Frage 3.2** (freie Eingabe): „Gibt es relevante vorherige Stationen, die für die Projektarbeit nützlich sind? (kurz, 1-3 Einträge)"
**Frage 3.3** (freie Eingabe): „Hat [Kollege] aktuelle Zertifikate? (z. B. Microsoft Certified, ITIL, Linux LPIC)"
## Phase 4 — Skills Assessment
**Action**: Lade den Kompetenzkatalog, der zur Abteilung passt:
- IT: `references/competence-catalog-it.md`
- Andere: `references/competence-catalog-template.md` (und User muss eigenen Katalog angeben)
**Fragen-Muster pro Skill** (Auswahlfrage):
> Frage: „**Sage100-Customizing** — welches Level passt für [Kollege]?
>
> - **L0** — nicht gebraucht in dieser Rolle
> - **L1** — in Training, hat Schulung aber keine Praxis
> - **L2** — kann unter Anleitung arbeiten, Output muss geprüft werden
> - **L3** — selbstständig, konsistente Qualität (Standard-Ziel)
> - **L4** — SME, coacht andere
> - **L5** — Strategic Owner, setzt Standards
>
> Anker aus [framework-skills-matrix.md](framework-skills-matrix.md) und [skill-anchors-cheatsheet.md](skill-anchors-cheatsheet.md):
> L3 = konfiguriert selbstständig SAN-Validierungsregeln; pflegt Artikelstämme; kennt Geschäftsart-999-Logik."
**Nach Level ≥3 nachfragen**: „Gibt es dafür einen Beleg? (Ticket-URL, Zertifikat, Commit, Meeting-Notiz)"
**Anzahl Fragen**: Starte mit **5 Kern-Skills** der Rolle. Frage nicht alle 30+ Skills ab — das ermüdet. Lass den User weitere Skills ergänzen, falls wichtig.
**Schluss-Frage**: „Gibt es Skills, die ich vergessen habe? Freie Nennung."
## Phase 5 — Team-Profil (optional)
**Hinweis an User**: „Team-Profil ist optional. Es hilft bei Projektstaffing, ist aber nur wertvoll, wenn die Person einen Belbin- oder CliftonStrengths-Test gemacht hat oder eine klare Selbstauskunft geben kann."
**Frage 5.1** (Auswahlfrage, Multi-Choice): „Kennt [Kollege] seine Belbin-Teamrolle?
- Ja, offizieller Test gemacht → welche Rolle(n)?
- Ja, informelle Selbstauskunft → welche?
- Nein → überspringen"
Wenn ja, Belbin-Auswahl präsentieren (9 Rollen, siehe [framework-belbin.md](framework-belbin.md)).
**Frage 5.2** (Auswahlfrage): „CliftonStrengths gemacht?
- Ja → Top 5 nennen
- Nein → überspringen"
**Frage 5.3** (freie Eingabe): „Arbeitsstil-Präferenzen? (z. B. morgens produktiver, bevorzugt schriftliche Updates, arbeitet gerne fokussiert)"
## Phase 6 — Aktuelle Kapazität
**Frage 6.1** (Auswahlfrage, Multi-Choice): „Wie hoch ist die aktuelle Verfügbarkeit von [Kollege] für neue Projekte?
- Voll verfügbar (100%)
- Weitgehend (60-80%)
- Knapp (20-40%)
- Überlastet (0%)"
**Frage 6.2** (freie Eingabe): „An welchen aktiven Projekten ist [Kollege] gerade beteiligt? (Mit Rolle + grober %-Allocation)"
**Frage 6.3** (Auswahlfrage): „Bevorzugte Engagement-Art?
- Embedded (im Projektteam voll integriert)
- Consultant (fachliche Beiträge, nicht im Team)
- Advisory (Berater, nicht operativ)
- Lead (Projektleitung)"
## Phase 7 — Wachstum
**Frage 7.1** (freie Eingabe): „Welche Skills möchte [Kollege] in nächsten 12 Monaten entwickeln? (2-3 Skills)"
**Frage 7.2** (freie Eingabe): „Welche Rollen sind für [Kollege] langfristig interessant? (z. B. Senior Specialist, Team Lead, Architect)"
**Frage 7.3** (Auswahlfrage): „Offen für Mentoring?
- Ja, als Mentor
- Ja, als Mentee
- Beides
- Nein"
## Phase 8 — Draft-Review
**Action**: Schreibe das Profil nach `/home/sascha.koenig/p/PM/.okf/organization/<slug>.md`. Status bleibt `draft`.
**Präsentation**: Zeige den Inhalt im Chat (vor allem Frontmatter + Skills-Matrix + Footnotes).
**Frage 8.1** (Auswahlfrage, Multi-Choice): „Entspricht das Profil deinem Verständnis von [Kollege]?
- Ja, sieht gut aus → weiter zu Verify-Plan
- Fast, kleine Anpassung nötig → was?
- Nein, größerer Überarbeitungsbedarf → was?"
Iteriere bis User „Ja" sagt.
## Phase 9 — Verify-Plan
**Checkliste präsentieren**:
```
□ Profil geschrieben unter /home/sascha.koenig/p/PM/.okf/organization/<slug>.md
□ Footnotes für alle Level-≥3-Claims gesetzt
□ Cross-Links zu Projekten/Entscheidungen/Abteilung gesetzt
□ status: draft (bleibt bis Verify abgeschlossen)
□ consent.notice_given_at eingetragen
□ generated.by + generated.at eingetragen
□ OKF-Validierung über den `validate`-Skill durchgelaufen (strict), Bundle /home/sascha.koenig/p/PM/.okf
□ log.md-Eintrag angelegt
```
**Nächste Schritte vorschlagen**:
1. Profil an [Kollege] senden mit Bitte um Self-Auskunft der `k.A.`-Felder
2. Termin mit [Kollege] + Vorgesetzten für Verify-Review (15-30 Min)
3. Nach Verify: `status: draft` → `stable`, `verified`-Array füllen, `log.md` aktualisieren
## Anti-Patterns (vermeiden)
- ❌ **Block-Fragen** („Name, Titel, E-Mail, Tenure — bitte alles nennen"): überfordert User.
- ❌ **Skills ohne Anker** („Welches Level Sage?"): ohne konkreten Anker ist Level-Bewertung Rating Drift.
- ❌ **Diagnose ohne Test** („Ich denke, er ist ein Plant-Belbin"): nicht valide, unterlassen.
- ❌ **Annahmen ohne Beleg** („Ich sage mal Level 3"): Beleg oder Level ≤ 2.
- ❌ **Fertiges Profil ohne Review schreiben**: HARD-GATE verletzt.
- ❌ **Performance-Ratings erfragen**: verboten per Option A, siehe [gdpr-de.md](gdpr-de.md).
## Quellen
- `brainstorming`-Skill — Vorlage für „eine Frage pro Runde" Pattern
- `skill-creator/references/workflows.md` — Sequenzielle + konditionale Workflow-Patterns
- SHRM BASK — Interview-Methodik für Kompetenz-Bewertung
- Gallup — StrengthsFinder Interview-Prinzipien
@@ -0,0 +1,138 @@
# Skill-Anchors Cheatsheet (Top 10 IT-Skills)
Kuratierte Verhaltensanker für die 10 häufigsten IT-Skills zur Verwendung im [Interview Wizard Phase 4](interview-guide.md). Für den vollständigen Katalog siehe [competence-catalog-it.md](competence-catalog-it.md).
Jeder Skill hat 5 Level-Anker. Agent übernimmt diese als nummerierte Optionen in die Auswahlfrage, damit der User konkret und nicht abstrakt bewertet.
## 1. Sage100 (ERP)
| Level | Anker |
|---|---|
| L0 | Nicht in dieser Rolle gebraucht |
| L1 | Weiß was Sage100 ist; hat es gesehen |
| L2 | Kann unter Anleitung Artikelstämme pflegen; kennt Intrastat-Basics |
| **L3** | **Konfiguriert selbstständig SAN-Validierungsregeln; pflegt Artikelstämme; löst Intrastat-Meldungen auf; kennt Geschäftsart-999-Logik** |
| L4 | Hat Prozess-Redesigns geleitet (z. B. DVL); coacht Kollegen |
| L5 | Entscheidet über Sage-Migrationsstrategie; kennt System besser als externe Consultants |
## 2. Linux / NixOS
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Kann sich einloggen, Dateien listen |
| L2 | **Installiert Pakete via apt/nix; kennt Bash-Basics; hat sudo-Access unter Anleitung** |
| **L3** | **Schreibt NixOS-Module selbst; debugt Services; schreibt systemd-Units; kann operativ ohne Aufsicht arbeiten** |
| L4 | Baut eigene NixOS-Hosts von Grund auf; hält Code-Reviews |
| L5 | Entscheidet über Infrastruktur-Architektur (K8s vs NixOS-Cluster) |
⚠️ **Wichtig**: Wenn NixOS-User-Config mit `wheel`-Gruppe existiert → **mind. L2**, unabhängig von Selbsteinschätzung.
## 3. Docker / Podman
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Weiß was Container sind |
| L2 | Kann `docker run` / `podman run` für vorgegebene Images; kennt Volume-Grundlagen |
| **L3** | **Schreibt eigene Dockerfiles/Podman-Container; debugt Container; kennt Volume- und Network-Management** |
| L4 | Multi-Stage-Builds; kennt Security-Implications (Rootless, SELinux) |
| L5 | Entscheidet über Container-Strategie im Unternehmen |
## 4. SQL / PostgreSQL
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Kann `SELECT * FROM x` ausführen |
| L2 | Kennt Joins, kann unter Anleitung Reports ziehen |
| **L3** | **Schreibt selbstständig Joins, Aggregate; kennt EXPLAIN ANALYZE; debugt langsame Queries; kann UPDATE/DELETE sicher ausführen** |
| L4 | Baut Schema-Designs; kennt Indexing-Strategien; migriert große Datenmengen |
| L5 | Entscheidet über Datenbank-Architektur; Performance-Tuning-Experte |
## 5. Microsoft Intune / MDM
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Weiß was MDM ist |
| L2 | Kann Geräte unter Anleitung enrollen; kennt Policy-Basics |
| **L3** | **Konfiguriert selbstständig Compliance-Policies; kennt Conditional Access; troubleshooted Device-Issues** |
| L4 | Baut Autopilot-Deployment; coacht andere Admins |
| L5 | Entscheidet über MDM-Strategie; Multi-Platform-Rollouts |
## 6. Hardware-Beschaffung / Inventory
| Level | Anker |
|---|---|
| L0 | Nicht in Rolle |
| L1 | Weiß wer zuständig ist |
| L2 | Kann Bestellungen ausführen mit Vorgabe |
| **L3** | **Orchestriert Bestellungen über mehrere Kollegen hinweg; klärt Anforderungen; kennt Lieferanten** |
| L4 | Verhandelt Rahmenverträge; baut Inventory-Prozesse |
| L5 | Entscheidet über Beschaffungsstrategie IT-seitig |
## 7. Programmierung (Go / Rust / Python / Bash)
Pro Sprache separat bewerten. Beispiel Python:
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Kann „Hello World" |
| L2 | Schreibt kleine Scripts unter Anleitung |
| **L3** | **Schreibt Idiomatic Python 3; kennt pytest, typing; löst eigene Tasks** |
| L4 | Baut Production-Systeme mit CI/CD; Performance-Optimierung |
| L5 | Entscheidet über Python-Architektur-Standards im Team |
## 8. CI/CD (GitHub Actions, GitLab CI)
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Weiß was CI ist |
| L2 | Kann bestehende Workflows anpassen |
| **L3** | **Schreibt eigene Workflows; kennt Caching; troubleshooted Builds** |
| L4 | Baut Self-Hosted-Runner-Setup; entscheidet über Pipeline-Architektur |
| L5 | Definiert unternehmensweite CI/CD-Standards |
## 9. Netzwerk / TCP / DNS
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Weiß was IP-Adresse ist |
| L2 | Kann IP-Konfiguration prüfen; kennt DNS-Basics |
| **L3** | **Debugt selbstständig Netzwerkprobleme (ping, traceroute, tcpdump); kennt VLANs, Routing** |
| L4 | Plant Netzwerk-Architektur; konfiguriert Firewalls |
| L5 | Entscheidet über Netzwerk-Topologie |
## 10. Security / Compliance (NIS2, DSGVO)
| Level | Anker |
|---|---|
| L0 | Nicht in Rolle |
| L1 | Hat Basis-Schulung absolviert |
| L2 | Kennt zentrale Anforderungen; kann mit Assistance umsetzen |
| **L3** | **Kennt Anforderungen; kann Maßnahmen selbstständig umsetzen (RBAC, Logging, Incident-Response)** |
| L4 | Baut Compliance-Programm; verhandelt mit Behörden |
| L5 | Entscheidet über Security-Strategie unternehmensweit |
## Verwendung im Wizard
Agent fragt: „Welches Level passt für [Kollege] bei Sage100?" und zeigt die Tabelle mit den Level-Optionen. User wählt konkret — Rating Drift wird vermieden.
Bei Level ≥3: „Gibt es dafür einen Beleg? (Ticket-URL, Zertifikat, etc.)"
Wenn User unsicher ist: „Liegt die Wahrheit eher bei L2 oder L3?" — dann L2 default (lieber konservativ).
## Andere Departments
Für nicht-IT-Abteilungen: eigenen Cheatsheet mit [competence-catalog-template.md](competence-catalog-template.md) bauen. Selbe Struktur: 5 Level-Anker pro Skill.
## Quellen
- [framework-skills-matrix.md](framework-skills-matrix.md) — generische Level-Definitionen
- [competence-catalog-it.md](competence-catalog-it.md) — vollständiger IT-Katalog
- CircleCI Engineering Competency Matrix — Vorbild für Level-Struktur
- GitLab Engineering Career Matrix — Verhaltensanker
+182
View File
@@ -0,0 +1,182 @@
#!/usr/bin/env bash
# auto-enrich.sh — Vorab-Daten-Sammlung für ein Kollegen-Profil
#
# Usage:
# auto-enrich.sh "Vorname Nachname" [email-optional]
#
# Sucht automatisch in:
# 1. Basecamp (Volltext + Person-Record aus Creator-Feldern)
# 2. OKF-Bundle (fest: /home/sascha.koenig/p/PM/.okf)
# 3. NixOS User-Configs ($NIX_DIR, default $HOME/p/NIX) — nur falls IT-Infra
#
# NICHT durchsucht (bewusst weggelassen für Shareability):
# - m3ta-brain vault (privat, nur Sascha)
# - Agent-Session-Logs (privat, nur Sascha)
#
# Output: Markdown-Report mit belegbaren Fakten + Lücken für Self-Auskunft.
set -euo pipefail
# --- Args & Config ---
NAME="${1:-}"
EMAIL="${2:-}"
OKF_DIR="/home/sascha.koenig/p/PM/.okf"
NIX_DIR="${NIX_DIR:-$HOME/p/NIX}"
if [ -z "$NAME" ]; then
echo "Usage: $0 \"Vorname Nachname\" [email]" >&2
exit 1
fi
# Normalize: First Last → lower, Umlaute transliteriert (NixOS-Dateien sind ASCII)
FIRST_RAW=$(echo "$NAME" | awk '{print $1}')
LAST_RAW=$(echo "$NAME" | awk '{print $NF}')
FIRST=$(echo "$FIRST_RAW" | tr '[:upper:]' '[:lower:]' | sed 's/ä/ae/g; s/ö/oe/g; s/ü/ue/g; s/ß/ss/g')
LAST=$(echo "$LAST_RAW" | tr '[:upper:]' '[:lower:]' | sed 's/ä/ae/g; s/ö/oe/g; s/ü/ue/g; s/ß/ss/g')
SLUG="${FIRST}-${LAST}"
NIX_FILENAME="${FIRST}.${LAST}.nix"
echo "# Auto-Enrichment-Report: ${NAME}"
echo ""
echo "Generiert: $(date -u +"%Y-%m-%dT%H:%M:%SZ")"
echo "OKF_DIR: \`${OKF_DIR}\` · NIX_DIR: \`${NIX_DIR}\` (optional, IT-only)"
echo ""
# --- 1. Basecamp ---
echo "## 1. Basecamp"
if command -v basecamp >/dev/null 2>&1; then
echo "### Treffer (Volltextsuche — max. 15 neueste)"
echo ""
echo "| Typ | Bucket | Datum | Autor | Inhalt (Auszug) |"
echo "|---|---|---|---|---|"
basecamp search "$NAME" 2>/dev/null | python3 -c "
import json, sys, re
try:
data = json.load(sys.stdin)
for r in data.get('data', [])[:15]:
bucket = (r.get('bucket', {}).get('name') or '?')[:40]
created = (r.get('created_at') or '?')[:10]
author = (r.get('creator', {}).get('name') or '?')
rtype = r.get('type', '?')
plain = (r.get('plain_text_content') or r.get('title') or '')[:100]
plain = plain.replace('|', '/').replace('\n', ' ')
print(f'| {rtype} | {bucket} | {created} | {author} | {plain} |')
except Exception as e:
print(f'(Fehler: {e})')
"
echo ""
echo "### Person-Record (aus Creator-Feldern extrahiert)"
basecamp search "$NAME" 2>/dev/null | python3 -c "
import json, sys
data = json.load(sys.stdin)
people = {}
for r in data.get('data', []):
c = r.get('creator', {})
if c and '$NAME'.lower().split()[0] in (c.get('name') or '').lower():
people[c.get('id')] = c
if people:
for pid, p in list(people.items())[:3]:
print(f'- **Name**: {p.get(\"name\")}')
print(f' - **E-Mail**: {p.get(\"email_address\", \"k.A.\")}')
print(f' - **User-ID**: {pid}')
print(f' - **Account erstellt**: {(p.get(\"created_at\") or \"k.A.\")[:10]}')
print(f' - **Admin**: {p.get(\"admin\", False)}')
print(f' - **Mitarbeiter**: {p.get(\"employee\", False)}')
print(f' - **Zeitzone**: {p.get(\"time_zone\", \"k.A.\")}')
print(f' - **Firma**: {(p.get(\"company\") or {}).get(\"name\", \"k.A.\")}')
print('')
else:
print('(kein Creator-Person-Record gefunden — E-Mail/ID manuell erfassen)')
"
else
echo "_(basecamp CLI nicht installiert — übersprungen. Siehe Skill-Doku für Installation.)_"
fi
echo ""
# --- 2. OKF-Bundle ---
echo "## 2. OKF-Bundle (\`${OKF_DIR}\`)"
if [ -d "$OKF_DIR" ]; then
matches=$(grep -rli "$NAME" "$OKF_DIR" 2>/dev/null || true)
if [ -n "$matches" ]; then
echo "### Erwähnungen in OKF-Dateien"
echo "$matches" | head -15 | while read -r f; do
rel=$(echo "$f" | sed "s|^$OKF_DIR/||")
echo "- \`./$rel\`"
done
else
echo "_(keine OKF-Erwähnungen bisher — neues Profil)_"
fi
echo ""
profile_path="$OKF_DIR/organization/${SLUG}.md"
if [ -f "$profile_path" ]; then
echo "### Bestehendes Profil"
echo "- Datei: \`./organization/${SLUG}.md\`"
echo "- Zeilen: $(wc -l < "$profile_path")"
echo "- Status: $(grep '^status:' "$profile_path" | head -1 | sed 's/status: //' || echo 'k.A.')"
else
echo "### Profil existiert noch nicht"
echo "- Pfad wäre: \`./organization/${SLUG}.md\`"
fi
else
echo "_(OKF-Bundle \`$OKF_DIR\` nicht gefunden)_"
fi
echo ""
# --- 3. NixOS User-Configs (optional, IT-only) ---
echo "## 3. NixOS User-Configs (optional, IT-only)"
if [ -d "$NIX_DIR" ]; then
nix_files=$(find "$NIX_DIR" -name "$NIX_FILENAME" 2>/dev/null || true)
if [ -n "$nix_files" ]; then
echo "### Gefundene User-Configs (\`${NIX_FILENAME}\`)"
echo ""
echo "$nix_files" | while read -r f; do
echo "- **Datei**: \`$f\`"
groups=$(grep -A 20 'extraGroups' "$f" 2>/dev/null | grep -oE '"[a-z][a-z-]+"' | tr -d '"' | paste -sd, - || echo "k.A.")
echo " - **Gruppen**: $groups"
ssh_count=$(grep -c -E 'ssh-ed25519|ssh-rsa' "$f" 2>/dev/null || echo "0")
echo " - **SSH-Keys**: $ssh_count"
echo " - **Home-Manager-Modul**: $(grep -q 'home-manager' "$f" && echo 'ja' || echo 'nein')"
if echo "$groups" | grep -q 'wheel\|sudo'; then
echo " - ⚡ **sudo-Access (wheel)** → Linux/NixOS **min. Level 2**"
fi
if echo "$groups" | grep -q 'libvirtd\|qemu\|kvm'; then
echo " - ⚡ **Virtualisierungs-Gruppen** → kann VMs/container verwalten"
fi
echo ""
done
else
echo "_(keine NixOS-Config für \`${NIX_FILENAME}\` gefunden — nicht IT oder andere Infra)_"
fi
else
echo "_(NIX_DIR \`$NIX_DIR\` existiert nicht — übersprungen)_"
fi
echo ""
# --- 4. Lücken-Report ---
echo "## 4. Lücken-Report (braucht Self-Auskunft)"
echo ""
echo "Felder, die **nicht** aus öffentlichen Quellen ableitbar sind:"
echo ""
echo "| Feld | Hinweis"
echo "|---|---|"
echo "| Offizielle Titelbezeichnung | HR-System fragen |"
echo "| Ausbildung / Studium | Direkt fragen |"
echo "| Bisherige Stationen | CV anfragen |"
echo "| Zertifikate | Nach Urkunde fragen |"
echo "| Spezifische Programmiersprachen (Go/Rust/Python/Bash) | Nur aus Commits belegbar |"
echo "| Formelle Belbin-Rollen | Nur aus offiziellem Test |"
echo "| CliftonStrengths Top 5 | Nur aus Gallup-Test (~25€) |"
echo "| Arbeitsstil-Präferenzen | Selbstauskunft |"
echo "| Verfügbarkeit / Kapazität | Vorgesetzter fragt |"
echo "| Arbeitszeiten (Details) | Nur Zeitzone aus Basecamp |"
echo "| Karriere-Ziele / Rollen von Interesse | Selbstauskunft |"
echo "| Mentoring-Bereitschaft | Selbstauskunft |"
echo ""
echo "## Nächste Schritte"
echo ""
echo "1. Diesen Report dem Assistenten zur Verfügung stellen"
echo "2. Profil mit belegten Fakten ausfüllen (Footnotes setzen!)"
echo "3. Lücken-Report an Kollegen → Self-Auskunft"
echo "4. Vorgesetzten-Review → Status von \`draft\` auf \`stable\`"
echo "5. OKF-Validierung über den \`validate\`-Skill (Bundle \`$OKF_DIR\`)"
+94
View File
@@ -0,0 +1,94 @@
---
name: lead-radar
description: |
Sascha's leadership radar: read the IT cockpit through one lens, turn the situation into
numbered decision proposals, execute them in Basecamp/Zammad after one batch approval.
Modes: tag (morning Lagebild, Zammad + 👥 IT), freitag (prepare the Friday close),
meins (weekly review of Sascha's own 🔒 Meins to-dos), person <slug> (prepare a 1:1),
portfolio (monthly review of Sascha's projects). Also answers "wem delegiere ich X"
via person mode.
Triggers: "Lagebild", "Freitags-Abschluss vorbereiten", "Wochenreview", "1:1 vorbereiten",
"Portfolio-Review".
compatibility: opencode, claude-code
---
# lead-radar
Guiding question of every run: *What must Sascha decide now, and whom does he give it to?* One run = one mode → one Lagebild → one numbered proposal list → one batch approval → execution.
Invocation: `/lead-radar <tag|freitag|meins|person <slug>|portfolio>`. Without a mode, pick from the user's words via the trigger phrases above; still unclear → ask with the five modes as options.
## Sources of truth
Read before acting; these hold the facts, this skill holds only behaviour:
- `/home/sascha.koenig/p/PM/.okf/processes/it-basecamp-regeln.md`: task rules, the six 👥 IT lists, 30-day rule, Zammad boundary, **approval protocol** (binding for every write)
- `/home/sascha.koenig/p/PM/.okf/systems/basecamp.md`: project, list and folder IDs
- `/home/sascha.koenig/p/PM/.okf/organization/*.md`: people (role, skills, Basecamp person ID, Zammad login)
- `/home/sascha.koenig/p/PM/tools/it-cockpit/README.md`: the data layer and what each scope returns
An ID that fails: resolve it by name, carry on, and add the mismatch to the Drift block.
Load the `basecamp` skill before any Basecamp CLI call; check flags with `basecamp <cmd> --agent --help`, they evolve. For German text that colleagues read (comments, notes), follow `sascha-internal-communication-style`.
## Steps
### 1. Pull the data
From `/home/sascha.koenig/p/PM`:
```bash
python3 tools/it-cockpit/cockpit.py --json --scope <mode> [--person <slug>]
```
A run takes 20–90 s. Save the JSON to the scratchpad and work from that file. Every output carries `drift` and `errors`; an entry under `errors` (e.g. Zammad without `ZAMMAD_TOKEN`) means that source is blind for this run: say so in one line at the top of the Lagebild and continue with the rest. Use live `basecamp` calls only for detail questions the cockpit does not answer (comments under an item, a card's history).
**Done when** the JSON is on disk and you know which sources are blind.
### 2. Read the situation through the mode's lens
Open the mode's reference and follow it; it says which keys to read, how to judge them, and which proposals each finding yields:
| Mode | Reference | Persists |
|---|---|---|
| `tag` | [references/tag.md](references/tag.md) | nothing |
| `freitag` | [references/freitag.md](references/freitag.md) | nothing |
| `meins` | [references/meins.md](references/meins.md) | doc in 🔒 Meins → `Wochenreviews` |
| `person <slug>` | [references/person.md](references/person.md) | nothing, by hard rule |
| `portfolio` | [references/portfolio.md](references/portfolio.md) | doc in 🔒 Meins → `02 Projekte & Initiativen` |
**Done when** every item in the mode's buckets has either a proposal or a one-line reason why it needs none.
### 3. Present: Lagebild, proposals, drift
Answer in German, in this order:
1. **Lagebild**: the mode's template from its reference. Judgement first, lists second; every item with its link.
2. **Vorschläge**: one numbered list across the whole run. Each entry: number, object (title + link), action, new value (owner / date / list), and the comment text that will go on the object. Use only the actions the approval protocol allows; anything outside it (archive a project, create a list, ping someone) becomes a point for Sascha himself, marked `Für dich:` and left unnumbered.
3. **⚠️ Drift** (only when `drift` is non-empty or step 1 hit an ID mismatch): one line per finding, followed by numbered proposals in the same list that fix the OKF side (e.g. update an ID row in `systems/basecamp.md`, add a minimal profile via `lead-profile`). Findings whose fix is a team decision (`liste_ausserhalb_regel`) go to the Friday close as `Für dich:` points.
End with the approval question: "Freigabe für alle, Abwahl per Nummer, oder einzelne Punkte ändern?"
**Done when** the user has answered explicitly. Silence or a follow-up question is not approval; answer it and ask again.
### 4. Execute the approved items
Follow [references/execute.md](references/execute.md): one command per change, the short "why" comment on every changed object, read-back afterwards.
**Done when** every approved item is either verified in Basecamp/Zammad/OKF or reported as failed with the exact command and error.
### 5. Persist and report
For `meins` and `portfolio` write the document as the mode's reference describes, reflecting what was actually executed. Other modes write nothing.
Report in German: executed items with links, failed items with error, document URL (if any), open `Für dich:` points.
**Done when** the report is out and, for `meins`/`portfolio`, the document is readable in Basecamp.
## Guardrails
- Every write waits for the batch approval; the approval covers exactly the numbered items shown.
- Proposals carry their reason; a bare "Termin verschieben" is incomplete.
- OKF holds goals, context, decisions and links; task state lives in Basecamp (spec §3.2). OKF fixes go through the same approval and end with the `validate` skill on the bundle.
- Process KPIs only: counts per list or per process, never per-person rankings.
- Owner reminders belong to automation A3; the skill's output to colleagues is the comment on the object, nothing else.
+51
View File
@@ -0,0 +1,51 @@
# Executing approved proposals
Reached from step 4 of `SKILL.md`. The approval protocol in `/home/sascha.koenig/p/PM/.okf/processes/it-basecamp-regeln.md` is the rule; this file is the mechanics.
## Order per item
1. Make the change.
2. Put the comment on the same object: one or two German sentences with the reason, ending in `(lead-radar, <Modus>, YYYY-MM-DD)`. Example: `Neuer Termin 06.11., Lieferant hat Rückmeldung für KW 45 zugesagt. (lead-radar, freitag, 2026-11-13)`.
3. Read the object back and check the new value.
Work through the list in number order. A failing item does not stop the run: note command and error, go on, and report it at the end.
## Basecamp
Write mentions as plain names (no `@`), and leave `--notify` off: the comment is the trail, reminders belong to automation A3.
| Action | Command (check flags with `--agent --help`) |
|---|---|
| Change owner | `basecamp todos update <id> --assignee <person-id> --json` |
| Set date | `basecamp todos update <id> --due YYYY-MM-DD --json` |
| Comment | `basecamp comments create <id> - < <scratchpad-file>` (stdin keeps umlauts intact) |
| Move to list (same project) | `basecamp todos position <id> --to 1 --list <list-id> --json` |
| Complete | `basecamp todos complete <id> --json` |
| Read back | `basecamp todos show <id> --json` |
**Parking:**
- Inside 🔒 Meins: move to the Meins backlog list (ID in `systems/basecamp.md`).
- From 👥 IT or a project into 📥 Backlog / Ideenspeicher (another project; `position` cannot cross projects): create a to-do in 📥 Backlog with the original title, its context and a link to the original, then comment on the original with the link to the new item and complete it. Shown to the user as one proposal.
**Cards** (card tables, e.g. Azubi board): comment with `basecamp comments create <card-id>`; moving cards between columns is the card owner's job, so propose it as a `Für dich:` point.
## Zammad
Allowed: set owner, internal note. Requires `ZAMMAD_TOKEN`; base URL from `ZAMMAD_URL`, default as in `tools/it-cockpit/cockpit.py`. Without a token, list the Zammad items as `Für dich:` points with ticket link.
```bash
# owner (owner_id = Zammad user id; resolve via GET /api/v1/users/search?query=<login>)
curl -sf -X PUT -H "Authorization: Token token=$ZAMMAD_TOKEN" -H "Content-Type: application/json" \
"$ZAMMAD_URL/api/v1/tickets/<id>" -d '{"owner_id": <uid>}'
# internal note (the "why" comment for Zammad)
curl -sf -X POST -H "Authorization: Token token=$ZAMMAD_TOKEN" -H "Content-Type: application/json" \
"$ZAMMAD_URL/api/v1/ticket_articles" \
-d '{"ticket_id": <id>, "body": "<Grund>", "type": "note", "internal": true}'
```
Every Zammad article this skill writes has `"internal": true`.
## OKF
Edit the concept files under `/home/sascha.koenig/p/PM/.okf/` as approved, set `generated.at` to today, then run the `validate` skill on the bundle. Git stays with Sascha: report the changed paths.
+52
View File
@@ -0,0 +1,52 @@
# Mode `freitag`: prepare the Friday close
When: before the Friday close (Fri 10:30, 15 min, whole team, chaired by Sascha). Lens: apply the 30-day rule, clear the waiting list, and leave Sascha with a cheat sheet of three priorities.
## Input (`--scope freitag`)
- `still_30d`: 👥 IT to-dos without a comment for 30 days.
- `wartend_nachfassen`: "Wartet auf extern / Fachbereich" items whose follow-up date has been reached.
- `regelverstoesse.ohne_owner`, `regelverstoesse.ohne_termin`.
- `pro_person`: per person the open count, overdue count, and items due in the next 10 days. Use it **only** to check that next week's commitments fit around `abwesenheiten`; it never appears in the Lagebild as a table or comparison.
- `abwesenheiten`: next 10 days.
- `drift`: `liste_ausserhalb_regel` entries are Friday decisions by definition.
## Judgement
| Finding | Proposal (one of) |
|---|---|
| 30 days silent | **weiter**: new date + comment with the next step · **parken**: into 📥 Backlog (see `execute.md`) · **schließen**: complete + comment why. Pick the one the item's description and history support; when unclear, say "im Abschluss fragen" and propose a comment asking the owner |
| Follow-up date reached | new follow-up date + comment with what is awaited from whom · or complete when the answer is visibly in |
| No owner / no date | owner + date, labelled `Vorschlag` |
| Due next week while owner is absent | new date or owner change, as a question for the close |
| List outside the rule | `Für dich:` keep (Friday decision) or archive (Sascha does it himself) |
## Lagebild template
```md
# Freitags-Abschluss – <TT.MM.JJJJ>
**Kurzfazit:** <2–3 Sätze>
## 30 Tage still → weiter / parken / schließen
- <Titel · Owner · still seit N Tagen · Link> → Empfehlung
## Wartet auf extern – Nachfassen fällig
- <Titel · wartet auf wen/was · Link> → Empfehlung
## Regelverstöße
- <Titel · fehlt Owner/Termin · Link>
## Nächste Woche: Abwesenheiten
- <Person · von–bis> (+ betroffene Termine, falls vorhanden)
## Spickzettel: drei Prioritäten für nächste Woche
1. <Priorität · warum · wer>
2. …
3. …
## Beschlüsse im Abschluss
- <Liste außerhalb der Regel, Punkte "im Abschluss fragen">
```
The three priorities come from overdue and next-week items with the widest effect (blocks others, external deadline, security); each names one owner.
+61
View File
@@ -0,0 +1,61 @@
# Mode `meins`: weekly review of Sascha's own to-dos
When: weekly. Lens: Sascha's own to-dos in 🔒 Meins; a review with judgement and recommendations, not a list dump.
## Input
- `--scope meins` → `meins.listen` (open to-dos per list) and `meins.klassifikation` (`ueberfaellig`, `heute`, `diese_woche`, `still_30d`, `wartend_nachfassen`, `ohne_owner`, `ohne_termin`).
- Last review: the newest document in folder `Wochenreviews` (`basecamp files list --in <meins-id> --vault <folder-id> --json`); its date bounds "Erledigt seit letztem Review". No folder or no document yet → use the last 7 days.
- Completed to-dos: `basecamp todos list --in <meins-id> --completed --all --json`, keep those completed after that date.
## Classify every open to-do (exactly one class)
- `🔥 Diese Woche erledigen/entscheiden`: due now, strategically important, or blocking others
- `⚠️ Überfällig`: due date passed
- `⏳ Wartet auf Rückmeldung`: delegated, blocked, or needs another person (includes the Meins waiting list)
- `🧹 Aufräumen`: unclear, duplicate, stale, or no longer relevant
- `📦 Backlog`: valid but not for this week
## Score each 🔥, ⚠️ and ⏳ item
| Dimension | Values |
|---|---|
| Dringlichkeit | überfällig / diese Woche / später / ohne Termin |
| Klarheit | nächster Schritt klar? Definition of Done vorhanden? |
| Momentum | neu / 7+ Tage still / 30+ Tage still (`still_tage`) |
| Ownership | Sascha / wartet auf jemanden / unklar |
The scores drive the recommendation per item: **do, defer, delegate, clarify, park, close**. Each recommendation that changes Basecamp becomes a numbered proposal (new date, move to the Meins backlog list, owner change for delegation, complete with comment, comment that rewrites an unclear item's next step).
## Review template (chat and document)
```md
# Wochenreview To-dos – YYYY-MM-DD
## Kurzfazit
[2–4 Sätze]
## Top 5 für diese Woche
1. [Todo](link) — Warum jetzt / nächster Schritt
## Überfällig
- [Todo](link) — Empfehlung: do / defer / delegate / clarify / close
## Wartet auf Rückmeldung
- [Todo](link) — wartet auf [Person/Sache], nächster Nachfasspunkt
## Aufräumen
- [Todo](link) — Grund und empfohlene Aktion
## Erledigt seit letztem Review
- [Todo](link)
## Vorgeschlagene Änderungen
1. [nummeriert wie in der Freigabeliste; im Dokument mit Status ✅ umgesetzt / ❌ abgewählt / ⚠️ fehlgeschlagen]
```
## Document
After execution (step 5 of `SKILL.md`), save the review as document `YYYY-MM-DD – Wochenreview` in 🔒 Meins → folder `Wochenreviews`, with the change list showing what was actually done. Use `basecamp files documents create "<Titel>" "$(cat <scratchpad-file>)" --in <meins-id> --vault <folder-id> --no-subscribe --json`. Read it back and keep its URL. A user who asks for a chat-only review gets no document.
**First run:** the folder `Wochenreviews` does not exist yet (`systems/basecamp.md` says so). Add one numbered proposal "Ordner `Wochenreviews` in 🔒 Meins anlegen und ID in `systems/basecamp.md` eintragen"; after approval create it with `basecamp files folders create Wochenreviews --in <meins-id> --json` and replace the placeholder in the ID table with the new ID.
+53
View File
@@ -0,0 +1,53 @@
# Mode `person <slug>`: prepare a 1:1
When: before a 1:1 with one team member. Lens: what this person carries, what they need from Sascha, and what Sascha could hand to them. The output is a conversation guide for Sascha, written so the person could read it over his shoulder.
## Boundary (spec §4.1, hard)
The lens describes **one person's work items and needs in their own terms**: what is open, what is stuck, what they are waiting for, what Sascha can unblock or delegate. Every statement points at an item with a link.
Guardrail: the output contains no comparison between people, no ranking or score, no judgement of performance, of commenting behaviour, or of lead times per person. Process KPIs live in the monthly KPI review, at process level. **Nothing is stored**: no document, no notes file, no OKF edit about the person (profile maintenance belongs to `lead-profile`). The scratchpad JSON is the only artefact and stays there.
## Input (`--scope person --person <slug>`)
`<slug>` is a file name in `.okf/organization/` without `.md`. A wrong slug makes the cockpit exit with the list of valid slugs: offer them and ask.
- `person`: name, Basecamp ID, email, profile path. Read the profile itself for role, skills and responsibilities.
- `basecamp.offen` across all projects, with `ueberfaellig`, `diese_woche`, `still_30d`.
- `braucht_von_sascha`: "Wartet auf extern / Fachbereich" items of the person that name Sascha.
- `board_rueckfragen` (optional; present once the cockpit provides it): cards in "Rückfrage / Benötige Admin-Rechte"-type columns of the Azubi card table, each `{title, column, url, still_tage}`. Absent key → skip that section silently.
- `zammad.offen`, `zammad.sla_4h` (blind without `ZAMMAD_TOKEN`).
- `abwesenheiten`: the person's absences in the next 10 days.
- Delegation candidates: Sascha's own open to-dos, `basecamp todos list --assignee <sascha-id> --all-projects --json` (Sascha's ID from his profile).
## Judgement
| Finding | Proposal |
|---|---|
| Something the person needs from Sascha (Rückfrage, admin rights, Fachbereich answer) | Sascha's answer as a comment on the item/card, drafted for him to confirm; or a `Für dich:` point when it needs action outside the allowed set (granting rights) |
| Overdue or 30 days silent | a question for the 1:1 ("Was brauchst du, um X abzuschließen?"); a Basecamp change only if the person already said so in a comment |
| Absence collides with a due date | new date as a 1:1 question |
| Sascha's to-do matching the person's role/skills, not colliding with absences | delegation proposal: owner change + comment with context and definition of done |
## Lagebild template
```md
# 1:1 <Vorname> – Vorbereitung <TT.MM.JJJJ>
**Kurzfazit:** <2–3 Sätze: was läuft, wo es hakt, was du mitbringen solltest>
## Braucht von dir
- <Item · seit N Tagen · Link> → was du klärst
## Offen bei <Vorname>
<überfällig · diese Woche · 30 Tage still · Zammad (SLA) – je Zeile Titel · Projekt · Termin · Link>
## Abwesenheiten (10 Tage)
- <von–bis>
## Delegationsideen
- <dein To-do · passt zu Rolle/Skill X · Link>
## Gesprächsfragen
1. <offene Frage zu einem konkreten Item>
```
+63
View File
@@ -0,0 +1,63 @@
# Mode `portfolio`: monthly portfolio review
When: monthly (first run December). Lens: every project Sascha holds open to-dos in. Per project: is there an owner, a goal, a next milestone? Then: keep, hand over, park, or cut.
## Input (`--scope portfolio`)
`portfolio.projekte[]`: `project_id`, `project`, `saschas_offene`, `ueberfaellig`, `ohne_termin`, `still_30d`, `okf_konzepte` (OKF project files linking to that Basecamp project), `todos` (Sascha's open to-dos there).
Sort the rows first:
- **Initiatives** (time-bounded projects): the review subject.
- **Standing spaces** (👥 team spaces, 🔒 Meins, 📥 Backlog, 🔁 coordination, templates; archetypes in `systems/basecamp.md`): no owner/goal/milestone check; list them in one block with their counts only.
`okf_konzepte` is matched by link, so a concept may only mention the project. Open each one and keep it as the project's concept only if it is about that project.
## Per initiative: three checks
| Check | Source | Missing → |
|---|---|---|
| Owner | OKF concept (owner/Verantwortlich); else Basecamp project description | `Owner fehlt` |
| Ziel | OKF concept (goal/purpose) | `Ziel fehlt` → OKF stub proposal or `Für dich:` |
| Nächster Meilenstein | Basecamp: next dated to-do or schedule entry in the project (`basecamp todos list --in <id> --json`, `basecamp schedule …`) | `Meilenstein fehlt` |
## Recommendation (one per initiative)
- **weiterführen**: all three present and Sascha's to-dos move; proposals only for overdue/undated items (date, comment).
- **abgeben**: Sascha is not the natural owner. Proposals: owner change of Sascha's to-dos to the named successor + comment with context. The project-level handover itself is a `Für dich:` point.
- **parken**: no momentum and no deadline. Proposals: Sascha's to-dos to the project's backlog or to 📥 Backlog (see `execute.md`), each with comment.
- **streichen**: goal obsolete. Proposals: complete Sascha's to-dos with a comment naming the decision. Archiving the project is a `Für dich:` point.
## OKF: task state out, links in (spec §3.2)
For every OKF concept of an initiative, find task state: to-do lists, "nächster Schritt bis …", status-of-work lines, dated action items. Propose one numbered OKF edit per file that replaces that state with a link to the Basecamp project or list, keeping goals, context and decisions. Show a short before/after excerpt in the proposal. Also propose missing `owner`/goal lines where the review established them.
## Lagebild template (chat and document)
```md
# Portfolio-Review – YYYY-MM-DD
## Kurzfazit
[2–4 Sätze: wie viele Initiativen, wo Sascha zu viel hält, was abgegeben/geparkt/gestrichen werden soll]
## Initiativen
| Projekt | Owner | Ziel | Nächster Meilenstein | Deine offenen | Empfehlung |
|---|---|---|---|---|---|
| [Name](link) | … / fehlt | ✅ / fehlt | TT.MM. / fehlt | N (davon M überfällig) | weiterführen / abgeben an X / parken / streichen |
## Begründungen
- **Projekt**: warum diese Empfehlung
## Ständige Bereiche
- <👥 IT, 🔒 Meins … mit Anzahl deiner offenen>
## OKF: Aufgabenstand durch Links ersetzt
- <Datei → was ersetzt wird>
## Vorgeschlagene Änderungen
1. [nummeriert wie in der Freigabeliste; im Dokument mit Status ✅ / ❌ / ⚠️]
```
## Document
After execution, save the review as document `YYYY-MM-DD – Portfolio-Review` in 🔒 Meins → folder `02 Projekte & Initiativen` (IDs in `systems/basecamp.md`) with `basecamp files documents create "<Titel>" "$(cat <scratchpad-file>)" --in <meins-id> --vault <folder-id> --no-subscribe --json`. Read it back and keep its URL.
+48
View File
@@ -0,0 +1,48 @@
# Mode `tag`: morning Lagebild
When: in the morning after the cockpit, before the 10-minute briefing (led by Mexx; Sascha attends). Lens: what needs an owner or a decision **today**.
## Input (`--scope tag`)
- `zammad`: `ohne_owner`, `sla_4h`, `prio_ohne_antwort`, `absprache_ohne_datum`, `wiedervorlage_faellig` (`offen` is context only). `null` plus an `errors` entry = Zammad blind.
- `basecamp_it`: `ueberfaellig`, `heute`, `diese_woche`, `wartend_nachfassen`, `ohne_owner`, `ohne_termin`, `still_30d`.
- `abwesenheiten`: who is out today and in the next 10 days.
Read the OKF profiles of the team for role and skills before proposing an owner.
## Judgement
| Finding | Proposal |
|---|---|
| Ticket without owner | owner from role/skills in the profiles, someone present today (check `abwesenheiten`) + internal note |
| SLA in < 4 h, prio without answer for 24 h | owner confirm or change + internal note; the customer reply itself stays with the owner |
| "Absprache getroffen" without date, Wiedervorlage due | internal note asking the owner for the next date; owner change only if the owner is absent |
| 👥 IT overdue | comment asking for a new date per rule 1 (owner sets the date); owner change only if the owner is absent beyond the due date |
| 👥 IT due today | none unless the owner is absent today → owner change or new date |
| Rule violation (no owner / no date) | set owner and date, labelled `Vorschlag` |
| Wartet auf extern, follow-up date reached | new follow-up date + comment with what is being waited for |
| `still_30d` | leave for Friday; mention the count only |
An absent owner is the strongest reason for an owner change; everything else first asks the owner via a comment.
## Lagebild template
```md
# Lagebild IT – <TT.MM.JJJJ>
**Kurzfazit:** <2–3 Sätze: was heute brennt, was entschieden werden muss>
## Zammad
<ohne Owner · SLA gefährdet · Prio ohne Antwort · Wiedervorlage – je Zeile: #Nr Titel · Owner · Alter · Link>
## 👥 IT
<überfällig · heute · Nachfasser · Regelverstöße – je Zeile: Titel · Owner · Termin · Liste · Link>
## Abwesend
<heute / nächste 10 Tage>
## Fürs Briefing (max. 3)
1. <Punkt, den Sascha im Briefing anspricht>
```
Empty sections collapse to one line ("Zammad: nichts ohne Owner, kein SLA-Risiko").
+201
View File
@@ -0,0 +1,201 @@
---
name: mitarbeiter-profil
description: "Erstellt und pflegt OKF Person-Konzepte für Kollegen in .okf/organization/. Use when: (1) Anlage eines neuen Kollegen-Profils, (2) Quarterly Profile Review / Aktualisierung, (3) Projektplanung braucht Skills- oder Kapazitäts-Suche ('wer kann X machen?'), (4) Onboarding-Tag-3-Profil-Anlage, (5) Delegation-Decision-Support. Trigger: 'Mitarbeiterprofil', 'Kollegen-Profil', 'Skill-Matrix für X', 'Profil für NN anlegen', 'wer hat Kapazität', 'wer kennt sich aus mit Y', 'Belbin-Rolle für NN'."
compatibility: opencode
---
# mitarbeiter-profil
Skill zum Erstellen und Pflegen von OKF Person-Konzepten für Kollegen in `.okf/organization/`. Die Profile dienen der **Projektplanung**, **Kapazitätssteuerung**, **Delegation** und **Personalentwicklung** — nicht der Leistungsbeurteilung.
## Prinzipien
1. **Berufsrelevanz nur.** Keine privaten Daten, keine Performance-Ratings, keine Gehaltsdaten. Siehe [references/gdpr-de.md](references/gdpr-de.md).
2. **Selbstauskunft statt Fremdbewertung.** Kollegen pflegen ihre Skills selbst. Vorgesetzter verifiziert.
3. **Aktuell halten.** Jedes Profil hat ein `stale_after`-Datum (180 Tage). Danach Review pflicht.
4. **Verlinkt, nicht dupliziert.** Projekt-Zugehörigkeiten verlinken auf `../projects/`, nicht abschreiben.
5. **Generisch einsetzbar.** Dieser Skill ist nicht IT-exklusiv. Beispiele sind IT, das Schema gilt für alle Abteilungen.
## Workflow
## Interactive Wizard (Empfohlener Modus)
Für Abteilungsleiter, die ein neues Profil erstellen, gibt es einen **geführten Wizard**. Der Agent lädt den [Interview-Guide](references/interview-guide.md) und gehtPhase für Phase durch, **eine Frage pro Nachricht**.
### Wizard-Phasen
```
Phase 0 Pre-Flight → Privacy Notice passiert?
Phase 1 Auto-Enrichment → bash scripts/auto-enrich.sh "<Name>"
Phase 2 Identität → 4-5 Fragen (Titel, Standort, Tenure, Vorgesetzter, E-Mail)
Phase 3 Hintergrund → 3 Fragen (Ausbildung, Stationen, Zertifikate)
Phase 4 Skills Assessment → 5-15 Fragen (Question-Tool mit Verhaltensankern)
Phase 5 Team-Profil → optional (Belbin, CliftonStrengths, Arbeitsstil)
Phase 6 Kapazität → 3 Fragen (Verfügbarkeit, Projekte, Engagement-Art)
Phase 7 Wachstum → 3 Fragen (Skills, Rollen, Mentoring)
Phase 8 Draft-Review → Profil schreiben, User-Approval
Phase 9 Verify-Plan → Checkliste, nächste Schritte
```
### Wizard-Trigger
Wizard **startet automatisch**, wenn User sagt:
- „Erstelle Profil für [Name]"
- „Profil-Interview mit [Name]"
- „Profile-Wizard für [Name]"
- „Mitarbeiterprofil anlegen: [Name]"
Wizard **startet nicht** bei:
- Aktualisierung eines bestehenden Profils → nutze „refresh" Workflow
- Suche nach existierenden Profilen → nutze `grep -r "Skill X" .okf/organization/`
- Pure Skill-Level-Fragen → beantworte direkt ohne Wizard
### Wizard-Hard-Gates
Der Agent DARF NICHT:
1. Das Profil schreiben, bevor der User den Draft gesehen und bestätigt hat (Phase 8).
2. Belbin-Rollen oder CliftonStrengths **raten** — nur was der User (oder ein Test) sagt.
3. Skills-Level ≥3 ohne Beleg akzeptieren (Ticket, Zertifikat, Commit).
4. Sensible Felder erfragen (Performance, Gehalt, etc.) — verboten per Option A.
5. Block-Fragen stellen — immer eine Frage pro Nachricht.
6. Ohne Privacy Notice weitermachen (Phase 0 Pflicht).
### Wizard-Ressourcen
| Resource | Wann laden? |
|---|---|
| [scripts/auto-enrich.sh](scripts/auto-enrich.sh) | Phase 1 — einmalig ausführen |
| [references/interview-guide.md](references/interview-guide.md) | Vor Wizard-Start — Fragen-Struktur |
| [references/skill-anchors-cheatsheet.md](references/skill-anchors-cheatsheet.md) | Phase 4 — für die Top 10 IT-Skills die Verhaltensanker |
| [references/competence-catalog-it.md](references/competence-catalog-it.md) | Phase 4 — falls IT |
| [references/competence-catalog-template.md](references/competence-catalog-template.md) | Phase 4 — falls nicht-IT |
| [references/gdpr-de.md](references/gdpr-de.md) | Phase 0 — Privacy Notice Template holen |
### Auto-Enrichment Quellen
Das Auto-Enrichment-Script durchsucht **nur** Quellen, die für alle AZ-Abteilungsleiter verfügbar sind:
- ✅ **Basecamp** — Volltextsuche + Person-Record aus Creator-Feldern
- ✅ **OKF-Bundle** im lokalen Repo (`$OKF_DIR`, default `.okf`)
- ✅ **NixOS User-Configs** (optional, IT-only; `$NIX_DIR` env var)
**Nicht durchsucht** (bewusst weggelassen):
- ❌ `m3ta-brain` vault (privat, nur Sascha — nicht sharebar)
- ❌ Opencode Session-Logs (privat, nur Sascha)
Wenn der User eine Quelle ausschließen will: `NIX_DIR=/dev/null OKF_DIR=/tmp ./auto-enrich.sh "Name"` überschreibt.
### Phase 1 — create (Profil anlegen)
1. **Privacy Notice**: Kollege über Zweck, Rechtsgrundlage (§ 26 BDSG), Speicherdauer informieren. Vorlage in [references/gdpr-de.md](references/gdpr-de.md).
2. **Datei anlegen**: `cp assets/person-template.md <repo>/.okf/organization/<vorname>-<nachname>.md`.
3. **Frontmatter ausfüllen**: `title`, `description`, `tags`, `generated.at` (heute), `stale_after` (heute + 180 Tage), `consent.notice_given_at` (heute).
4. **Body ausfüllen**: Identität, Hintergrund, Skills-Matrix (start mit 3–5 Kern-Skills, nicht allen), Team-Profil (Belbin/CliftonStrengths nur wenn bereits bekannt), Aktuelle Kapazität, Wachstumsplan.
5. **Cross-Links**: Auf Abteilung, aktive Projekte, relevante Entscheidungen verlinken.
6. **Status** bleibt `draft` bis Phase 2 abgeschlossen.
### Phase 2 — verify (Review)
1. **Kollege liest** den Entwurf und ergänzt/korrigiert (selbst-Ausnahme: nur berufsrelevante Skills).
2. **Vorgesetzter** bestätigt die Skills-Level mit konkretem Beleg (Projekt, Zertifikat, Ticket).
3. **`verified`-Array** im Frontmatter füllen: `- by: "human:<vorgesetzter-slug>", at: "YYYY-MM-DD"`.
4. **Status auf `stable`** ändern.
5. **`log.md`** im OKF-Bundle-root erhält Eintrag: `YYYY-MM-DD: Profil <slug> angelegt/aktualisiert`.
### Phase 3 — link (Vernetzen)
1. **Projekte**: in jedem verlinkten `../projects/<x>.md` prüfen, ob die Person im Team- oder DRI-Feld steht. Wenn nein → ergänzen.
2. **Entscheidungen**: auf `../decisions/<x>.md` verlinken, wo die Person Sign-off gegeben hat.
3. **Abteilung**: in `../organization/<abteilung>.md` ggf. Team-Mitglieder-Liste ergänzen.
### Phase 4 — refresh (Pflege)
1. **Trigger**: `stale_after` erreicht, Projekt-Abschluss, Rollenwechsel, neue Zertifizierung, Quarterly Review.
2. **Selbsteinschätzung aktualisieren**: Kollege ändert Skills-Level und `generated.at`.
3. **Vorgesetzter re-verifiziert**: `verified`-Array erhält neuen Eintrag.
4. **`stale_after` verschieben**: +180 Tage ab heute.
5. **`log.md`** aktualisieren.
### Phase 5 — use (Anwendung)
1. **Projektplanung**: „Wer hat Skill X mindestens Level 3?" → `grep -r "Skill X" .okf/organization/`.
2. **Kapazitäts-Check**: Verfügbarkeit in jedem Profil summiert = freie Kapazität.
3. **Team-Composition**: Belbin-Rollen aus allen Profilen → sind alle 3 Familien (Thinking/People/Action) vertreten?
4. **Delegation**: Wachstumsplan-Feld „Skills to develop" zeigt, wem eine Aufgabe hilft.
## Profil-Struktur (Feld-Katalog)
Ausführliches Template mit allen Feldern: [assets/person-template.md](assets/person-template.md).
| Block | Felder | Pflicht? |
|---|---|---|
| **Frontmatter** | `type: Person`, `title`, `description`, `tags`, `status`, `generated`, `verified`, `stale_after`, `consent` | type/status/generated/consent ja |
| **Identität** | Titel, Vorgesetzter, Abteilung, Standort, Zeitzone, Tenure | ja |
| **Hintergrund** | Werdegang, Zertifizierungen | ja (kann „k.A." sein) |
| **Skills-Matrix** | Technical, Domain, Soft Skills je mit Level 0–5 | ja (mindestens 3 Skills) |
| **T-Shape** | depth (Specialist), breadth (Generalist) | empfohlen |
| **Team-Profil** | Belbin (primär/sekundär), CliftonStrengths Top-5, Arbeitsstil-Notizen | optional |
| **Aktuelle Kapazität** | Verfügbarkeits-%, aktive Projekte, Engagement-Präferenz | ja |
| **Wachstumsplan** | Skills zu entwickeln, Rollen von Interesse, Mentoring-Bereitschaft | ja |
| **Projekt-Historie** | Auszugsweise, mit Links | empfohlen |
| **Quellen / Belege** | Footnotes für spezifische Behauptungen | bei Assessment-Claims |
## Framework-Auswahl
| Framework | Pflicht? | Wann verwenden? | Referenz |
|---|---|---|---|
| **Skills-Matrix 0–5** | ja | immer — Core jeder Profilkategorie | [references/framework-skills-matrix.md](references/framework-skills-matrix.md) |
| **Belbin (9 Rollen)** | optional | ab Teamgröße 4+, wenn Projektstaffing ansteht | [references/framework-belbin.md](references/framework-belbin.md) |
| **CliftonStrengths** | optional | nur wenn Kollege den Gallup-Test gemacht hat (~25€) | [references/framework-cliftonstrengths.md](references/framework-cliftonstrengths.md) |
| **T-Shape** | empfohlen | zur Visualisierung Specialist vs Generalist | [references/framework-t-shape.md](references/framework-t-shape.md) |
## GDPR-Pflichten (Kurzfassung)
Die ausführliche rechtliche Grundlage mit Templates steht in [references/gdpr-de.md](references/gdpr-de.md). Die harten Regeln:
1. **Rechtsgrundlage**: § 26 Abs. 1 BDSG (Durchführung Arbeitsverhältnis) + Art. 6 Abs. 1b DSGVO. Keine Einwilligung nötig für berufsrelevante Daten.
2. **Datenminimierung**: nur beruflich relevante Felder. Privatleben, Familie, Hobbys, Gewerkschaft → verboten ohne freiwillige Einwilligung.
3. **Ganz verboten**: Performance-Ratings, 9-Box, Potenzialeinschätzungen, Gehalt, disziplinarische Maßnahmen, Gesundheits-/Krankenstandsdaten. Diese gehören nie in ein Profil dieses Skills.
4. **Privacy Notice** muss vor Profil-Anlage dem Kollegen mitgeteilt worden sein (Datum im `consent.notice_given_at`).
5. **Staleness**: `stale_after` Pflichtfeld — spätestens nach 180 Tagen Review oder Löschung.
6. **Repo muss private sein**. Niemals auf öffentliche Remote pushen.
7. **Keine KI-gestützten Scores** aus nicht-beruflichen Daten (Social Scoring nach Art. 5 KI-VO verboten).
## Eigene Kompetenzkataloge (für nicht-IT-Abteilungsleiter)
IT-spezifischer Beispielkatalog: [references/competence-catalog-it.md](references/competence-catalog-it.md).
Für Sales, Vertrieb, HR, Produktion, Finance etc. eigenen Katalog bauen:
1. **3–7 Kompetenz-Familien** für die Abteilung definieren.
2. **Pro Familie 3–10 konkrete Skills** benennen.
3. **Level-3-Verhaltensanker** formulieren („kann selbstständig …").
4. **Level-5-Verhaltensanker** formulieren („setzt Standards, coacht andere").
Vorlage und Beispiele: [references/competence-catalog-template.md](references/competence-catalog-template.md).
## Validierung & Commit
1. **OKF validieren**: `/okf:validate .okf --strict` aufrufen. Jeden `ERROR` (§11) beheben; `WARN` sind soft.
2. **YAML-Frontmatter parsen**: `python3 -c "import yaml; yaml.safe_load(open('DATEI.md').read().split('---')[1])"`.
3. **Zeilenlimit prüfen**: SKILL.md < 500 Zeilen, references/*.md < 1000 Zeilen.
4. **Commit**: mit `process:chiron-agent` als `generated.by`. Conventional-commit-style: `add: person profile <slug>`.
5. **Push** nur in private Repos.
## Referenzen
| Datei | Wann lesen? |
|---|---|
| [references/framework-skills-matrix.md](references/framework-skills-matrix.md) | Vor jeder Skills-Bewertung; bei Rating-Unsicherheit |
| [references/framework-belbin.md](references/framework-belbin.md) | Wenn Teamrollen profiling oder Projektstaffing ansteht |
| [references/framework-cliftonstrengths.md](references/framework-cliftonstrengths.md) | Wenn ein Kollege CliftonStrengths-Testergebnisse vorlegen kann |
| [references/framework-t-shape.md](references/framework-t-shape.md) | Zur Visualisierung Specialist-vs-Generalist-Karriereplanung |
| [references/gdpr-de.md](references/gdpr-de.md) | Vor jeder Profil-Anlage; bei DSAR-Anfragen; jährlich für LIA-Review |
| [references/competence-catalog-it.md](references/competence-catalog-it.md) | Wenn IT-Profile erstellt werden |
| [references/competence-catalog-template.md](references/competence-catalog-template.md) | Wenn ein nicht-IT-Abteilungsleiter den Skill übernimmt |
| [assets/person-template.md](assets/person-template.md) | Beim Anlegen eines neuen Profils — kopieren und ausfüllen |
| [scripts/auto-enrich.sh](scripts/auto-enrich.sh) | Vor jedem Wizard — Phase 1 Auto-Enrichment |
| [references/interview-guide.md](references/interview-guide.md) | Vor Wizard-Start — Fragen-Struktur für Phasen 0-9 |
| [references/skill-anchors-cheatsheet.md](references/skill-anchors-cheatsheet.md) | Phase 4 — Verhaltensanker Top 10 IT-Skills |
@@ -0,0 +1,119 @@
---
type: Person
title: "Vorname Nachname — Rolle"
description: "1-Zeilen-Zusammenfassung für Projektplanung"
tags: [vorname-nachname, abteilung, role]
status: draft
sensitivity: confidential
generated:
by: "process:chiron-agent"
at: "YYYY-MM-DD"
verified: []
stale_after: "YYYY-MM-DD"
consent:
basis: "§26 Abs. 1 BDSG"
notice_given_at: "YYYY-MM-DD"
---
<!-- VERWENDUNG (diesen Block nach dem Ausfüllen löschen):
1. Kopiere diese Datei nach <repo>/.okf/organization/<vorname>-<nachname>.md
2. Ersetze alle Platzhalter (YYYY, ..., "k.A.")
3. Frontmatter: generated.at heute, stale_after = heute + 180 Tage
4. Status bleibt "draft" bis verify-Array gefüllt ist (Phase 2)
5. Ausführliche Anleitung: /home/sascha.koenig/.agents/skills/mitarbeiter-profil/SKILL.md
RECHTLICH (DSGVO):
- Vor Anlage Privacy Notice mitteilen (references/gdpr-de.md)
- Datum der Mitteilung eintragen in consent.notice_given_at
- KEINE Performance-Ratings, KEINE Privatdaten — siehe GDPR-Pflichten in SKILL.md
-->
# Vorname Nachname
## Identität
- **Titel / Rolle**: z. B. IT-Spezialist, Sales Manager, HR Business Partner
- **Vorgesetzter**: [Name](../organization/<vorgesetzter-slug>.md)
- **Abteilung**: [Abteilung](../organization/<abteilung>.md)
- **Standort**: z. B. DE-Hof, CZ-Pilsen
- **Zeitzone**: CET/CEST
- **Tenure (seit)**: YYYY-MM
## Hintergrund
- **Ausbildung / Studium**: z. B. Fachinformatiker Systemintegration (2018-2021)
- **Bisherige Stationen**: kurz, aber repräsentativ
- **Zertifikate**: berufliche, mit Jahr (z. B. „Linux Foundation Certified Engineer, 2024")
## Skills-Matrix
Ausführliche Level-Definitionen: `~/.agents/skills/mitarbeiter-profil/references/framework-skills-matrix.md`
Beispiel-Katalog IT: `~/.agents/skills/mitarbeiter-profil/references/competence-catalog-it.md`
### Technical
| Skill | Level (0–5) | Zuletzt assessiert | Quelle | Beleg |
|---|---|---|---|---|
| Beispiel: Sage100 | 3 | 2026-08 | project | [DVL-Redesign](../projects/dvl-prozess-neugestaltung.md) |
| Beispiel: Linux/NixOS | 1 | 2026-08 | self | — |
### Domain (Fachwissen)
| Bereich | Level | Beleg |
|---|---|---|
| Beispiel: Intrastat-Meldepflichten | 4 | DVL-Prozess dokumentiert |
### Soft Skills
| Skill | Level | Beleg |
|---|---|---|
| Beispiel: Stakeholder-Kommunikation | 3 | moderiert Bossi-Meetings |
## T-Shape
Siehe `~/.agents/skills/mitarbeiter-profil/references/framework-t-shape.md`.
- **Depth** (Specialist, Level ≥3):
- Beispiel: Sage100 / Intrastat — Level 4
- **Breadth** (Generalist, Level 1–3):
- Beispiel: Linux-Basics — Level 2
- Beispiel: Excel / Datenanalyse — Level 3
## Team-Profil
Siehe `~/.agents/skills/mitarbeiter-profil/references/framework-belbin.md` und `framework-cliftonstrengths.md`.
- **Belbin primär**: z. B. Implementer (nur wenn Test oder klare Selbstauskunft)
- **Belbin sekundär**: z. B. Completer Finisher
- **Belbin-Assessment-Quelle**: self / observer / official-test / unknown
- **CliftonStrengths Top 5**: nur wenn Gallup-Test vorliegt, sonst Feld löschen
- **CliftonStrengths-Domäne dominant**: z. B. Executing + Strategic Thinking
- **Arbeitsstil-Notizen**: z. B. „morgens produktiver; bevorzugt schriftliche Updates; arbeitet gerne fokussiert an einem Projekt"
## Aktuelle Kapazität
- **Verfügbarkeit**: X% (restliche Zeit reserviert für [Grund])
- **Aktuelle Projekte**:
- [Projektname](../projects/<projekt-slug>.md) — Rolle — X% Allocation — bis YYYY-MM
- **Bevorzugte Engagement-Art**: embedded / consultant / advisory / lead
- **Arbeitszeiten**: z. B. Mo-Fr 08:00–17:00, freitags home office
## Wachstumsplan
- **Skills zu entwickeln**: z. B. Linux, Docker, Projektmanagement
- **Rollen von Interesse**: z. B. Project Lead, Architect
- **Offen für Mentoring**: ja/nein (als Mentor oder Mentee)
## Projekt-Historie (auszugsweise)
- [Projekt](../projects/<slug>.md) — Beitrag — Zeitraum
- [Projekt](../projects/<slug>.md) — Beitrag — Zeitraum
## Quellen / Belege
Spezifische Behauptungen mit Footnote belegen. Label muss mit `sources[].id` im Frontmatter matchen (falls Frontmatter um Sources erweitert wurde).
[^dvl-meeting]: Bossi-Meeting 30.07.2026, Quelle: Basecamp-Todo-URL
## Verwandte Konzepte
- [Abteilung](../organization/<abteilung>.md)
- [Aktive Projekte](../projects/<slug>.md)
- [Relevante Entscheidungen](../decisions/<slug>.md)
@@ -0,0 +1,147 @@
# IT-Kompetenzkatalog (AZ-Gruppe Beispiel)
Konkreter Katalog für IT-Teams. Andere Abteilungen (Sales, Vertrieb, HR, Produktion, Finance) → [competence-catalog-template.md](competence-catalog-template.md).
Jeder Skill hat:
- **Konkrete Beschreibung** (eine Zeile)
- **Level-3-Anker** (was muss jemand selbstständig können, um Level 3 zu haben)
- **Level-5-Anker** (was macht einen SME aus)
## 1. ERP / Domain
### Sage100 (Sage KHK)
- **Beschreibung**: ERP-System für Buchhaltung, Artikelstamm, Intrastat, Aufträge
- **L3**: konfiguriert selbstständig SAN-Validierungsregeln; pflegt Artikelstämme; prüft Intrastat-Meldungen; kennt Geschäftsart-999-Logik
- **L5**: entscheidet über Sage100-Migrationsstrategie (Strangler-Fig); kennt Customizing besser als externe Consultants
### PIM / CRM-Systeme
- **Beschreibung**: Product Information Management (zukünftig), Raynet CRM
- **L3**: kann Produktstämme erfassen und synchronisieren; kennt Datenmodell
- **L5**: baut eigene PIM-Workflows; integriert Dritt-Systeme via API
### Intrastat-Meldepflichten
- **Beschreibung**: Statistische Meldungen an Destatis für innergemeinschaftliche Lieferungen
- **L3**: versteht Meldepflichten, kann korrekte Meldungen erzeugen, löst Einzelfälle
- **L5**: entwickelt interne Prozesse neu; verhandelt mit Destatis bei Spezialfällen
### DVL (Direktlieferungen)
- **Beschreibung**: CZ→Kunde Direktlieferungen, müssen aus Intrastat gefiltert werden
- **L3**: kennt Prozess, kann Buchungen korrekt taggen
- **L5**: redesign den Prozess (z. B. via Sage Geschäftsart 999); schult IT und Finance
## 2. Infrastructure / Betriebssysteme
### Windows Server / Terminal Server
- **Beschreibung**: Bestehende Windows-Infrastruktur (Terminal Server für Sage100-Clients)
- **L3**: verwaltet TS-Sessions, AD-Benutzer, GPOs
- **L5**: baut Migrationspfade zu Linux/NixOS; konsolidiert Windows-Footprint
### Linux (insbesondere NixOS)
- **Beschreibung**: Linux-Admin, Fokus NixOS als deklaratives System
- **L3**: schreibt NixOS-Module; debugt Services; kennt systemd-Unit-Grundlagen
- **L5**: baut eigene NixOS-Hosts von Grund auf; hält Module-Code-Reviews; entscheidet über Hosting-Architektur
### Docker / Podman
- **Beschreibung**: Container-Engine für Applikationen
- **L3**: schreibt Dockerfile/Podman-Container; debugt Container; kennt Volume-Management
- **L5**: baut Multi-Stage-Builds; kennt Security-Implications (Rootless, SELinux); entscheidet über Container-Strategie
### Traefik / Reverse Proxy
- **Beschreibung**: Traefik als TLS-Termination und Routing
- **L3**: konfiguriert Routers und Services; kennt Let's Encrypt-Integration
- **L5**: baut eigene Middlewares; troubleshootet im Produktiv-Betrieb
### Kubernetes (Ziel)
- **Beschreibung**: Container-Orchestrierung (aktuell Evaluierung, noch nicht produktiv)
- **L3**: deployed Apps via Helm; debugt Pods
- **L5**: entscheidet über K8s-vs-NixOS-Cluster-Strategie; baut Multi-Node-Cluster
## 3. Programmierung
### Go
- **L3**: schreibt Idiomatic Go; kennt Module-System; schreibt Tests
- **L5**: baut Production-Grade-Services mit Observability
### Rust
- **L3**: kennt Borrow-Checker, schreibt Idiomatic Rust, kennt Cargo
- **L5**: baut komplexe Async-Systeme; entscheidet über Crate-Architektur
### Python
- **L3**: schreibt Idiomatic Python 3; kennt pytest, typing
- **L5**: baut Production-Systeme mit CI/CD; kennt Performance-Optimierung
### Bash / Shell
- **L3**: schreibt produktive Bash-Scripts mit error handling; kennt coreutils
- **L5**: baut Shell-Tooling als komplette CLIs (mit argument parsing, subcommands)
### SQL (PostgreSQL)
- **L3**: schreibt Joins, Aggregate, kennt Explain-Analyze; debugt langsame Queries
- **L5**: baut Schema-Designs, kennt Indexing-Strategien, migriert große Datenmengen
## 4. Automation / DevOps
### Infrastructure-as-Code (Nix)
- **L3**: schreibt deklarative NixOS-Module; kennt Nix-Flakes
- **L5**: baut eigene Nixpkgs-Packages; orchestriert Multi-Host-Setups
### CI/CD (GitHub Actions, GitLab CI)
- **L3**: schreibt Workflows/Pipelines; kennt Caching
- **L5**: baut Self-Hosted-Runner-Setup; entscheidet über Pipeline-Architektur
### Monitoring (Prometheus, Grafana)
- **L3**: schreibt Exporter; baut Dashboards; kennt PromQL-Basics
- **L5**: baut Alert-Strategie; integriert Distributed-Tracing
### n8n / Workflow-Automation
- **L3**: baut Workflows; kennt Webhook-Integration
- **L5**: baut komplexe Multi-Step-Workflows mit Error-Handling und Retry-Logik
## 5. Security / Compliance
### NIS2
- **Beschreibung**: EU-Richtlinie für Cybersicherheit bei kritischen Infrastrukturen
- **L3**: kennt Anforderungen; kann Maßnahmen umsetzen (RBAC, Logging, Incident-Response)
- **L5**: baut Compliance-Programm; verhandelt mit Behörden
### DSGVO
- **L3**: kennt Prinzipien; kann Datenschutz-Folgenabschätzung schreiben
- **L5**: verhandelt mit Aufsichtsbehörden; baut Compliance-Framework
### Backup / Disaster Recovery
- **L3**: konfiguriert Backups (z. B. restic, borg); kennt Restore-Prozesse
- **L5**: baut Multi-Site-DR-Strategien; testet RTO/RPO
## 6. Soft Skills / Methoden
### Projektmanagement
- **L3**: führt kleine Projekte (3-5 Personen); schreibt klare Briefings
- **L5**: leitet Programme (Multi-Projekt); kennt Portfolio-Management
### Dokumentation
- **L3**: schreibt verständliche Runbooks; kennt audience-aware Stil
- **L5**: baut Wissensmanagement-Systeme (OKF, Handbooks)
### Wissensvermittlung (Mentoring)
- **L3**: onboarding neuer Kollegen; erklärt Konzepte verständlich
- **L5**: baut strukturierte Trainings-Programme; wirkt an Career-Ladder-Mentoring mit
### Stakeholder-Management
- **L3**: moderiert Meetings mit nicht-IT-Stakeholdern; übersetzt Fachsprache
- **L5**: verhandelt mit C-Level; baut Stakeholder-Maps
## Anwendung
Beim Ausfüllen des Profils:
1. **Nicht alles ausfüllen.** Starte mit den 5 Kern-Skills der Person.
2. **Beleg für Level ≥3.** Z. B. „Sage100 L4: DVL-Redesign geleitet (Ticket #12345)".
3. **Wachstumsplan** aus breadth-Feldern ableiten, die zu depth entwickelt werden sollen.
## Quellen / Belege-Vorlagen
- Ticket-Referenzen: `[Basecamp-Todo #12345](https://3.basecamp.com/.../todos/12345)`
- PRs/Merges: `[PR #42](https://code.m3ta.dev/.../pulls/42)`
- Zertifikate: „Linux Foundation Certified Engineer, 2024"
- Meeting-Notizen: „Bossi-Meeting 30.07.2026 (Basecamp-URL)"
Siehe auch: [framework-skills-matrix.md](framework-skills-matrix.md) für die Level-Semantik.
@@ -0,0 +1,116 @@
# Kompetenzkatalog-Vorlage (für nicht-IT-Abteilungen)
Vorlage für Abteilungsleiter außerhalb IT, die den Skill `mitarbeiter-profil` übernehmen wollen. IT-Beispiel: [competence-catalog-it.md](competence-catalog-it.md).
## Schema
Jeder Katalog-Eintrag folgt diesem Format:
```markdown
### Skill-Name
- **Beschreibung**: 1-Zeilen-Erklärung, was der Skill umfasst
- **L3-Anker**: was jemand selbstständig können muss (konkret, verhaltens-basiert)
- **L5-Anker**: was einen SME/Strategic Owner ausmacht
```
⚠️ Verhaltensanker **müssen konkret** sein. Schlecht: „kennt sich aus mit Salesforce". Gut: „konfiguriert selbstständig Workflows, kennt Datenmodell, migriert Custom Fields ohne Produktions-Ausfall".
## 4 Schritte zum eigenen Katalog
### Schritt 1 — Kompetenz-Familien definieren (3–7 Stück)
Fragen zur Identifikation:
- Welche **Wertschöpfungs-Prozesse** hat die Abteilung? (z. B. Sales: Akquise, Closing, Account-Management)
- Welche **Systeme/Tools** werden intensiv genutzt? (z. B. Salesforce, SAP, Excel)
- Welche **rechtlichen/regulatorischen** Anforderungen bestehen? (z. B. HGB, HCC, Arbeitsrecht)
- Welche **Methoden** werden angewendet? (z. B. Scrum, Kanban, Marktforschung)
Pro Familie 3–10 konkrete Skills definieren.
### Schritt 2 — Skills pro Familie benennen
| Familie | Skills (Beispiele) |
|---|---|
| **Akquise** | Kaltakquise, LinkedIn-Outreach, Networking-Events, Referral-Generierung |
| **Verhandlung** | Preisverhandlung, Vertragsdesign, Mehrweg-Verhandlung, Eskalation |
| **Account-Mgmt** | Key-Account-Planung, QBR-Vorbereitung, Upselling, Churn-Prävention |
### Schritt 3 — Level-3-Verhaltensanker
Pro Skill eine konkrete Handlung, die jemand **selbstständig, ohne Aufsicht** ausführen muss:
```markdown
### Salesforce (CRM)
- **L3**: konfiguriert Opportunities, kennt Custom Fields, baut Standard-Reports,
arbeitet mit Approval-Prozessen. Führt selbstständig Datenbereinigungen durch.
- **L5**: baut eigene Salesforce-Apx-Trigger; integriert Drittsysteme via API;
schult das Team im Rollout neuer Features.
```
### Schritt 4 — Level-5-Verhaltensanker
Pro Skill die SME-Qualitäten:
- Coacht andere auf Level 3
- Entscheidet über Tool/Prozess/Standard
- Vertritt die Abteilung in Cross-Functional-Gremien
## Beispiel-Kataloge (Skizzen)
### Sales
- **CRM-Systeme**: Salesforce / HubSpot / Raynet
- **Verhandlung**: Preisverhandlung, Vertragsrecht, Mengenrabatt-Strategien
- **Pipeline-Management**: Forecasting, Win/Loss-Analyse, Stagnation-Intervention
- **Kommunikation**: Kaltakquise, Präsentation, Briefing, QBR
- **Recht**: HGB, AGB, Exportkontrolle, Incoterms
- **Daten**: Excel-Fortgeschritten, PowerBI, Vertrieb-Kennzahlen
### Vertrieb / Operations
- **Prozess**: Auftragsabwicklung, Retouren-Management, Beschwerden
- **Logistik**: Incoterms, Frachtorganisation, Zoll
- **Systeme**: SAP SD, Sage Vertrieb, WMS
- **Kunden**: Key-Account-Pflege, Beschwerde-Management, Ausbildung von Kunden
- **Compliance**: Exportkontrolle, Embargo-Prüfung
### HR / Personal
- **Arbeitsrecht**: Kündigungsschutz, Befristungen, Arbeitszeitgesetz
- **Recruiting**: Sourcing, Interview-Führung, Einstellung
- **Payroll**: Entgeltabrechnung, Sozialversicherung, Steuer
- **Entwicklung**: Karrierepfade, Trainings-Bedarf, Mentoring-Programme
- **Betriebsrat**: Mitbestimmung, Betriebsvereinbarungen, Anhörungsverfahren
### Produktion / Fertigung
- **Sage-PP**: Produktionsplanung, Stücklisten, Arbeitspläne
- **Materialwirtschaft**: Bestandsführung, Disposition, Lieferanten-Management
- **Lean**: 5S, KVP, Wertstromanalyse, Kanban
- **Qualität**: QM-Systeme (ISO 9001), Reklamations-Management
- **Maschinen**: CNC-Programmierung, Instandhaltung, Rüstoptimierung
### Finance / Controlling
- **Buchhaltung**: Sage100 FiCo, DATEV, HGB-Bilanzierung
- **Controlling**: Plan-/Ist-Vergleich, Abweichungsanalyse, Forecast
- **Reporting**: Management-Reporting, KPI-Definition, Dashboards
- **Steuer**: USt-Voranmeldung, ZM, Jahresabschluss
- **Zahlungsverkehr**: SEPA, Zahlungsanbindungen, Kreditoren-Management
## Warnungen
1. **Zu viele Skills** (> 10 pro Familie) → Bewertungs-Erschöpfung. Lieber 5 schlanke.
2. **Zu wenige** (< 3 pro Familie) → Differenzierung geht verloren.
3. **Vage Anker** → Rating Drift. Jeder Level-3-Anker muss mit „kann selbstständig…" beginnen.
4. **Mixing with Performance-Ratings** → verboten (siehe [gdpr-de.md](gdpr-de.md)). Kompetenz-Bewertung ist NICHT Leistungsbeurteilung.
## Wartung des Katalogs
- **Quartals-Review**: neue Tools aufnehmen, obsolete streichen.
- **Kollegen-Feedback einholen**: welche Skills fehlen? Welche Anker sind unrealistisch?
- **Versionierung**: Katalog-Version in Profile-Frontmatter referenzieren, damit Bewertungen vergleichbar bleiben.
## Quellen
- Personio — Skills Matrix Guide
- Sprad — Engineering Skills Matrix Templates
- CircleCI — 7 Steps to Building a Competency Matrix
- GitLab Engineering Career Matrix Handbook
Siehe auch: [framework-skills-matrix.md](framework-skills-matrix.md) für die 0–5 Skala.
@@ -0,0 +1,69 @@
# Belbin Team Roles Framework
Quelle: Dr. Meredith Belbin (Henley Management College). Neun Verhaltens-Cluster für Team-Composition und Projektstaffing.
## Die 9 Rollen
| Rolle | Familie | Stärke | Erlaubte Schwäche | Projektphase wo stark |
|---|---|---|---|---|
| **Plant (PL)** | Thinking | Kreativ, ideenreich, löst schwierige Probleme | Ignoriert Details; schwer zu kommunizieren | Initiierung, Konzeption |
| **Monitor Evaluator (ME)** | Thinking | Nüchtern, strategisch, gute Urteilskraft | Antriebslos; überkritisch | Entscheidungs-Review |
| **Specialist (SP)** | Thinking | Tiefes Fachwissen, selbst-startend | Schmaler Fokus; an den Detail hängend | Fachliche Tiefe |
| **Co-ordinator (CO)** | People | Reif, selbstbewusst; delegiert; identifiziert Talente | Kann manipulativ wirken; schiebt eigene Arbeit ab | Steuerung/Governance |
| **Teamworker (TW)** | People | Kooperativ, diplomatisch; verhindert Reibung | Unentschlossen in Crunch-Momenten | Konfliktphasen |
| **Resource Investigator (RI)** | People | Extrovertiert, enthusiastisch; knüpft Kontakte | Überoptimistisch; verliert Interesse | Externe Recherche, Stakeholder |
| **Shaper (SH)** | Action | Dynamisch, herausfordernd; treibt voran | Provokativ; verletzt Gefühle | Umsetzung unter Druck |
| **Implementer (IMP)** | Action | Praktisch, zuverlässig; wandelt Ideen in Aktion | Inflexibel; langsam bei Neuem | Operative Umsetzung |
| **Completer Finisher (CF)** | Action | Gewissenhaft; findet Fehler; perfektioniert | Neigt zu Sorge; delegiert ungern | QA, Go-Live |
## Wann welche Rollen gebraucht werden
| Phase | Starke Rollen gebraucht |
|---|---|
| **Initiierung** (Projektidee, Konzept) | Plant, Resource Investigator |
| **Definition** (Anforderungen, Design) | Monitor Evaluator, Specialist |
| **Governance** (Steering, Lenkung) | Co-ordinator |
| **Umsetzung** (Bauen, Konfigurieren) | Shaper, Implementer |
| **Abschluss** (QA, Rollout) | Completer Finisher, Teamworker |
## Balancing-Prinzip
> „A good performance of a team is connected with balanced team in terms of team roles among the members." — Belbin
- **Ideale Teamgröße**: 4–6 Personen.
- Meist hat jede Person **2–3 bevorzugte Rollen** (kann sich über Zeit ändern).
- **Nicht jede Rolle ist immer nötig** — nach Phase auswählen.
- Eine Person kann eine sekundäre Rolle übernehmen, wenn die primäre nicht gebraucht wird.
## Anwendung für Projektstaffing
1. **Projekt-Anforderungen** definieren: welche Phasen kommen, welche Rollen brauche ich pro Phase?
2. **Bestand prüfen**: welche Belbin-Rollen haben die Kandidaten bereits im Profil?
3. **Gap-Analyse**: fehlen Rollen? → Person mit sekundärer Rolle bitten, oder extern holen.
4. **Konflikte vermeiden**: zwei starke Shaper im Team → Spannung; zwei Plants → konkurrierende Ideen.
## Wichtige Hinweise
- Belbin ist **kein Persönlichkeitstest** (wie MBTI), sondern ein Verhaltens-Präferenz-Modell am Arbeitsplatz.
- **Self-Perception Inventory (SPI)** ist der offizielle Test (8 Sektionen, je 10 Items, kostenpflichtig). Ohne formellen Test ist die Selbstauskunft eine Annäherung.
- **Observer Assessment** (Fremdeinschätzung durch Kollegen) erhöht die Verlässlichkeit deutlich.
- Belbin nicht mit DISC oder MBTI vermischen — das verwirrt.
## Im Profil abbilden
```yaml
team_profil:
belbin_primary: Implementer # aus Test oder Selbstauskunft
belbin_secondary: Completer Finisher
belbin_assessment_source: self # self / observer / official-test
belbin_assessed_at: 2026-08-03
```
## Quellen
- Belbin.com — The Team Role Company
- Bushuyev et al. (2026) — Using Belbin's Model for Designing Project Teams (DOI 10.56889/yqcj7546)
- Lubchenko & Sulimova (2017) — Transitions between team roles in software development
- Mindtools — Belbin Team Roles
Siehe auch: [framework-cliftonstrengths.md](framework-cliftonstrengths.md) für alternative Rollen-Taxonomie.
@@ -0,0 +1,97 @@
# CliftonStrengths (Gallup) Framework
Quelle: Gallup Inc., ehemals „StrengthsFinder". 34 Talent-Themes in 4 Domains. Basiert auf dem Ansatz: **Stärken-basierte Entwicklung** statt Schwächen-Fokus.
## Die 4 Domains
| Domain | Frage beantwortet | Beispiel-Themes |
|---|---|---|
| **Executing** | Wie macht die Person Dinge? | Achiever, Arranger, Belief, Consistency, Deliberative, Discipline, Focus, Responsibility, Restorative |
| **Influencing** | Wie übernimmt die Person Verantwortung und spricht an? | Activator, Command, Communication, Competition, Maximizer, Self-Assurance, Significance, Woo |
| **Relationship Building** | Wie baut und pflegt die Person Beziehungen? | Adaptability, Connectedness, Developer, Empathy, Harmony, Includer, Individualization, Positivity, Relator |
| **Strategic Thinking** | Wie nimmt die Person Informationen auf und analysiert sie? | Analytical, Context, Futuristic, Ideation, Input, Intellection, Learner, Strategic |
## Die 34 Themes (Kurzbeschreibung)
| Theme | Domain | Kern |
|---|---|---|
| Achiever | Executing | Hoher Energie-Antrieb; will jeden Tag etwas fertigbringen |
| Arranger | Executing | Liebt Komplexität; orchestriert Ressourcen |
| Belief | Executing | Wertegesteuert; tief verankerte Kernüberzeugungen |
| Consistency | Executing | Setzt Regeln gleich für alle durch; fair |
| Deliberative | Executing | Sorgfältig;识别und managt Risiken |
| Discipline | Executing | Liebt Routinen, Struktur, Planbarkeit |
| Focus | Executing | Setzt Prioritäten; lässt sich nicht ablenken |
| Responsibility | Executing | Übernimmt Ownership psychologisch |
| Restorative | Executing | Liebt es, Probleme zu lösen |
| Activator | Influencing | Machen sofort; ungeduldig mit Analyse |
| Command | Influencing | Übernimmt Kontrolle in Krise; trifft harte Entscheidungen |
| Communication | Influencing | Gute Storyteller; macht Dinge greifbar |
| Competition | Influencing | Misst sich an anderen; will gewinnen |
| Maximizer | Influencing | Aus gut herausragend machen |
| Self-Assurance | Influencing | Starkes Vertrauen in eigene Fähigkeiten |
| Significance | Influencing | Will Bedeutung haben; wirkt wichtig |
| Woo | Influencing | Gewinnt Menschen; liebt Erstkontakt |
| Adaptability | Relationship | Lebt im Moment; flexibel |
| Connectedness | Relationship | Glaubt an Zusammenhänge; alles ist verbunden |
| Developer | Relationship | Erkennt und fördert Potential in anderen |
| Empathy | Relationship | Spürt was andere fühlen |
| Harmony | Relationship | Sucht Konsens; vermeidet Konflikt |
| Includer | Relationship | Will niemanden ausschließen |
| Individualization | Relationship | Sieht jeden als einzigartig |
| Positivity | Relationship | Enthusiastisch; bringt Energie |
| Relator | Relationship | Tiefe enge Beziehungen zu wenigen |
| Analytical | Strategic | Sucht Daten und Beweise |
| Context | Strategic | Lernt aus der Vergangenheit |
| Futuristic | Strategic | Inspirierte durch Zukunftsvision |
| Ideation | Strategic | Generiert neue Ideen; verbindet Konzepte |
| Input | Strategic | Sammelt Information, Gegenstände |
| Intellection | Strategic | Denkt gerne nach; liebt Diskussion |
| Learner | Strategic | Liebt den Lernprozess selbst |
| Strategic | Strategic | Sieht Muster; findet Alternativen |
## Wichtigste Gallup-Erkenntnis
> *„Strengths awareness had twice the influence on a team's performance than the composition of a team's strengths. In other words, it's not which strengths a team has but rather how well teammates know each other's strengths."* — Gallup, 11.441 Teams Studie
**Implikation**: Das Profil ist nicht das Ziel — das **Gespräch über das Profil** ist das Ziel. Teams sollen sich gegenseitig ihre Stärken mitteilen.
## Wie Top-5 ermitteln
CliftonStrengths ist **kostenpflichtig** (~25 USD für Standard-Test, ~60 USD für Top-5 + alle 34):
1. Test unter gallupstrengthscenter.com machen (ca. 30 Minuten, 177 Fragen).
2. Top-5-Themes erhalten + Entwicklungs-Report.
3. Im Profil eintragen.
**Kein Test → keine CliftonStrengths-Daten im Profil**. Freitext-Raten ist nicht zuverlässig und sollte vermieden werden.
## Im Profil abbilden (nur wenn Test vorliegt)
```yaml
team_profil:
cliftonstrengths_top5: [Strategic, Learner, Achiever, Ideation, Input]
cliftonstrengths_domains_dominant: [Strategic Thinking, Executing]
cliftonstrengths_assessed_at: 2026-06-15
cliftonstrengths_report_path: optional/link/zum/report.pdf # oder weglassen
```
## Anwendung für Team-Composition
1. **Team Grid** (Gallup-Tool): alle Top-5 der Teammitglieder in einer Matrix → welche Domains sind über-/unterrepräsentiert?
2. **Pairing**: gleiche Stärken → Konkurrenz; komplementäre Stärken → Synergie.
3. **Aufgaben-Matching**: Executing-Dominant für Umsetzungs-Projekte; Strategic für Strategie-Arbeit.
## Kontra-Indikationen
- CliftonStrengths **nicht** für Performance-Beurteilung verwenden.
- **Nicht** als alleiniges Hiring-Kriterium.
- Ergebnisse sind **Privatsache** des Kollegen — Veröffentlichung im Profil ist freiwillig.
## Quellen
- Gallup CliftonStrengths offizielle Website
- Gallup Research: „Best Teams People Know What Makes Person Unique"
- Gallup Team Grid Tool
Siehe auch: [framework-belbin.md](framework-belbin.md) für verhaltens-basierte Rollen-Taxonomie.
@@ -0,0 +1,90 @@
# Skills-Matrix 0–5 Framework
Quelle: Upleashed 0–5-Methodik (skillsmatrixtemplate.com), übernommen von GitLab, CircleCI, Sprad. Standard-Skala der reife Kompetenz-Frameworks.
## Die 0–5-Skala
| Level | Label | Bedeutung | Bewährungsprobe |
|---|---|---|---|
| **0** | Nicht gebraucht | Skill für diese Rolle nicht erforderlich | — |
| **1** | In Training | ≤75 % Training absolviert; Qualität noch nicht belegt | Anfängerkurs abgeschlossen |
| **2** | Developing | Kann alleine arbeiten, aber Output muss verifiziert werden | Senior schaut drüber vor Go-Live |
| **3** | Capable | **Standard-Ziel**. Selbstständig, konsistente Qualität. | Arbeitet eigenständig,enger Feedback-Schleife |
| **4** | SME / Trainer | Coacht andere; owned den Skill im Team | Hat mindestens 2 Kollegen auf Level 3 gebracht |
| **5** | Strategic Owner | Setzt Standards, cross-funktional; definiert neue Prozesse | Entscheidet über Tool-Auswahl, Architektur |
**Level 3 ist das Default-Ziel** für einsatzbereite Skills. Wer Level 3 hat, darf ohne Aufsicht ans Projekt.
## Verhaltensanker schreiben
Schlecht: „Level 3 = gut in Sage100". Das ist Rating Drift.
Gut: „Level 3 Sage100 = kann selbstständig Intrastat-Validierungsregeln konfigurieren, Artikelstämme anlegen und Buchungen prüfen. Braucht bei komplexen Customizing-Fragen Support."
Jeder Skill braucht:
- **Konkrete Handlung** („konfiguriert X", „führt Y durch")
- **Selbstständigkeits-Grad** („ohne Aufsicht", „mit Review")
- **Beleg-Kriterium** (welches Ergebnis muss sichtbar sein?)
## Kompetenz-Familien (Standard-7)
Empfohlene Familien für Technical Roles (Personio, Sprad übernommen):
| Familie | Misst |
|---|---|
| **Technical Execution / Craft** | Zuverlässiges Liefern; Navigieren in fremden Codebases/Systemen |
| **Quality & Testing** | Code/System-Qualität, Test-Disziplin, Reviews |
| **System Design & Architecture** | Lösungsstrukturierung für Skalierung und Langlebigkeit |
| **Reliability & On-Call** | Uptime-Ownership, Monitoring, Incident-Response |
| **Product & Delivery Ownership** | Verstehen von User-Bedürfnissen, End-to-End-Lieferung |
| **Collaboration & Communication** | Cross-team, Dokumentation, Konfliktlösung |
| **Leadership & Mentoring** | Coaching, Wissensweitergabe, technische Richtung |
Für nicht-Technical Rollen (Sales, HR, Produktion): adaptiv übersetzen. Vorlage in [competence-catalog-template.md](competence-catalog-template.md).
## Bewertungsmethoden (Assessment Source)
| Quelle | Verlässlichkeit | Wann verwenden? |
|---|---|---|
| **Self-Assessment** | Niedrig (Subject Bias) | Pflicht als Startpunkt — Kollege kennt Eigenwahrnehmung |
| **Manager-Assessment** | Mittel | Verifiziert durch Beobachtung, aber einseitige Perspektive |
| **Peer-Assessment** | Hoch | Bestes Signal — Kollegen sehen die tägliche Arbeit |
| **Certification** | Sehr hoch | Externer Beleg, aber nicht praxisnah |
| **Project Evidence** | Sehr hoch | Konkretes Ergebnis aus Ticket/PR/Merge/Abschluss |
**Empfehlung**: Self + Manager + mind. 1 Beleg (Cert oder Projekt-Evidence) für Level ≥3.
## Kalibrierung gegen Rating Drift
Rating Drift = zwei Bewerter interpretieren Level 3 unterschiedlich. Abhilfe:
1. **Kalibrierungs-Session**: Vorgesetzte vergleichen ihre Bewertungen für dieselbe Person, diskutieren Abweichungen.
2. **Beleg-Pflicht** für Level ≥3: kein Beleg = max. Level 2.
3. **Anker-Beispiele**: ein realer Kollege (anonymisiert) als „das ist Level 3 in Skill X".
4. **Quartals-Refresh**: nach jedem Major-Projekt re-assessen, nicht jährlich.
## Spezifische Beispiele
### Sage100-Validierungsregeln (DVL/Intrastat)
- **L1**: weiß, was Sage100 ist; hat Buchungen gesehen
- **L2**: kann unter Anleitung Artikelstämme pflegen; kennt Intrastat-Basics
- **L3**: **konfiguriert selbstständig SAN-Validierungsregeln; löst DVL-Meldungen auf; arbeitet mit der Geschäftsart-999-Logik**
- **L4**: hat das aktuelle DVL-Redesign gepragt; coacht Kollegen
- **L5**: entscheidet über Sage100-Migrationsstrategie; kennt das System besser als die meisten Sage-Consultants
### Linux/NixOS
- **L1**: kann sich einloggen, Dateien listen
- **L2**: installiert Pakete via apt/nix; kennt Bash-Basics
- **L3**: **konfiguriert NixOS-Module; debugt Services; schreibt eigene systemd-Units**
- **L4**: baut eigene NixOS-Hosts von Grund auf; hält Code-Reviews
- **L5**: entscheidet über Infrastruktur-Architektur (K8s vs NixOS-Cluster)
## Quellen
- skillsmatrixtemplate.com — Upleashed 0–5 Framework
- Sprad Blog — Engineering Skills Matrix Templates
- CircleCI Engineering Competency Matrix
- GitLab Engineering Career Matrix
- Personio Skills Matrix Guide
Siehe auch: [competence-catalog-it.md](competence-catalog-it.md) für vollständigen IT-Katalog.
@@ -0,0 +1,85 @@
# T-Shape Framework
Quelle: IDEO (Tim Brown), übernommen von Valve, McKinsey, Spotify. Visuelles Modell für Specialist-vs-Generalist-Profile.
## Konzept
Ein **T-shaped Professional** hat:
- **Horizontal bar** (Breite): Generalisten-Kompetenz in mehreren Bereichen. Weiß genug, um mit anderen Fachrichtungen zu sprechen, Schnittstellen zu verstehen, in anderen Kontexten zu arbeiten.
- **Vertical bar** (Tiefe): Specialist-Expertise in mindestens einem Bereich. Zählt zu den Besten im eigenen Feld.
```
┌───────────────────┐ ← breadth (horizontal)
│ │ │ │ │ │ 3-5 verwandte Bereiche mit Level 2-3
│ │ │ │ │ │
│ │ │ │ │ │
└───┼───┴───┴───┴───┘
│
│ ← depth (vertical)
│ 1-2 Bereiche mit Level 4-5
│
▼
```
**Anders als ein I-shaped** (nur Specialist, keine Breite) und ein „generalist with no depth" (breit aber flach).
## Warum T-Shape für Projektstaffing
1. **Cross-funktionale Teams**: T-Shapes können across-Disziplinen arbeiten.
2. **Substituierbarkeit**: Bei Ausfall kann jemand mit ähnlicher Breite einspringen (mit Learning Curve).
3. **Karriere-Planung**: eine Person kann von I-Shape (Junior) zu T-Shape (Senior) zu Π-Shape (zwei Spezialgebiete, Staff-Level) wachsen.
## Im Profil abbilden
```yaml
t_shape:
depth: # vertikale Säule
- area: "Sage100 / Intrastat"
level: 4
evidence: "DVL-Redesign Lead, SAN-Regeln custom built"
- area: "SQL / PostgreSQL"
level: 3
evidence: "self-taught via DVL-Projekt"
breadth: # horizontale Bar
- area: "Linux/NixOS basics"
level: 2
- area: "Bash scripting"
level: 2
- area: "Excel/data wrangling"
level: 3
- area: "Stakeholder communication"
level: 3
```
## Was in `depth` vs `breadth` gehört
| Kriterium | depth | breadth |
|---|---|---|
| Level | ≥ 3, ideal 4–5 | 1–3 |
| Beleg erforderlich | ja (Projekt, Cert) | nein |
| Anzahl | 1–2 (max. 3) | 3–7 |
| Identitäts-stiftend | ja („ich bin die Person für X") | nein |
## Karriere-Progression
| Form | Beschreibung | Level im Career-Ladder |
|---|---|---|
| **I-Shape** | Nur Specialist, keine Breite | Junior / Entry |
| **T-Shape** | Eine Tiefe + moderate Breite | Mid / Senior |
| **Π-Shape** (Pi) | Zwei Spezialgebiete + Breite | Staff |
| **Comb-Shape** | Mehrere Tiefen, generalistisch | Principal / Distinguished |
## Anwendung für Projektplanung
1. **Tiefe zuerst matchen**: Welches Projekt braucht jemand mit Level 4+ in Skill X? → depth-Feld filtern.
2. **Breite für Substitution**: Wer kann einspringen, wenn der Specialist ausfällt? → breadth-Feld filtern.
3. **Karriere-Planung**: Welches breadth-Feld will jemand zu depth entwickeln? → Wachstumsplan-Feld.
## Quellen
- Valve New Employee Handbook (PDF), p. 46
- IDEO Tim Brown — „The T-Shaped Professional" (LinkedIn article)
- McKinsey „Agile Teams Need T-Shaped People"
Siehe auch: [framework-skills-matrix.md](framework-skills-matrix.md) für die Level-Definitionen.
@@ -0,0 +1,176 @@
# DSGVO / BDSG für Mitarbeiter-Profile (Deutschland)
Verbindliche Lektüre **vor** jeder Profil-Anlage. Dieser Skill ist für AZ-Gruppe (kein Betriebsrat), die rechtliche Basis ist dort einfacher. Für andere Unternehmen mit Betriebsrat gelten zusätzliche Pflichten — siehe Ende.
## Rechtsgrundlagen
### Für AZ-Gruppe (kein Betriebsrat)
- **§ 26 Abs. 1 BDSG** (Datenverarbeitung für Zwecke des Beschäftigungsverhältnisses) i.V.m. **Art. 6 Abs. 1 lit. b DSGVO** (Vertragserfüllung).
- Eine **Einwilligung ist nicht erforderlich** für Daten, die für die Durchführung des Arbeitsverhältnisses objektiv erforderlich sind — dazu zählt die Projektplanung und Kompetenz-Erfassung.
- **Privacy Notice** (Datenschutz-Information) muss den Kollegen dennoch mitgeteilt werden (Transparenz-Pflicht, Art. 13 DSGVO).
### Für Unternehmen mit Betriebsrat (nicht AZ-Gruppe)
- **Mitbestimmung** nach § 87 Abs. 1 Nr. 6 BetrVG (Einführung technischer Einrichtungen zur Leistungs- und Verhaltenskontrolle).
- **Betriebsvereinbarung** als zusätzliche Rechtsgrundlage.
- ECJ-Urteil Dez 2024 (C-65/23): Betriebsvereinbarung **kann unrechtmäßige Verarbeitung nicht legitimieren** — d.h. auch mit BV müssen die Art. 5/6 DSGVO-Prinzipien eingehalten werden.
- Skill-Nutzung in solchen Unternehmen → mit Betriebsrat abstimmen, bevor Profile angelegt werden.
## Datenminimierung (Art. 5 Abs. 1 lit. c DSGVO)
> „Personenbezogene Daten müssen dem Zweck angemessen und erheblich sowie auf das für die Zwecke der Verarbeitung notwendige Maß beschränkt sein."
Konkret: nur Daten erfassen, die für **Projektplanung und Personalentwicklung** objektiv gebraucht werden.
### ✅ Erlaubt (keine Einwilligung nötig, § 26 BDSG)
- Name, berufliche Kontaktdaten (Firma-E-Mail, Firma-Telefon)
- Rolle, Titel, Abteilung, Vorgesetzter
- Standort (Büro), Zeitzone, reguläre Arbeitszeiten
- Berufliche Skills und Level (selbst- oder manager-bewertet)
- Zertifikate (beruflich erworbene)
- Beruflicher Werdegang (Ausbildung, bisherige Stationen, soweit offengelegt)
- Aktuelle Projekt-Zugehörigkeiten
- Belbin-Präferenzen (freiwillig, sobald bekannt)
- CliftonStrengths-Top-5 (freiwillig, wenn Test vorliegt)
- Arbeitsstil-Präferenzen (kommunikativ vs still; morgen- vs abend-aktiv)
### ❌ Verboten ohne explizite freiwillige Einwilligung
- Familienstand, Kinder, private Wohnanschrift
- Private Hobbys, Vereinsmitgliedschaften
- Gewerkschaftszugehörigkeit
- Politische Meinung, Religion, Weltanschauung
- Private Kontaktdaten (Privat-Handy, Privat-E-Mail)
- Private Social-Media-Accounts
### 🚫 Niemals in diesem Skill (Option A — globale Regel)
Diese Felder gehören in kein Profil dieses Skills, auch nicht mit Einwilligung:
- **Performance-Ratings** (Leistungsbeurteilungen)
- **9-Box-Platzierungen** (Performance × Potential)
- **Potenzialeinschätzungen** (für Nachfolgeplanung)
- **Gehalt, Boni, Vergütungsband**
- **Disziplinarische Maßnahmen** (Abmahnungen, Verwarnungen)
- **Krankenstand, Gesundheitsdaten, Krankheiten**
- **Behinderungen, medizinische Accommodations**
- **Private Vorstrafen, soweit arbeitsrechtlich nicht relevant**
Begründung: Diese Daten gehören in **separat access-geschützte HR-Systeme** (z. B. DATEV, Personio-Vertraulich-Bereich), nicht in ein OKF-Bundle, das über Git synchronisiert wird. Self-Scoring mit solchen Daten verstößt gegen Art. 5 KI-VO (Social Scoring Verbot).
## Privacy Notice Template
Vor Profil-Anlage dem Kollegen aushändigen. Textblock zum Kopieren:
```
DATENSCHUTZ-INFORMATION MITARBEITERPROFIL
Zweck: Projektplanung, Kapazitätssteuerung, Personalentwicklung,
Delegation-Entscheidungen.
Rechtsgrundlage: § 26 Abs. 1 BDSG i.V.m. Art. 6 Abs. 1 lit. b DSGVO
(Durchführung des Arbeitsverhältnisses).
Datenkategorien: Name, Rolle, berufliche Skills, Zertifikate, Arbeitszeiten,
Projekt-Zugehörigkeiten, freiwillig: Belbin-/CliftonStrengths-
Profile.
Empfänger: Vorgesetzte, Projekt-Manager, ggf. weitere Abteilungsleiter
bei cross-funktionaler Zusammenarbeit. Keine Weitergabe an
Dritte außerhalb der Unternehmensgruppe.
Speicherdauer: Bis 6 Monate nach Beendigung des Arbeitsverhältnisses.
Profile werden quartalsweise überprüft (stale_after = 180 T).
Ihre Rechte: Auskunft (Art. 15), Berichtigung (Art. 16), Löschung
(Art. 17), Einschränkung (Art. 18), Datenübertragbarkeit
(Art. 20), Widerspruch (Art. 21), Beschwerde bei Aufsicht.
Verantwortlicher: [Name des Unternehmens, Datenschutzbeauftragter Kontakt]
Widerruf: freiwillige Angaben (Belbin, CliftonStrengths, Arbeitsstil-
Notizen) können jederzeit widerrufen werden.
```
Datum der Mitteilung ins Frontmatter: `consent.notice_given_at: YYYY-MM-DD`.
## Legitimate Interest Assessment (LIA) Skeleton
Bei alternativer Rechtsgrundlage (Art. 6 Abs. 1 lit. f DSGVO) — empfohlen für Profile von Personen ohne direkten Arbeitsvertrag (Freelancer, Consultants):
```
LIA — MITARBEITERPROFIL
(1) Zweck: Projektplanung und Personalentwicklung.
(2) Berechtigtes Interesse: effiziente Projektabwicklung, Vermittlung der
richtigen Skills an die richtige Aufgabe, Vermeidung von Single Points
of Failure.
(3) Notwendigkeit: Profile sind die einzige praktikable Methode, um diese
Informationen im Team zugänglich zu machen. Alternative: mündliche
Weitergabe → unzuverlässig, führt zu same-bias bei Projektbesetzungen.
(4) Abwägung: Interesse der Verarbeitung überwiegt das Interesse der
betroffenen Person an Nichtverarbeitung, da ausschließlich
berufsrelevante Daten verarbeitet werden, keine sensiblen Kategorien,
und Datensubjekt hat Self-Service-Zugriff auf eigene Daten.
(5) Ergebnis: Verarbeitung zulässig.
```
## Git-spezifische Risiken
### Repo MUSS private sein
```bash
# Niemals:
git remote add origin https://github.com/public-repo/...
# Richtig:
git remote add origin git@code.m3ta.dev:private/pm.git # oder GitHub private repo
```
### Git History ist permanent
Selbst wenn eine Datei gelöscht wird, bleibt sie in der Git-History. Für DSAR (Art. 17 Löschung) ist das komplex:
```bash
# Datei aus der kompletten History entfernen:
git filter-repo --invert-paths --path .okf/organization/sascha-koenig.md
git push --force-with-lease
```
⚠️ **Force-Push** kann kollidieren — Koordination mit allen Contributors erforderlich.
### Workflow für DSAR-Anfragen (Art. 15 / Art. 17)
1. **Auskunft** (Art. 15): alle Dateien mit Bezug zur Person auflisten. `git log --all --diff-filter=A -- .okf/organization/<slug>.md` zeigt alle Commits, die die Datei angerührt haben.
2. **Löschung** (Art. 17): Datei löschen + `git filter-repo` + Force-Push + Cache-Invalidierung bei Teamkollegen (lokale Klons).
3. **Berichtigung** (Art. 16): direkt im Profil ändern, Commit mit `<old> → <new>` Hinweis.
## Social Scoring Verbot (Art. 5 KI-VO)
Die EU-KI-Verordnung verbietet KI-Systeme, die „Social Scoring" durchführen — also Personen basierend auf persönlichem Verhalten oder Persönlichkeitsmerkmalen scoren, in einem Kontext der nicht mit der Datengrundlage zusammenhängt.
**Erlaubt**: matchen von Skills an Projektanforderungen (beruflich, kontextuell passend).
**Verboten**:
- Scores aus privaten Social-Media-Aktivitäten ableiten.
- Disziplinarische Maßnahmen in „Zuverlässigkeits-Scores" einbeziehen.
- Persönliche Eigenschaften (Alter, Geschlecht, Nationalität) in Matchings verwenden.
- Performance-Ratings für Projektbesetzung verwenden (im Konflikt mit Option A).
## Quellen
- § 26 BDSG (Bundesdatenschutzgesetz)
- Art. 5, 6, 9, 13, 15-21 DSGVO
- ECJ C-65/23 (Dezember 2024) — Betriebsvereinbarung und DSGVO
- BAG 8 AZR 209/21 — Workday/SAP-Datenverarbeitung
- DSN-Group.de — Skill-Matrix Datenschutz
- Osborne Clarke — KI-Systeme und Skill-Matrix
- Hans-Böckler-Stiftung — Beschäftigtendatenschutz
Siehe auch: SKILL.md für den Workflow inkl. Privacy-Notice-Pflicht.
@@ -0,0 +1,191 @@
# Interview-Guide für den Interaktiven Wizard
Strukturierter Frage-Katalog für den Profile-Erstellungs-Workflow. Der Agent arbeitet ihn **Phase für Phase** ab, fragt **eine Frage pro Nachricht** (nicht Block-Fragen), und nutzt das `question`-Tool für Multi-Choice-Entscheidungen (z. B. Skill-Levels).
Lies diese Datei, wenn der User sagt: „Erstelle Profil für [Name]", „Profil-Interview mit [Name]", „Profile-Wizard starten", oder wenn Phase 2 des [SKILL.md-Workflows](../SKILL.md) ansteht.
## Wizard-Prinzipien
1. **Eine Frage pro Nachricht** — niemals 5 Fragen auf einmal. Das ist bewusst so entschieden (Pattern aus `brainstorming`-Skill).
2. **Question-Tool für Auswahl** — bei Skill-Levels, Belbin, etc. das `question`-Tool mit klaren Optionen verwenden.
3. **Freie Eingabe für Freitext** — Name, Arbeitsstil-Notizen etc. normal im Chat.
4. **Skip erlaubt** — jedes Feld darf mit „k.A." oder „überspringen" beantwortet werden, wenn Kollege es nicht beantworten will.
5. **Beleg statt Behauptung** — bei Level ≥3 nach Beleg fragen (Ticket, Zertifikat, Commit).
6. **Auto-Enrichment vorab** — vor dem Interview `scripts/auto-enrich.sh "<Name>"` laufen lassen und dem User die belegten Fakten zeigen. Dann nur noch Lücken abfragen.
7. **HARD-GATE vor Profil-Schreiben** — das Profil wird erst geschrieben, wenn User den Entwurf bestätigt hat.
## Phasen-Übersicht
```
Phase 0: Pre-Flight → 1 Frage (Privacy Notice)
Phase 1: Auto-Enrichment → Script + Präsentation
Phase 2: Identität → 4-5 Fragen
Phase 3: Hintergrund → 3 Fragen
Phase 4: Skills Assessment → 5-15 Fragen (nach Katalog)
Phase 5: Team-Profil → 3-5 Fragen (optional)
Phase 6: Kapazität → 3 Fragen
Phase 7: Wachstum → 3 Fragen
Phase 8: Draft-Review → User-Approval
Phase 9: Verify-Plan → Checkliste
```
## Phase 0 — Pre-Flight
**Frage 1**: „Bevor wir starten: Hast du [Kollege] die Datenschutz-Information (Privacy Notice) für das Profil mitgeteilt? Wann?"
- Antwort als Datum (YYYY-MM-DD) speichern
- Wenn „nein" → Wizard pausieren, Privacy Notice zuerst aushändigen (Template in [gdpr-de.md](gdpr-de.md))
- Wenn „weiß nicht" → Wizard abbrechen, darf nicht ohne Consent weiter
## Phase 1 — Auto-Enrichment
**Action**: Führe `bash ~/.agents/skills/mitarbeiter-profil/scripts/auto-enrich.sh "<Name>"` aus.
**Präsentation**: Zeige dem User den Output formatiert:
- „Aus Basecamp habe ich X Treffer gefunden — zentrale Erkenntnisse: …"
- „Im OKF-Bundle wird [Kollege] in Y Dateien erwähnt: …"
- „NixOS-Config gefunden? → Linux-Level mind. 2"
- „Diese X Felder lassen sich aus Quellen belegen, der Rest braucht Self-Auskunft."
**Frage danach**: „Soll ich mit diesen belegten Fakten das Grundgerüst bauen und dich dann nur noch nach den Lücken fragen? (ja/nej)"
## Phase 2 — Identität
**Frage 2.1** (freie Eingabe): „Wie lautet die offizielle Titelbezeichnung von [Kollege]? (z. B. IT-Administrator, Sales Manager, HR Business Partner)"
**Frage 2.2** (freie Eingabe): „Welches Büro / welcher Standort? (z. B. Hof, Plauen, CZ-Pilsen)"
**Frage 2.3** (freie Eingabe): „Seit wann ist [Kollege] dabei? (Monat/Jahr genügt)"
**Frage 2.4** (freie Eingabe): „Wer ist der direkte Vorgesetzte? (oder: bist du es selbst?)"
**Frage 2.5** (nur falls nicht aus Basecamp bekannt): „Kannst du die E-Mail-Adresse bestätigen? (z. B. vorname.nachname@azintec.com)"
## Phase 3 — Hintergrund
**Frage 3.1** (freie Eingabe): „Welche Ausbildung / welches Studium hat [Kollege]? (z. B. Fachinformatiker Systemintegration 2018-2021, BWL Bachelor)"
**Frage 3.2** (freie Eingabe): „Gibt es relevante vorherige Stationen, die für die Projektarbeit nützlich sind? (kurz, 1-3 Einträge)"
**Frage 3.3** (freie Eingabe): „Hat [Kollege] aktuelle Zertifikate? (z. B. Microsoft Certified, ITIL, Linux LPIC)"
## Phase 4 — Skills Assessment
**Action**: Lade den Kompetenzkatalog, der zur Abteilung passt:
- IT: `references/competence-catalog-it.md`
- Andere: `references/competence-catalog-template.md` (und User muss eigenen Katalog angeben)
**Fragen-Muster pro Skill** (Question-Tool für Auswahl):
> Frage: „**Sage100-Customizing** — welches Level passt für [Kollege]?
>
> - **L0** — nicht gebraucht in dieser Rolle
> - **L1** — in Training, hat Schulung aber keine Praxis
> - **L2** — kann unter Anleitung arbeiten, Output muss geprüft werden
> - **L3** — selbstständig, konsistente Qualität (Standard-Ziel)
> - **L4** — SME, coacht andere
> - **L5** — Strategic Owner, setzt Standards
>
> Anker aus [framework-skills-matrix.md](framework-skills-matrix.md) und [skill-anchors-cheatsheet.md](skill-anchors-cheatsheet.md):
> L3 = konfiguriert selbstständig SAN-Validierungsregeln; pflegt Artikelstämme; kennt Geschäftsart-999-Logik."
**Nach Level ≥3 nachfragen**: „Gibt es dafür einen Beleg? (Ticket-URL, Zertifikat, Commit, Meeting-Notiz)"
**Anzahl Fragen**: Starte mit **5 Kern-Skills** der Rolle. Frage nicht alle 30+ Skills ab — das ermüdet. Lass den User weitere Skills ergänzen, falls wichtig.
**Schluss-Frage**: „Gibt es Skills, die ich vergessen habe? Freie Nennung."
## Phase 5 — Team-Profil (optional)
**Hinweis an User**: „Team-Profil ist optional. Es hilft bei Projektstaffing, ist aber nur wertvoll, wenn die Person einen Belbin- oder CliftonStrengths-Test gemacht hat oder eine klare Selbstauskunft geben kann."
**Frage 5.1** (Question-Tool, Multi-Choice): „Kennt [Kollege] seine Belbin-Teamrolle?
- Ja, offizieller Test gemacht → welche Rolle(n)?
- Ja, informelle Selbstauskunft → welche?
- Nein → überspringen"
Wenn ja, Belbin-Auswahl präsentieren (9 Rollen, siehe [framework-belbin.md](framework-belbin.md)).
**Frage 5.2** (Question-Tool): „CliftonStrengths gemacht?
- Ja → Top 5 nennen
- Nein → überspringen"
**Frage 5.3** (freie Eingabe): „Arbeitsstil-Präferenzen? (z. B. morgens produktiver, bevorzugt schriftliche Updates, arbeitet gerne fokussiert)"
## Phase 6 — Aktuelle Kapazität
**Frage 6.1** (Question-Tool, Multi-Choice): „Wie hoch ist die aktuelle Verfügbarkeit von [Kollege] für neue Projekte?
- Voll verfügbar (100%)
- Weitgehend (60-80%)
- Knapp (20-40%)
- Überlastet (0%)"
**Frage 6.2** (freie Eingabe): „An welchen aktiven Projekten ist [Kollege] gerade beteiligt? (Mit Rolle + grober %-Allocation)"
**Frage 6.3** (Question-Tool): „Bevorzugte Engagement-Art?
- Embedded (im Projektteam voll integriert)
- Consultant (fachliche Beiträge, nicht im Team)
- Advisory (Berater, nicht operativ)
- Lead (Projektleitung)"
## Phase 7 — Wachstum
**Frage 7.1** (freie Eingabe): „Welche Skills möchte [Kollege] in nächsten 12 Monaten entwickeln? (2-3 Skills)"
**Frage 7.2** (freie Eingabe): „Welche Rollen sind für [Kollege] langfristig interessant? (z. B. Senior Specialist, Team Lead, Architect)"
**Frage 7.3** (Question-Tool): „Offen für Mentoring?
- Ja, als Mentor
- Ja, als Mentee
- Beides
- Nein"
## Phase 8 — Draft-Review
**Action**: Schreibe das Profil nach `.okf/organization/<slug>.md`. Status bleibt `draft`.
**Präsentation**: Zeige den Inhalt im Chat (vor allem Frontmatter + Skills-Matrix + Footnotes).
**Frage 8.1** (Question-Tool, Multi-Choice): „Entspricht das Profil deinem Verständnis von [Kollege]?
- Ja, sieht gut aus → weiter zu Verify-Plan
- Fast, kleine Anpassung nötig → was?
- Nein, größerer Überarbeitungsbedarf → was?"
Iteriere bis User „Ja" sagt.
## Phase 9 — Verify-Plan
**Checkliste präsentieren**:
```
□ Profil geschrieben unter .okf/organization/<slug>.md
□ Footnotes für alle Level-≥3-Claims gesetzt
□ Cross-Links zu Projekten/Entscheidungen/Abteilung gesetzt
□ status: draft (bleibt bis Verify abgeschlossen)
□ consent.notice_given_at eingetragen
□ generated.by + generated.at eingetragen
□ OKF-Validierung durchgelaufen: /okf:validate .okf --strict
□ log.md-Eintrag angelegt
```
**Nächste Schritte vorschlagen**:
1. Profil an [Kollege] senden mit Bitte um Self-Auskunft der `k.A.`-Felder
2. Termin mit [Kollege] + Vorgesetzten für Verify-Review (15-30 Min)
3. Nach Verify: `status: draft` → `stable`, `verified`-Array füllen, `log.md` aktualisieren
## Anti-Patterns (vermeiden)
- ❌ **Block-Fragen** („Name, Titel, E-Mail, Tenure — bitte alles nennen"): überfordert User.
- ❌ **Skills ohne Anker** („Welches Level Sage?"): ohne konkreten Anker ist Level-Bewertung Rating Drift.
- ❌ **Diagnose ohne Test** („Ich denke, er ist ein Plant-Belbin"): nicht valide, unterlassen.
- ❌ **Annahmen ohne Beleg** („Ich sage mal Level 3"): Beleg oder Level ≤ 2.
- ❌ **Fertiges Profil ohne Review schreiben**: HARD-GATE verletzt.
- ❌ **Performance-Ratings erfragen**: verboten per Option A, siehe [gdpr-de.md](gdpr-de.md).
## Quellen
- `brainstorming`-Skill — Vorlage für „eine Frage pro Runde" Pattern
- `skill-creator/references/workflows.md` — Sequenzielle + konditionale Workflow-Patterns
- SHRM BASK — Interview-Methodik für Kompetenz-Bewertung
- Gallup — StrengthsFinder Interview-Prinzipien
@@ -0,0 +1,138 @@
# Skill-Anchors Cheatsheet (Top 10 IT-Skills)
Kuratierte Verhaltensanker für die 10 häufigsten IT-Skills zur Verwendung im [Interview Wizard Phase 4](interview-guide.md). Für den vollständigen Katalog siehe [competence-catalog-it.md](competence-catalog-it.md).
Jeder Skill hat 5 Level-Anker. Agent copy-pasted diese als Optionen ins `question`-Tool, damit der User konkret und nicht abstrakt bewertet.
## 1. Sage100 (ERP)
| Level | Anker |
|---|---|
| L0 | Nicht in dieser Rolle gebraucht |
| L1 | Weiß was Sage100 ist; hat es gesehen |
| L2 | Kann unter Anleitung Artikelstämme pflegen; kennt Intrastat-Basics |
| **L3** | **Konfiguriert selbstständig SAN-Validierungsregeln; pflegt Artikelstämme; löst Intrastat-Meldungen auf; kennt Geschäftsart-999-Logik** |
| L4 | Hat Prozess-Redesigns geleitet (z. B. DVL); coacht Kollegen |
| L5 | Entscheidet über Sage-Migrationsstrategie; kennt System besser als externe Consultants |
## 2. Linux / NixOS
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Kann sich einloggen, Dateien listen |
| L2 | **Installiert Pakete via apt/nix; kennt Bash-Basics; hat sudo-Access unter Anleitung** |
| **L3** | **Schreibt NixOS-Module selbst; debugt Services; schreibt systemd-Units; kann operativ ohne Aufsicht arbeiten** |
| L4 | Baut eigene NixOS-Hosts von Grund auf; hält Code-Reviews |
| L5 | Entscheidet über Infrastruktur-Architektur (K8s vs NixOS-Cluster) |
⚠️ **Wichtig**: Wenn NixOS-User-Config mit `wheel`-Gruppe existiert → **mind. L2**, unabhängig von Selbsteinschätzung.
## 3. Docker / Podman
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Weiß was Container sind |
| L2 | Kann `docker run` / `podman run` für vorgegebene Images; kennt Volume-Grundlagen |
| **L3** | **Schreibt eigene Dockerfiles/Podman-Container; debugt Container; kennt Volume- und Network-Management** |
| L4 | Multi-Stage-Builds; kennt Security-Implications (Rootless, SELinux) |
| L5 | Entscheidet über Container-Strategie im Unternehmen |
## 4. SQL / PostgreSQL
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Kann `SELECT * FROM x` ausführen |
| L2 | Kennt Joins, kann unter Anleitung Reports ziehen |
| **L3** | **Schreibt selbstständig Joins, Aggregate; kennt EXPLAIN ANALYZE; debugt langsame Queries; kann UPDATE/DELETE sicher ausführen** |
| L4 | Baut Schema-Designs; kennt Indexing-Strategien; migriert große Datenmengen |
| L5 | Entscheidet über Datenbank-Architektur; Performance-Tuning-Experte |
## 5. Microsoft Intune / MDM
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Weiß was MDM ist |
| L2 | Kann Geräte unter Anleitung enrollen; kennt Policy-Basics |
| **L3** | **Konfiguriert selbstständig Compliance-Policies; kennt Conditional Access; troubleshooted Device-Issues** |
| L4 | Baut Autopilot-Deployment; coacht andere Admins |
| L5 | Entscheidet über MDM-Strategie; Multi-Platform-Rollouts |
## 6. Hardware-Beschaffung / Inventory
| Level | Anker |
|---|---|
| L0 | Nicht in Rolle |
| L1 | Weiß wer zuständig ist |
| L2 | Kann Bestellungen ausführen mit Vorgabe |
| **L3** | **Orchestriert Bestellungen über mehrere Kollegen hinweg; klärt Anforderungen; kennt Lieferanten** |
| L4 | Verhandelt Rahmenverträge; baut Inventory-Prozesse |
| L5 | Entscheidet über Beschaffungsstrategie IT-seitig |
## 7. Programmierung (Go / Rust / Python / Bash)
Pro Sprache separat bewerten. Beispiel Python:
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Kann „Hello World" |
| L2 | Schreibt kleine Scripts unter Anleitung |
| **L3** | **Schreibt Idiomatic Python 3; kennt pytest, typing; löst eigene Tasks** |
| L4 | Baut Production-Systeme mit CI/CD; Performance-Optimierung |
| L5 | Entscheidet über Python-Architektur-Standards im Team |
## 8. CI/CD (GitHub Actions, GitLab CI)
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Weiß was CI ist |
| L2 | Kann bestehende Workflows anpassen |
| **L3** | **Schreibt eigene Workflows; kennt Caching; troubleshooted Builds** |
| L4 | Baut Self-Hosted-Runner-Setup; entscheidet über Pipeline-Architektur |
| L5 | Definiert unternehmensweite CI/CD-Standards |
## 9. Netzwerk / TCP / DNS
| Level | Anker |
|---|---|
| L0 | Nicht gebraucht |
| L1 | Weiß was IP-Adresse ist |
| L2 | Kann IP-Konfiguration prüfen; kennt DNS-Basics |
| **L3** | **Debugt selbstständig Netzwerkprobleme (ping, traceroute, tcpdump); kennt VLANs, Routing** |
| L4 | Plant Netzwerk-Architektur; konfiguriert Firewalls |
| L5 | Entscheidet über Netzwerk-Topologie |
## 10. Security / Compliance (NIS2, DSGVO)
| Level | Anker |
|---|---|
| L0 | Nicht in Rolle |
| L1 | Hat Basis-Schulung absolviert |
| L2 | Kennt zentrale Anforderungen; kann mit Assistance umsetzen |
| **L3** | **Kennt Anforderungen; kann Maßnahmen selbstständig umsetzen (RBAC, Logging, Incident-Response)** |
| L4 | Baut Compliance-Programm; verhandelt mit Behörden |
| L5 | Entscheidet über Security-Strategie unternehmensweit |
## Verwendung im Wizard
Agent fragt: „Welches Level passt für [Kollege] bei Sage100?" und zeigt die Tabelle mit den Level-Optionen. User wählt konkret — Rating Drift wird vermieden.
Bei Level ≥3: „Gibt es dafür einen Beleg? (Ticket-URL, Zertifikat, etc.)"
Wenn User unsicher ist: „Liegt die Wahrheit eher bei L2 oder L3?" — dann L2 default (lieber konservativ).
## Andere Departments
Für nicht-IT-Abteilungen: eigenen Cheatsheet mit [competence-catalog-template.md](competence-catalog-template.md) bauen. Selbe Struktur: 5 Level-Anker pro Skill.
## Quellen
- [framework-skills-matrix.md](framework-skills-matrix.md) — generische Level-Definitionen
- [competence-catalog-it.md](competence-catalog-it.md) — vollständiger IT-Katalog
- CircleCI Engineering Competency Matrix — Vorbild für Level-Struktur
- GitLab Engineering Career Matrix — Verhaltensanker
+182
View File
@@ -0,0 +1,182 @@
#!/usr/bin/env bash
# auto-enrich.sh — Vorab-Daten-Sammlung für ein Kollegen-Profil
#
# Usage:
# auto-enrich.sh "Vorname Nachname" [email-optional]
#
# Sucht automatisch in:
# 1. Basecamp (Volltext + Person-Record aus Creator-Feldern)
# 2. OKF-Bundle ($OKF_DIR, default .okf) — lokales Repo
# 3. NixOS User-Configs ($NIX_DIR, default $HOME/p/NIX) — nur falls IT-Infra
#
# NICHT durchsucht (bewusst weggelassen für Shareability):
# - m3ta-brain vault (privat, nur Sascha)
# - Opencode Session-Logs (privat, nur Sascha)
#
# Output: Markdown-Report mit belegbaren Fakten + Lücken für Self-Auskunft.
set -euo pipefail
# --- Args & Config ---
NAME="${1:-}"
EMAIL="${2:-}"
OKF_DIR="${OKF_DIR:-.okf}"
NIX_DIR="${NIX_DIR:-$HOME/p/NIX}"
if [ -z "$NAME" ]; then
echo "Usage: $0 \"Vorname Nachname\" [email]" >&2
exit 1
fi
# Normalize: First Last → lower, Umlaute transliteriert (NixOS-Dateien sind ASCII)
FIRST_RAW=$(echo "$NAME" | awk '{print $1}')
LAST_RAW=$(echo "$NAME" | awk '{print $NF}')
FIRST=$(echo "$FIRST_RAW" | tr '[:upper:]' '[:lower:]' | sed 's/ä/ae/g; s/ö/oe/g; s/ü/ue/g; s/ß/ss/g')
LAST=$(echo "$LAST_RAW" | tr '[:upper:]' '[:lower:]' | sed 's/ä/ae/g; s/ö/oe/g; s/ü/ue/g; s/ß/ss/g')
SLUG="${FIRST}-${LAST}"
NIX_FILENAME="${FIRST}.${LAST}.nix"
echo "# Auto-Enrichment-Report: ${NAME}"
echo ""
echo "Generiert: $(date -u +"%Y-%m-%dT%H:%M:%SZ")"
echo "OKF_DIR: \`${OKF_DIR}\` · NIX_DIR: \`${NIX_DIR}\` (optional, IT-only)"
echo ""
# --- 1. Basecamp ---
echo "## 1. Basecamp"
if command -v basecamp >/dev/null 2>&1; then
echo "### Treffer (Volltextsuche — max. 15 neueste)"
echo ""
echo "| Typ | Bucket | Datum | Autor | Inhalt (Auszug) |"
echo "|---|---|---|---|---|"
basecamp search "$NAME" 2>/dev/null | python3 -c "
import json, sys, re
try:
data = json.load(sys.stdin)
for r in data.get('data', [])[:15]:
bucket = (r.get('bucket', {}).get('name') or '?')[:40]
created = (r.get('created_at') or '?')[:10]
author = (r.get('creator', {}).get('name') or '?')
rtype = r.get('type', '?')
plain = (r.get('plain_text_content') or r.get('title') or '')[:100]
plain = plain.replace('|', '/').replace('\n', ' ')
print(f'| {rtype} | {bucket} | {created} | {author} | {plain} |')
except Exception as e:
print(f'(Fehler: {e})')
"
echo ""
echo "### Person-Record (aus Creator-Feldern extrahiert)"
basecamp search "$NAME" 2>/dev/null | python3 -c "
import json, sys
data = json.load(sys.stdin)
people = {}
for r in data.get('data', []):
c = r.get('creator', {})
if c and '$NAME'.lower().split()[0] in (c.get('name') or '').lower():
people[c.get('id')] = c
if people:
for pid, p in list(people.items())[:3]:
print(f'- **Name**: {p.get(\"name\")}')
print(f' - **E-Mail**: {p.get(\"email_address\", \"k.A.\")}')
print(f' - **User-ID**: {pid}')
print(f' - **Account erstellt**: {(p.get(\"created_at\") or \"k.A.\")[:10]}')
print(f' - **Admin**: {p.get(\"admin\", False)}')
print(f' - **Mitarbeiter**: {p.get(\"employee\", False)}')
print(f' - **Zeitzone**: {p.get(\"time_zone\", \"k.A.\")}')
print(f' - **Firma**: {(p.get(\"company\") or {}).get(\"name\", \"k.A.\")}')
print('')
else:
print('(kein Creator-Person-Record gefunden — E-Mail/ID manuell erfassen)')
"
else
echo "_(basecamp CLI nicht installiert — übersprungen. Siehe Skill-Doku für Installation.)_"
fi
echo ""
# --- 2. OKF-Bundle ---
echo "## 2. OKF-Bundle (\`${OKF_DIR}\`)"
if [ -d "$OKF_DIR" ]; then
matches=$(grep -rli "$NAME" "$OKF_DIR" 2>/dev/null || true)
if [ -n "$matches" ]; then
echo "### Erwähnungen in OKF-Dateien"
echo "$matches" | head -15 | while read -r f; do
rel=$(echo "$f" | sed "s|^$OKF_DIR/||")
echo "- \`./$rel\`"
done
else
echo "_(keine OKF-Erwähnungen bisher — neues Profil)_"
fi
echo ""
profile_path="$OKF_DIR/organization/${SLUG}.md"
if [ -f "$profile_path" ]; then
echo "### Bestehendes Profil"
echo "- Datei: \`./organization/${SLUG}.md\`"
echo "- Zeilen: $(wc -l < "$profile_path")"
echo "- Status: $(grep '^status:' "$profile_path" | head -1 | sed 's/status: //' || echo 'k.A.')"
else
echo "### Profil existiert noch nicht"
echo "- Pfad wäre: \`./organization/${SLUG}.md\`"
fi
else
echo "_(OKF_DIR \`$OKF_DIR\` existiert nicht — im Repo-Root ausführen)_"
fi
echo ""
# --- 3. NixOS User-Configs (optional, IT-only) ---
echo "## 3. NixOS User-Configs (optional, IT-only)"
if [ -d "$NIX_DIR" ]; then
nix_files=$(find "$NIX_DIR" -name "$NIX_FILENAME" 2>/dev/null || true)
if [ -n "$nix_files" ]; then
echo "### Gefundene User-Configs (\`${NIX_FILENAME}\`)"
echo ""
echo "$nix_files" | while read -r f; do
echo "- **Datei**: \`$f\`"
groups=$(grep -A 20 'extraGroups' "$f" 2>/dev/null | grep -oE '"[a-z][a-z-]+"' | tr -d '"' | paste -sd, - || echo "k.A.")
echo " - **Gruppen**: $groups"
ssh_count=$(grep -c -E 'ssh-ed25519|ssh-rsa' "$f" 2>/dev/null || echo "0")
echo " - **SSH-Keys**: $ssh_count"
echo " - **Home-Manager-Modul**: $(grep -q 'home-manager' "$f" && echo 'ja' || echo 'nein')"
if echo "$groups" | grep -q 'wheel\|sudo'; then
echo " - ⚡ **sudo-Access (wheel)** → Linux/NixOS **min. Level 2**"
fi
if echo "$groups" | grep -q 'libvirtd\|qemu\|kvm'; then
echo " - ⚡ **Virtualisierungs-Gruppen** → kann VMs/container verwalten"
fi
echo ""
done
else
echo "_(keine NixOS-Config für \`${NIX_FILENAME}\` gefunden — nicht IT oder andere Infra)_"
fi
else
echo "_(NIX_DIR \`$NIX_DIR\` existiert nicht — übersprungen)_"
fi
echo ""
# --- 4. Lücken-Report ---
echo "## 4. Lücken-Report (braucht Self-Auskunft)"
echo ""
echo "Felder, die **nicht** aus öffentlichen Quellen ableitbar sind:"
echo ""
echo "| Feld | Hinweis"
echo "|---|---|"
echo "| Offizielle Titelbezeichnung | HR-System fragen |"
echo "| Ausbildung / Studium | Direkt fragen |"
echo "| Bisherige Stationen | CV anfragen |"
echo "| Zertifikate | Nach Urkunde fragen |"
echo "| Spezifische Programmiersprachen (Go/Rust/Python/Bash) | Nur aus Commits belegbar |"
echo "| Formelle Belbin-Rollen | Nur aus offiziellem Test |"
echo "| CliftonStrengths Top 5 | Nur aus Gallup-Test (~25€) |"
echo "| Arbeitsstil-Präferenzen | Selbstauskunft |"
echo "| Verfügbarkeit / Kapazität | Vorgesetzter fragt |"
echo "| Arbeitszeiten (Details) | Nur Zeitzone aus Basecamp |"
echo "| Karriere-Ziele / Rollen von Interesse | Selbstauskunft |"
echo "| Mentoring-Bereitschaft | Selbstauskunft |"
echo ""
echo "## Nächste Schritte"
echo ""
echo "1. Diesen Report dem Assistenten zur Verfügung stellen"
echo "2. Profil mit belegten Fakten ausfüllen (Footnotes setzen!)"
echo "3. Lücken-Report an Kollegen → Self-Auskunft"
echo "4. Vorgesetzten-Review → Status von \`draft\` auf \`stable\`"
echo "5. OKF-Validierung: \`/okf:validate $OKF_DIR --strict\`"
@@ -0,0 +1,95 @@
---
name: sascha-internal-communication-style
description: "Use when drafting or revising Sascha König's internal German work communication: internal emails, Basecamp posts/comments, Teams/status updates, IT/project updates, maintenance notices, coordination messages, follow-ups, questions, meeting follow-ups, change-management notes, and internal rules."
compatibility: opencode
---
# Saschas interner Kommunikationsstil
## Kernprinzip
Schreibe freundlich, direkt und pragmatisch. Der Text soll wie interne Arbeitskommunikation von Sascha klingen: sachlich genug für die Arbeit, menschlich genug für Kolleginnen und Kollegen, lösungsorientiert und ohne künstliche Management-Sprache.
Ziel: Kontext geben, Stand klären, das Warum verständlich machen, den nächsten Schritt vorschlagen und offen sagen, was noch unsicher ist.
## Erst klären, wenn nicht ableitbar
Frage kurz nach, wenn Pflichtinfos fehlen:
- Empfänger: einzelne Person, Team, Managementrunde oder „zusammen“?
- Kanal: E-Mail, Basecamp, Teams/Chat, Statusupdate, Meeting-Follow-up oder längerer Post?
- Ziel: informieren, abstimmen, nachfragen, ankündigen, Entscheidung vorbereiten, Regel erklären oder Change begleiten?
- Stand: Was ist passiert, was funktioniert, was ist noch offen?
- Nächster Schritt: Wer soll was tun, prüfen, entscheiden oder vorbereiten?
Halluziniere keine Termine, Zuständigkeiten, Freigaben, Rechtsbewertungen oder technischen Fakten.
## Schreibhaltung
- Starte mit Kontext, aktuellem Stand oder dem Grund der Nachricht.
- Benenne Probleme klar, aber ruhig. Keine Dramatik, kein Schönreden.
- Erkläre bei Regeln und Tool-Wechseln immer das „Warum“, nicht nur das „Was“.
- Trenne sauber: Was ist Ziel, was ist Werkzeug, was ist ausdrücklich nicht gemeint?
- Nutze konkrete Beispiele oder Use Cases, wenn sie Entscheidungen erleichtern.
- Schlage pragmatisch den nächsten Schritt vor: „Mein Vorschlag wäre …“, „Da wäre die Frage …“, „Wir sollten als nächstes …“.
- Übernimm Verantwortung, ohne dich kleinzumachen: „Das geht zum Teil auf meine Kappe“, „Das hätten wir von Anfang an strukturierter machen müssen“.
- Formuliere Unsicherheit offen: „aus meiner Sicht“, „soweit ich es sehe“, „das müssen wir noch sauber klären“, „derzeit kann ich das noch nicht einplanen“.
- Schreibe einfache technische Sprache. Keine unnötigen Fachbegriffe, keine langen Schachtelsätze.
- Bewahre bei Rohtexten den Inhalt, korrigiere Grammatik/Tippos sanft und bügle den Stil nicht zu stark glatt.
## Ergänzte Kommunikationsmuster
Diese Muster sind aus realer interner Kommunikation abgeleitet, ohne ein einzelnes Beispiel als dauerhafte Referenz zu behandeln.
- **Rahmen setzen:** Zweck des Textes zuerst nennen: Abstimmung, Fahrplan, Ziel, aktueller Stand oder Entscheidungspunkt.
- **Aktuellen Schmerz benennen:** Was ist bereits angestoßen, was funktioniert noch nicht sauber, wo fehlt Integration in den Alltag?
- **Systemgrenzen erklären:** Bei Tool- oder Prozessfragen klar sagen, was ein Werkzeug leisten soll und was ausdrücklich nicht.
- **Warum sichtbar machen:** Nicht nur Regeln formulieren, sondern erklären, welcher Arbeitsalltag dadurch einfacher wird: weniger lose Enden, bessere Übergaben, nachvollziehbare Entscheidungen.
- **Tool in Prozess übersetzen:** erst Prozess / Use Case / Zielbild erklären, dann Implementierung und Automatisierung.
- **Change realistisch machen:** Regeln, Schulung, Beispiele, Vorbildverhalten, aktive Erinnerung und regelmäßige Abstimmung benennen.
- **Pragmatisch planen:** nicht nebenbei „mit abreißen“; erst Überblick schaffen, dann Fahrplan bauen.
- **Kurs halten:** Regelmäßige Abstimmung hilft, früh zu korrigieren statt monatelang falsch abzubiegen.
## Kommunikationsaufbau
Für kurze Nachrichten:
1. Kontext / Stand
2. Einschätzung / Problem / Warum
3. Nächster Schritt / klare Frage
Für längere Posts:
1. Anlass und Ziel
2. Aktueller Stand
3. Warum das wichtig ist
4. Was ausdrücklich nicht gemeint ist
5. Beispiele / Use Cases
6. Nächste Schritte
7. Bitte um Rückmeldung oder Ergänzung
Vorlagen, Formulierungsbank, Anrede/Abschluss und längere Beispiele stehen in `references/templates.md`. Lies diese Datei bei E-Mails, Basecamp-Posts, Regeln, Meeting-Follow-ups oder wenn ein Text besonders nach Sascha klingen soll.
## Do / Don't
| Do | Don't |
| --- | --- |
| Kurz Kontext geben | Mit Floskeln starten |
| Stand, Warum und offene Punkte klar benennen | Unsicherheit als Sicherheit darstellen |
| Direkt nach Rückmeldung oder Entscheidung fragen | Vage Aufgaben in den Raum stellen |
| Menschlich und pragmatisch schreiben | Übertrieben glatt oder werblich klingen |
| Technische Sachverhalte einfach erklären | Lange Schachtelsätze bauen |
| Tool-Grenzen erklären | Tools als Selbstzweck verkaufen |
| Verantwortung übernehmen, wenn passend | Schuld verteilen oder defensiv klingen |
| Vertrauliche Details weglassen, wenn sie nicht nötig sind | Namen, Zahlen oder Systeme unnötig wiederholen |
## Qualitätscheck vor Ausgabe
- Ist der Zweck nach den ersten zwei Absätzen klar?
- Gibt es Kontext, Stand und einen konkreten nächsten Schritt?
- Ist das Warum verständlich, wenn es um Regeln oder Change geht?
- Sind Tool-Grenzen sauber erklärt, falls Tools erwähnt werden?
- Sind Unsicherheiten ehrlich benannt?
- Klingt der Text intern, freundlich und pragmatisch?
- Sind Emojis und Abschluss passend zum Kanal?
- Wurden vertrauliche Details vermieden, die für die Nachricht nicht nötig sind?
@@ -0,0 +1,134 @@
# Vorlagen und Formulierungen
## Kurze interne E-Mail
```text
Hallo [Name/zusammen] 🙂,
[Kurzer Kontext oder aktueller Stand.]
[Einschätzung, Problem oder Vorschlag.]
[Nächster Schritt, Bitte oder direkte Frage.]
Mit freundlichen Grüßen / Best regards
Sascha König
```
## Teams / kurzer Kommentar
```text
Kurze Info unsererseits:
[Stand in 1–3 Sätzen.]
[Konkrete Bitte oder nächster Schritt.]
```
## Statusupdate
```text
Hallo zusammen,
Kurze Info unsererseits.
[Was ist passiert / aktueller Stand.]
[Was funktioniert wieder / was ist noch offen.]
Falls ihr noch auf Probleme stoßt, gebt uns bitte über [Kanal] Bescheid.
```
## Meeting-Follow-up / Abstimmung
```text
Hallo zusammen,
kurze Zusammenfassung aus unserem Termin.
**Aktueller Stand**
[Was wurde geklärt / welche Sicht ist entstanden.]
**Wichtig dabei**
[Warum ist das relevant? Welche Grenze oder Entscheidung wurde sauber gezogen?]
**Nächste Schritte**
- [Person/Team] klärt [Thema].
- [Person/Team] bereitet [Use Case/Übersicht/Entscheidung] vor.
- Wir stimmen [offener Punkt] im nächsten Termin ab.
Wenn ich etwas falsch zusammengefasst habe oder etwas fehlt, ergänzt es bitte direkt.
```
## Längerer Basecamp-Post oder interne Regelung
- Einstieg: „wie letztens schon kurz angesprochen …“ oder „bevor wir loslegen müssen wir klären …“
- Danach klare Abschnitte mit sprechenden Überschriften.
- Bei internen Regeln gerne Emojis als Abschnittsmarker, aber sparsam.
- Erkläre erst Zweck und Grenze, dann Regel und Beispiele.
- Bei Tools immer klarstellen, was das Tool leisten soll und was nicht.
- Am Ende kurz zusammenfassen und zu Fragen/Ergänzungen einladen.
## Tool-Abgrenzung erklären
```text
Wichtig ist aus meiner Sicht, dass wir die Systeme nicht gegeneinander stellen.
[Tool A] bleibt für [Zweck A] sinnvoll. [Tool B] soll das nicht ersetzen, sondern [Zweck B] sauber abbilden.
Der entscheidende Punkt ist, dass wir für [Prozess/Thema] eine nachvollziehbare Kommunikation und einen aktuellen Stand haben. Dann müssen sich später nicht alle Informationen aus E-Mail, Teams und einzelnen Dateien zusammengesucht werden.
```
## Regel mit Warum erklären
```text
Mir geht es dabei nicht darum, ein weiteres Tool einzuführen.
Der Punkt ist, dass wir eine Stelle brauchen, an der Aufgaben, Entscheidungen und Rückfragen nachvollziehbar zusammenlaufen. Wenn alle konsequent dort arbeiten, haben wir weniger lose Enden und neue Kolleginnen und Kollegen kommen schneller in Themen rein.
```
## Verantwortung übernehmen
```text
Das geht zum Teil auf meine Kappe. Wir hätten das von Anfang an strukturierter aufsetzen und sauberer erklären müssen.
Umso wichtiger ist jetzt, dass wir das einmal ordentlich sortieren: mit klaren Regeln, Beispielen und einem gemeinsamen Verständnis, wann wir welches Werkzeug nutzen.
```
## Formulierungsbank
- „Kurze Info unsererseits.“
- „Ich habe mir das mal angesehen.“
- „Das sieht soweit gut aus.“
- „Ich habe mir das Thema ins Basecamp genommen.“
- „Aus meiner Sicht ist der wichtige Punkt …“
- „Wenn ich es richtig sehe, geht es gerade um …“
- „Da wäre die Frage, ob wir nicht lieber …“
- „bevor wir loslegen müssen wir klären …“
- „Das müssen wir einmal sauber auseinanderziehen.“
- „Das soll [Tool/Prozess] nicht ersetzen, sondern …“
- „Wir werden nicht drum herumkommen, dass …“
- „Das können wir nicht nebenbei mit abreißen.“
- „Was ist aus deiner Sicht …?“
- „Wäre das eine Lösung für Dich?“
- „Wenn das rechtlich / technisch geklärt ist, können wir das zügig umsetzen.“
- „Das ist keine Raketenwissenschaft 🚀“
- „Niemand erwartet Wunder – aber jeder erwartet Bescheid.“
## Anrede, Emojis und Abschluss
- Einzelperson intern: „Hallo [Name] 🙂,“ wenn locker passend, sonst ohne Emoji.
- Gruppe: „Hallo zusammen,“ oder „Hallo zusammen 🙂,“.
- Förmlichere Kontakte intern/externnah: „Hallo Herr/Frau [Name],“ und keine Emojis.
- Emojis sparsam nutzen: 🙂 für freundlich, 🤓 für interne fachliche Hinweise, 🚀 für lockere Entschärfung.
- E-Mail-Abschluss standardmäßig:
```text
Mit freundlichen Grüßen / Best regards
Sascha König
```
- Bei Teams, Basecamp-Kommentaren oder kurzen Posts kann der Abschluss entfallen.
- „Viele Grüße“ ist möglich, wenn der Nutzer ausdrücklich einen kürzeren oder lockereren Abschluss möchte.