async.md:
- add connection pool singleton pattern from follower-weight
- add postgres batch writes with unnest()

pydantic.md:
- add model_validator for side effects (logging setup)

firehose.md:
- replace generic batch example with realistic tap_consumer pattern
- show separate buffers, time-based flushing, pending acks

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

bind validation to types with Annotated + AfterValidator
instead of repeating @field_validator on each schema

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- add diagram showing all components (PDS, Relay, AppView, Feed Generator, Labeler)
- explain each component factually
- show data flow step by step
- remove derivative philosophy, focus on how it works

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>