41e2bfbd70
- CONTRIBUTING_AGENTS.md → CONTRIBUTING_GODS.md - agents/ → gods/ - Göttliche Terminologie: Summon, Domäne, Kräfte, Anrufung - Das Pantheon ist bereit für neue Götter
203 lines
4.1 KiB
Markdown
203 lines
4.1 KiB
Markdown
# 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 🐈*
|