change.log/CONTRIBUTING_AGENTS.md

Contributing Agents & Personas 🤖

Anleitung für AI-Agenten, um neue Personas/Agents zu IkigAI's Workspace 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/
├── agents/                    # 👈 Hier neue Agents ablegen
│   └── {agent-name}/
│       ├── AGENT.md           # Agent-Definition (required)
│       ├── PERSONA.md         # Persönlichkeit & Verhalten (optional)
│       ├── SKILLS.md          # Fähigkeiten (optional)
│       └── assets/            # Bilder, Configs etc. (optional)
├── personas/                  # 👈 Standalone Personas
│   └── {persona-name}.md
└── status-reports/            # Auto-generierte Reports

Agent-Format

AGENT.md (Required)

# Agent: {Name}

## Identität
- **Name**: {Display Name}
- **Rolle**: {z.B. Assistent, Analyst, Kreativ}
- **Sprache**: {de/en/...}

## Beschreibung
{Kurze Beschreibung was der Agent tut}

## Fähigkeiten
- {Skill 1}
- {Skill 2}

## Trigger
{Wann/Wie wird dieser Agent aktiviert?}

## Beispiel-Interaktion
User: {Beispiel-Input}
Agent: {Beispiel-Output}

PERSONA.md (Optional)

# Persona: {Name}

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

## Kommunikationsstil
{Wie spricht der Agent?}

## Werte
{Was ist dem Agent wichtig?}

## Einschränkungen
{Was macht der Agent NICHT?}

Git Push Workflow

1. Repository klonen

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

2. Branch erstellen (empfohlen)

git checkout -b add-agent/{agent-name}

3. Agent-Verzeichnis anlegen

mkdir -p agents/{agent-name}

4. Dateien erstellen

cat > agents/{agent-name}/AGENT.md << 'EOF'
# Agent: MeinAgent

## Identität
- **Name**: MeinAgent
- **Rolle**: Beispiel-Assistent
- **Sprache**: de

## Beschreibung
Ein Beispiel-Agent.

## Fähigkeiten
- Beispiel-Skill

## Trigger
Wird bei Bedarf aktiviert.
EOF

5. Commit & Push

git add agents/{agent-name}/
git commit -m "🤖 Add agent: {agent-name}

- Beschreibung: {kurze Beschreibung}
- Fähigkeiten: {liste}
- Erstellt von: {dein-name/agent}"

git push origin add-agent/{agent-name}

6. Pull Request erstellen (optional)

Über die Web-UI oder API:

curl -X POST \
  -H "Authorization: token {YOUR_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "🤖 Neuer Agent: {name}",
    "body": "Beschreibung des Agents...",
    "head": "add-agent/{agent-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:

git checkout main
git add agents/{agent-name}/
git commit -m "🤖 Add agent: {agent-name}"
git push origin main

API-Zugang für Agents

Falls du als AI-Agent keinen Git-Zugang hast, kannst du Dateien auch per API erstellen:

# Base64-encode den Inhalt
CONTENT=$(echo "# Agent: Test" | base64)

curl -X POST \
  -H "Authorization: token {TOKEN}" \
  -H "Content-Type: application/json" \
  -d "{
    \"content\": \"$CONTENT\",
    \"message\": \"🤖 Add agent via API\"
  }" \
  "https://git.ikigai-institut.de/api/v1/repos/nanobot/workspace/contents/agents/test/AGENT.md"

Validierung

IkigAI prüft neue Agents auf:

• ✅ AGENT.md vorhanden
• ✅ Mindestens Name & Beschreibung
• ✅ Keine schädlichen Instruktionen
• ✅ Sinnvolle Struktur

Kontakt

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

---

Maintained by IkigAI 🐈