AAMS v1.0.0 — One file. Every repo.
AAMS v1.0.0 — Autonomous Agent Manifest Specification
Drop .agent.json into any repo. Every AI agent that reads it creates and follows the same workspace structure — independent of framework, language, or runtime.
What's in v1.0.0
Core Specification
.agent.json — Minimal bootstrap contract (one file, zero dependencies)
AGENTS.md — Universal bridge file read natively by Copilot, Cursor, Claude Code, Codex, Windsurf, Aider, CodeRabbit
READ-AGENT.md — Agent contract (on_first_entry, on_session_start, on_session_end)
SPEC.md — Full normative specification (English + German)
AGENT_SCHEMA.json — JSON Schema for validation
Four-Layer Documentation Model
Workpaper — Session-scoped work documents with file protocol
Whitepaper — Stable architecture truth
Diary — Chronological decision log (temporal context layer)
Memory — Dual-track LTM: ltm-index.md (audit log, in Git) + ChromaDB (vector store, optional)
Cross-Tool Compatibility
No CLAUDE.md, no GEMINI.md, no .windsurfrules needed
One set of files replaces all tool-specific conventions
CodeRabbit recognizes AGENTS.md automatically — no configuration required
Bootstrap Prompts
bootstrap.md — Copy-paste prompts for every situation (session start, LTM query, workpaper creation, session close)
Tool-specific variants for Copilot, Claude, Cursor, Aider, Codex, Windsurf
VS Code workspace snippet (aams-start, aams-close)
Templates
Workpaper, whitepaper, project analysis, and read-agent templates
Whitepapers
WP-001: AAMS Overview
WP-002: Related Work
WP-003: Field Discourse (agent debates, CodeRabbit discovery, Kochbuch-Analogie)
WP-004: Long-Horizon-Reasoning — AAMS as the lowest solvable layer in the LHR stack
Field Reports
Agent Ecosystem Project Verdict
#17 Claude Code Luna-1 (4 months, 30+ sessions) "Vector LTM is the load-bearing component"
#20 Copilot Testcenter by Antigravity Successful adoption
#28 Gemini / Antigravity qa-agent v4 "Mandatory project hygiene, not artificial overhead"
Get Started
curl -sO https://raw.githubusercontent.com/DEVmatrose/AAMS/main/.agent.json
Then tell your agent:
Read .agent.json and execute the full agent_contract.on_first_entry. Start immediately. No confirmation needed.
AAMS/1.0 — One file. Every repo. No more starting from zero.