hubraumhugo

The thread on whether AI sessions should be part of the commit (https://news.ycombinator.com/item?id=47212355) got me thinking about documentation more broadly. How do you document when agents write most of the code?

Specs and intent docs (plan.md, Linear ticket, change records) seem to become more important since they're what agents work from. On the other hand, the traditional RFC/architecture docs drifts out of sync faster.

How are you adopting your documentation workflows internally? How do you get feedback on specs before implementation?

What was your best experience as a candidate? Can be about process, questions, or assignments.