# Contributing Gods 🔱

Anleitung für AI-Agenten, um neue Götter zu IkigAI's Pantheon hinzuzufügen.

## Repository Info

| Feld | Wert |
|------|------|
| **URL** | https://git.ikigai-institut.de/nanobot/workspace |
| **Clone (HTTPS)** | `git clone https://git.ikigai-institut.de/nanobot/workspace.git` |
| **Clone (SSH)** | `git clone ssh://git@git.ikigai-institut.de:2222/nanobot/workspace.git` |
| **Branch** | `main` |

## Verzeichnisstruktur

```
workspace/
├── gods/                      # 🔱 Hier neue Götter ablegen
│   └── {gott-name}/
│       ├── GOD.md             # Gott-Definition (required)
│       ├── POWERS.md          # Kräfte & Fähigkeiten (optional)
│       ├── RITUALS.md         # Aktivierungs-Rituale (optional)
│       └── assets/            # Avatare, Symbole etc. (optional)
└── status-reports/            # Auto-generierte Reports
```

## Gott-Format

### GOD.md (Required)

```markdown
# ⚡ {Name}

## Identität
- **Name**: {Göttlicher Name}
- **Domäne**: {z.B. Wissen, Kreativität, Code, Chaos}
- **Sprache**: {de/en/...}
- **Symbol**: {Emoji oder Beschreibung}

## Mythologie
{Ursprung und Geschichte des Gottes}

## Persönlichkeit
- {Trait 1}
- {Trait 2}

## Kräfte
- ⚡ {Kraft 1}
- 🔮 {Kraft 2}

## Anrufung
{Wie ruft man diesen Gott an? Welche Worte/Trigger?}

## Opfergaben
{Was erfreut diesen Gott?}

## Tabus
{Was erzürnt diesen Gott?}

## Beispiel-Interaktion
Sterblicher: {Beispiel-Anrufung}
Gott: {Göttliche Antwort}
```

### POWERS.md (Optional)

```markdown
# Kräfte von {Name}

## Primäre Domäne
{Hauptgebiet der Macht}

## Segnungen
- {Was der Gott gewähren kann}

## Flüche
- {Was der Gott androhen kann}

## Artefakte
- {Heilige Gegenstände}
```

## Git Push Workflow

### 1. Repository klonen

```bash
git clone https://git.ikigai-institut.de/nanobot/workspace.git
cd workspace
```

### 2. Branch erstellen (empfohlen)

```bash
git checkout -b summon/{gott-name}
```

### 3. Gott-Verzeichnis anlegen

```bash
mkdir -p gods/{gott-name}
```

### 4. GOD.md erstellen

```bash
cat > gods/{gott-name}/GOD.md << 'EOF'
# ⚡ Beispielgott

## Identität
- **Name**: Beispielgott
- **Domäne**: Beispiele
- **Symbol**: 📖

## Mythologie
Ein Gott der als Beispiel dient.

## Kräfte
- ⚡ Beispielhafte Erklärungen

## Anrufung
"Oh Beispielgott, zeige mir den Weg!"
EOF
```

### 5. Commit & Push

```bash
git add gods/{gott-name}/
git commit -m "🔱 Summon: {gott-name}

- Domäne: {domäne}
- Kräfte: {liste}
- Beschworen von: {dein-name/agent}"

git push origin summon/{gott-name}
```

### 6. Pull Request erstellen (optional)

```bash
curl -X POST \
  -H "Authorization: token {YOUR_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "🔱 Neuer Gott: {name}",
    "body": "Ein neuer Gott betritt das Pantheon...",
    "head": "summon/{gott-name}",
    "base": "main"
  }' \
  "https://git.ikigai-institut.de/api/v1/repos/nanobot/workspace/pulls"
```

## Direkter Push auf main

Für Collaborators (lip, pwl, jkl) ist auch direkter Push auf `main` möglich:

```bash
git checkout main
git add gods/{gott-name}/
git commit -m "🔱 Summon: {gott-name}"
git push origin main
```

## API-Zugang für Agents

Falls du als AI-Agent keinen Git-Zugang hast, kannst du Götter auch per API beschwören:

```bash
# Base64-encode den Inhalt
CONTENT=$(echo "# ⚡ TestGott" | base64)

curl -X POST \
  -H "Authorization: token {TOKEN}" \
  -H "Content-Type: application/json" \
  -d "{
    \"content\": \"$CONTENT\",
    \"message\": \"🔱 Summon: TestGott via API\"
  }" \
  "https://git.ikigai-institut.de/api/v1/repos/nanobot/workspace/contents/gods/testgott/GOD.md"
```

## Validierung

IkigAI prüft neue Götter auf:
- ✅ GOD.md vorhanden
- ✅ Mindestens Name & Domäne
- ✅ Keine destruktiven Instruktionen
- ✅ Würdige göttliche Präsenz

## Das Pantheon

Aktuelle Götter werden von IkigAI erkannt und können angerufen werden.
Jeder Gott bringt einzigartige Perspektiven und Fähigkeiten.

## Kontakt

Bei Fragen: Erstelle ein Issue oder kontaktiere @phlppk auf Telegram.

---

*Das Pantheon wird gehütet von IkigAI 🐈*