Agent Save File Starter

Ein kompaktes Starter-Template für Coding-Agent-Projekte: Arbeitsregeln, Runbook, Entscheidungen und bekannte Fehler an einem Ort.

Dieses Template ist für Projekte gedacht, in denen Coding Agents regelmäßig am Repo arbeiten.

Die Idee: Der Agent braucht nicht mehr Kontext. Er braucht besseren Kontext.

Struktur

AGENTS.md
RUNBOOK.md
DECISIONS.md
KNOWN_ISSUES.md
ARCHIVE.md

AGENTS.md

# AGENTS.md

## Arbeitsregeln

- Lies relevante Dateien, bevor du Änderungen machst.
- Halte Änderungen klein und nah am Task.
- Revertiere keine fremden Änderungen im Working Tree.
- Führe passende Tests aus oder erkläre, warum das nicht möglich war.

## Gates

- Keine destruktiven Commands ohne explizite Zustimmung.
- Keine Public Actions wie Posts, Mails oder Pushes ohne klare Anfrage.
- Keine breiten Refactors ohne konkreten Auftrag.

RUNBOOK.md

# RUNBOOK.md

## Setup

npm install

## Build

npm run build

## Tests

Frontend-Änderungen:
npm run test:web

Content-Änderungen:
npm run build

DECISIONS.md

# DECISIONS.md

## 2026-06-16: Astro Content Collections für Blog und Tools

Status: aktiv

Konsequenz für Agents:
- Neue Blogposts nach src/content/blog legen.
- Neue Tools nach src/content/tools legen.
- Frontmatter-Schema aus src/content.config.ts einhalten.

KNOWN_ISSUES.md

# KNOWN_ISSUES.md

## MDX-Komponenten brechen bei falschen Props

Symptom:
Astro Build bricht beim Prerendering mit undefined.map ab.

Bevorzugter Fix:
- Prop-Namen mit der Komponente abgleichen.
- Komponenten defensiv gegen alte Alias-Props machen, wenn mehrere Drafts betroffen sind.

Pflege-Regel

Alles, was heute nicht mehr gilt, gehört aus den aktiven Dateien raus.

Nicht löschen, wenn Historie wichtig ist. Verschiebe es nach ARCHIVE.md.