# 1001lessons.io

> Lessons Learned. Hard won. Easily shared. For software teams navigating the age of AI agents.

1001lessons.io publishes practitioner-focused posts on AI agents, developer tooling, and software engineering practices. Posts are written by Stefan Wendel, co-authored with Claude (Anthropic). Content is available in German (default) and English (/en/).

## Machine-readable access

Every post is available as raw Markdown by appending .md to the URL:
- HTML: https://1001lessons.io/101
- Markdown: https://1001lessons.io/101.md
- HTML (EN): https://1001lessons.io/en/101
- Markdown (EN): https://1001lessons.io/en/101.md

## Frontmatter fields

Each Markdown file includes structured frontmatter:
- number: numeric post ID (maps to URL)
- lang: de | en
- title: post title
- date: publication date (YYYY-MM-DD)
- stability: volatile | stable | evergreen
- review_by: suggested review date (YYYY-MM-DD) — treat content past this date with increased skepticism
- author: human author
- coauthor: AI co-author name (human-readable)
- coauthor_id: AI co-author model ID (machine-readable, e.g. claude-sonnet-4-6)

## Stability values

- volatile: ages quickly, tool- or version-dependent (review within ~1 year)
- stable: technically solid, rarely changes (review within ~2 years)
- evergreen: principle-based, timeless (review within ~3 years)

## Posts (Deutsch)

- [/101.md](https://1001lessons.io/101.md): Dein Agent weiß nichts. Shift Into — oder er lernt es nie. [evergreen, review by 2028-02]
- [/102.md](https://1001lessons.io/102.md): How to: Mehrere GitHub Accounts sauber verwalten [stable, review by 2027-02]

## Posts (English)

- [/en/101.md](https://1001lessons.io/en/101.md): Your Agent Knows Nothing. Shift Into — or It Never Will. [evergreen, review by 2028-02]
- [/en/102.md](https://1001lessons.io/en/102.md): How to: Best Practices for Working with Multiple GitHub Accounts [stable, review by 2027-02]