ankn
a5f8fb49ab
Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp,
Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit,
Projekt-KIQ-HP, teamlandkarte-mcp
Dhive: Jury-Voting
Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation)
Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more
Shared/references: symphony (read-only)
Bahn repos remain available as independent remotes - this monorepo
pulls them in via subtree, the originals are untouched.
Agent Harness
KI-Tool-unabhängige Steering-Instructions
Dieses Repository definiert wie ein KI-Agent arbeiten soll – unabhängig davon welches Tool ihn antreibt.
Warum?
| Eigenschaft | Vorteil |
|---|---|
| Kein Vendor-Lock | Funktioniert mit OpenCode, Kiro CLI, Claude Code, Copilot, Cursor – jedes Tool das Markdown lesen kann |
| Menschenlesbar | Jeder Entwickler kann die Instructions lesen, verstehen und korrigieren |
| Versioniert | Git-History zeigt wer was wann geändert hat |
| Reviewbar | Änderungen gehen über MR mit Code-Review |
| Teilbar | Teams können den Harness forken und für ihren Kontext anpassen |
| Kein proprietäres Format | Keine .cursorrules, keine Kiro-Skills, kein CLAUDE.md – nur Markdown |
Prinzip
Der Agent ist austauschbar. Die Standards bleiben.
Inhalt
- workflow.md – Git-Workflow, Branching, Repo-Erstellung
- tools.md – Verfügbare CLI-Tools
- testing.md – Unit/Integration/E2E Tests, Testcontainers, Playwright
- planning.md – GitLab Issues, Responsible Vibe Workflow
- documentation.md – Arc42 (12 Kapitel), ADRs, Mermaid C4
- code-review.md – Self-Review mit GitLab Discussions
- merge-request.md – MR-Standards, Conventional Commits
- quality-gates.md – Linter, Trivy, gitleaks, Renovate
- requirements-review.md – Anforderungen prüfen, Fragen stellen
- git-setup.md – Branching, Jira-Referenz, Commit-Prefix
- self-review.md – Pipeline-Überwachung, Fortschritt
- autonomous-mode.md – Autonomer Modus, Entscheidungshilfen
- clean-code.md – Architektur, Clean Code, Observability
- session-notes.md – Arbeitsprotokoll
- project-setup.md – Pflichtdateien, Repo-Struktur
- mcp.json – MCP-Server-Config mit Env-Platzhaltern
Anpassung für ein ART
Dieses Repo ist ein generisches Template. Jedes ART forkt es und ergänzt:
- ART-spezifische Dateien (z.B.
pipeline.md,infrastructure.md,coding-standards.md) - Platzhalter durch eigene Werte ersetzen
- MCP-Server in
mcp.jsonergänzen (z.B. Rollout-Tool, ART-spezifische APIs)
Platzhalter
| Platzhalter | Beschreibung | Beispiel |
|---|---|---|
${ART_NAME} |
Name des ART (GitLab-Gruppe, Namespace-Prefix) | apn, o2c, netz |
${JIRA_PREFIX} |
Jira-Projekt-Key für Branch-/Commit-Referenzen | O2CAAPN, O2CO2C |
${CONTACT_EMAIL} |
Team-Kontakt-E-Mail für scm-info.yaml |
mein-art@deutschebahn.com |
Verwendung
Als Steering-Repo über x-Header an den Orchestrator übergeben:
x-steering-repo: https://git.tech.rz.db.de/${ART_NAME}/playground/agent-harness.git
Der Agent klont das Repo und lädt alle .md-Dateien als Instructions.