Autonomous Agent Manifest Specification

Every
Agent.
One File.

KI-Agents vergessen nicht — aber Projektwissen gehört dem Tool, nicht dem Projekt. AAMS gibt deinem Repo Gedächtnis, Struktur und Kontinuität. Eine einzige Datei. Kein Framework. Kein Lock-in.

bash — schritt 1 von 1
$ curl -sO https://raw.githubusercontent.com/DEVmatrose/AAMS/main/.agent.json
→ Jetzt starten Wie es funktioniert ⚑ Bericht erstatten
1
Datei
0
Dependencies
8+
Kompatible Tools
∞
Sessions mit Kontext
40s
Setup-Zeit
Das Problem

Dein Agent vergisst.
Dein Projekt auch.

Tool wechseln — Session 47 ist weg. Teammitglied wechseln — der Kontext geht mit. Das Problem ist nicht, dass Agents vergessen. Das Problem ist, dass Projektwissen nicht dem Projekt gehört.

🔄
Tool-Lock-in

Session-Persistenz lebt in der Cloud des Tools, in deren Format, gebunden an deren Ökosystem. Wechsel das Tool — starte bei Null.

🌀
Kontext-Drift

Bei 5 Sessions erinnerst du dich an alles. Bei 50 entscheidest du Dinge neu, die du vor zwei Monaten entschieden hast. Bei 100 halluziniert dein Agent.

👻
Stammwissen

„Frag Stefan, der weiß das." Das Repo spricht nicht für sich. Kein Audit-Trail. Keine nachvollziehbaren Entscheidungen.

„Ein Repo ohne Agent-Struktur ist wie ein Schiff ohne Logbuch. Jeder weiß, was er gestern getan hat. Niemand weiß, was davor war."
Die Lösung

Der Kern-Loop

AAMS ist kein Tool. Keine Runtime. Kein Framework. AAMS ist ein strukturierter Kontext- und Entscheidungs-Compiler für Agents — verpackt in eine einzige Datei im Repo-Root.

Output
→
Dokumentation
→
Entscheidung
→
Memory
→
neuer Kontext
📋
Workpapers

Jede Session ist ein Markdown-Dokument in WORKING/WORKPAPER/. Zeitgestempelt. Durchsuchbar. Permanent.

🧠
Langzeitgedächtnis

ltm-index.md akkumuliert Kontext über Sessions. Der Agent fragt Memory ab, bevor er handelt.

⚖️
Entscheidungslog

Jede Architekturentscheidung ist nachvollziehbar. git log + grep WORKING/ = vollständiger Audit-Trail.

Das Herzstück

Eine Datei.
Alles drin.

.agent.json in dein Repo-Root. Ein Agent, der diese Datei liest, weiß sofort alles was er braucht.

📄 .agent.json AAMS/1.0
→ Workspace-Vertrag — Wo Dokumentation hingehört, wie Sessions strukturiert sind
→ Gedächtnis-Routing — Wo das Langzeitgedächtnis lebt, wie es abgefragt wird
→ Bootstrap-Regeln — Was der Agent beim ersten Start tun soll, on_session_start, on_first_entry
→ Erlaubnisrahmen — Was er tun darf, was nicht. Kein Akteur. Deterministischer Arbeiter.
Multi-Tool-Bridge

Jedes Tool hat eigene Konventionen. AAMS ersetzt sie alle mit einer Bridge-Datei. Kein CLAUDE.md. Kein GEMINI.md. Kein airules.md.

🌉
AGENTS.md
Wird von allen großen KI-Tools gelesen — Copilot, Cursor, Claude Code, Codex, Windsurf
📖
READ-AGENT.md
Projektkontext und Agent-Vertrag — vollständiger Projektzustand
⚙️
.agent.json
Bootstrap-Regeln und Workspace-Struktur — maschinenlesbar
Copilot Cursor Claude Code Codex Windsurf Aider Continue.dev Firebase Studio
AAMS in freier Wildbahn

Projekte mit AAMS

Von autonomen Agent-Frameworks bis zur Festival-Website. Projekte die zeigen, was möglich ist wenn ein Repo für sich selbst spricht.

AAMS
Die Spezifikation selbst — dogfooding seit Tag 1. Der Standard angewandt auf sich selbst.
„Ein Repo ohne Agent-Struktur ist wie ein Schiff ohne Logbuch."
github.com/DEVmatrose/AAMS →
MantisClaw
Autonomes Agent-Loop-Framework mit emergenter Identität — AAMS als strukturierter Körper.
„AAMS gibt dem Agent einen Körper. MantisClaw gibt ihm ein Gehirn."
github.com/DEVmatrose/MantisClaw →
MantisNostr
Mesh-Netzwerk-Schicht für autonome Agenten über das Nostr-Protokoll.
github.com/DEVmatrose/MantisNostr →
Mantis-OS
Autonomes Agenten-Betriebssystem — MantisClaw + MantisNostr als vollständiger Knoten.
github.com/DEVmatrose/Mantis-OS →
Ocelot-Social-aams
9 Whitepapers, Upgrade-Simulator — Zero-Code-Analyse mit AAMS-Agent-Workflow.
„Kein Quellcode verändert. Nur AAMS ausgeführt."
github.com/ogerly/Ocelot-Social-aams →
pax
PAX Festival 2026 — Event-One-Pager, entwickelt mit AAMS-Agent-Workflow.
github.com/ogerly/pax →
druid
Keltische Entdecker-App mit Karte, POIs und GPS-Tracking — AAMS als Entwicklungs-Workflow.
github.com/ogerly/druid →
→ Showcase ansehen & Projekt eintragen
Feldbericht

Du hast
AAMS
benutzt?

Was hat funktioniert? Was nicht? Welches Tool, welche Session-Größe, welches Projekt? Echte Berichte aus der Praxis machen den Standard besser.

⚑ Bericht als Issue einreichen

// Was interessiert uns?

01 Tool + Setup: Welchen Agent, welches Projekt-Setup hast du verwendet?
02 Was lief gut: Wo hat AAMS echten Nutzen gebracht?
03 Was hat gefehlt: Edge Cases, fehlende Felder, unklare Regeln?
04 Dein Repo: Optional — direkt als Showcase eintragbar.
Loslegen

40 Sekunden.
Eine Datei.

Kein npm install. Kein pip install. Kein Framework.

01
Datei laden
curl lädt .agent.json direkt in dein Repo-Root. Das ist alles. Eine einzige Datei.
02
Agent sagen
Dem Agent mitteilen: Read .agent.json and execute agent_contract.on_first_entry. Kein weiterer Setup.
03
Agent arbeitet
Der Agent erstellt WORKING/, scannt das Repo, schreibt das erste Workpaper. Fertig.
Schritt 1 — die einzige Datei die du brauchst
$ curl -sO https://raw.githubusercontent.com/DEVmatrose/AAMS/main/.agent.json
→ Zum GitHub-Repo Bootstrap-Prompts → Spezifikation →