Orchestrator/docs/quickstart.md

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

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.