88 lines
2.2 KiB
Markdown
88 lines
2.2 KiB
Markdown
# Quickstart: Monorepo auf neuem Rechner
|
|
|
|
## 1. Repo klonen
|
|
|
|
```bash
|
|
git clone https://github.com/DoctoDre/Orchestrator.git
|
|
cd Orchestrator
|
|
```
|
|
|
|
## 2. Python-Umgebung einrichten
|
|
|
|
```bash
|
|
cd shared/tools/monorepo-cli
|
|
python -m venv .venv
|
|
|
|
# Windows:
|
|
.venv\Scripts\activate
|
|
# Linux/Mac:
|
|
source .venv/bin/activate
|
|
|
|
pip install -e ".[dev]"
|
|
```
|
|
|
|
Danach verf├╝gbar:
|
|
- `ctx-guard` ÔÇö Monorepo-Verwaltungs-CLI
|
|
- `ctx-guard knowledge capture "Notiz"` ÔÇö Quick Knowledge Capture
|
|
|
|
## 3. LLM-Tooling (Kiro / MCP)
|
|
|
|
Das Monorepo nutzt Kiro als primäres LLM-Werkzeug. Die Konfiguration liegt in:
|
|
|
|
```
|
|
.kiro/settings/mcp.json  MCP-Server-Konfiguration
|
|
.kiro/steering/*.md ÔåÉ Verhaltensregeln f├╝r den Agenten
|
|
.kiro/specs/  Feature-Spezifikationen
|
|
```
|
|
|
|
### MCP-Server aktivieren
|
|
|
|
Die MCP-Server werden automatisch erkannt wenn du den Ordner in Kiro ├Âffnest.
|
|
Aktuell konfigurierte Server:
|
|
- **orgmylife-api** ÔÇö Task-/Projektboard-Zugriff
|
|
- **dbctx** ÔÇö DB-interne Wissensbasis und Build-IT-Suche
|
|
- **atlassian-jira** ÔÇö Jira-Anbindung
|
|
|
|
### Steering-Dateien
|
|
|
|
Steering steuert wie Kiro mit dem Repo arbeitet:
|
|
- `workspace-notes.md` ÔÇö Kontextzuordnung, Key Decisions, Pr├ñferenzen
|
|
- `git-path.md` ÔÇö Git-Pfad, Branch-Workflow (PRs, nie direkt auf master)
|
|
|
|
### Ohne Kiro (alternative LLM-Nutzung)
|
|
|
|
Die Knowledge-Pipeline unterst├╝tzt auch LiteLLM als Fallback:
|
|
```bash
|
|
export LLM_PROVIDER=openai # oder anthropic, etc.
|
|
export LLM_MODEL=gpt-4o
|
|
ctx-guard knowledge ingest --context bahn
|
|
```
|
|
|
|
## 4. Secrets
|
|
|
|
Secrets sind NICHT im Repo. Du brauchst:
|
|
- `.secrets`-Datei im Root (manuell anlegen, ist gitignored)
|
|
- Umgebungsvariablen f├╝r API-Tokens (JIRA_API_TOKEN, CONFLUENCE_API_TOKEN, etc.)
|
|
|
|
## 5. Tests laufen lassen
|
|
|
|
```bash
|
|
cd shared/tools/monorepo-cli
|
|
python -m pytest tests/ -x --tb=short -q
|
|
```
|
|
|
|
F├╝r schnelle Checks (ohne Hypothesis-PBT):
|
|
```bash
|
|
python -m pytest tests/test_e2e_integration.py tests/test_knowledge_cli.py -q
|
|
```
|
|
|
|
## 6. Workflow
|
|
|
|
1. Neuen Branch erstellen: `git checkout -b feat/mein-feature`
|
|
2. Arbeiten, committen
|
|
3. Pushen: `git push -u origin feat/mein-feature`
|
|
4. PR auf GitHub erstellen
|
|
5. Mergen
|
|
|
|
Nie direkt auf `master` pushen.
|