learning-it by example

Back to the video

Architecture Decision Records for AI Choices, With a Lint

I planted seven problems in seven decision records for an AI assistant, and a small lint found all seven.

Video #242 ยท Enterprise architecture and AI agents

Steps in the video

  1. 0:00 Seven decision records, and seven problems a lint found
  2. 0:35 The idea
  3. 1:20 Setup
  4. 1:43 Seven records
  5. 2:13 The lint
  6. 2:49 Find, fix, check again
  7. 3:53 What this does not show
  8. 4:29 Mistakes to avoid
  9. 4:54 My take and next steps
  10. 5:25 Recap

Files

  • adrs.py (50 lines)
  • compare.py (22 lines)
  • lint.py (41 lines)

Download the code (zip)

Tested with

Python 3.12.15

What this does not show

Seven records I wrote with seven planted problems; the lint checks form only, not whether a decision or its evaluation is right; today's date is fixed in the code; the script prints and exits 0; the fixes edit records in place; the rules are mine.

Sources

Learning IT by Example.