Train.md
A collection of engineering artifacts, architecture diagrams, and documentation templates designed to help teams build software the right way.
What’s inside
- RFCs & TDDs — gain consensus before writing code
- C4 diagrams — visualize architecture at different zoom levels (Context → Container → Component)
- Sequence diagrams — document how services interact over time
- ADRs — capture why decisions were made
For humans and agents
These artifacts serve two purposes:
- For teams — a shared language for planning, reviewing, and onboarding
- For AI agents — structured context that lets coding assistants understand intent, constraints, and design before generating code
Well-written docs turn AI from “autocomplete” into a knowledgeable teammate.