//
Search across all documentation pages
8 pages in this section.
Agent systems evolve rapidly. Learn why Architecture Decision Records (ADRs) are crucial for documenting high-churn model, framework, and orchestration choices.
Learn architecture decision record (ADR) basics with 8 examples. Draft an ADR for a framework choice, encode decisions, list consequences, and track status.
Use this template to document agent framework selection decisions. Compare options, score candidates, and detail consequences for a commit-ready ADR.
Compare managed gateways like OpenRouter with direct provider integration. Learn to choose the right path for your AI agents, considering cost, compliance, and engineering
Learn to schedule and trigger reviews of agent architecture decisions. Discover what to revisit first, how often, and when to supersede old decisions.
Learn ten best practices for documenting and revisiting architecture decisions, ensuring ADRs remain relevant as systems evolve.