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.
66 lines
2.7 KiB
Markdown
66 lines
2.7 KiB
Markdown
# 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:
|
||
|
||
1. ART-spezifische Dateien (z.B. `pipeline.md`, `infrastructure.md`, `coding-standards.md`)
|
||
2. Platzhalter durch eigene Werte ersetzen
|
||
3. MCP-Server in `mcp.json` ergä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.
|