Quickstart: Monorepo auf neuem Rechner

1. Repo klonen

git clone https://github.com/DoctoDre/Orchestrator.git
cd Orchestrator

2. Python-Umgebung einrichten

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:

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

cd shared/tools/monorepo-cli
python -m pytest tests/ -x --tb=short -q

F├╝r schnelle Checks (ohne Hypothesis-PBT):

python -m pytest tests/test_e2e_integration.py tests/test_knowledge_cli.py -q

6. Workflow

Neuen Branch erstellen: git checkout -b feat/mein-feature
Arbeiten, committen
Pushen: git push -u origin feat/mein-feature
PR auf GitHub erstellen
Mergen

Nie direkt auf master pushen.

2.2 KiB Raw Blame History