Lesson 2 of 4 · Free to read
Exercises
Exercises — Technology Selection: ADRs and weighted scoring
Watch & learn
Course video
Course video
Keep a prompt log while you work. Speed without a trail is not a skill — it is luck.
Exercise 1 — Score 3 databases for a sample app
Goal: apply the rubric to Postgres / MySQL / DynamoDB for a small e-commerce backend. Time: 25 minutes Level: foundational
Steps
- Read the rubric in
lesson-plan.md. - Open
learner-artifacts/<name>/scoring.md. - Score each candidate per criterion; sum.
- Write 2 lines on the decision.
Success criteria
- All 3 candidates scored; totals computed; brief justification.
AI prompt hints
- "Critique my scoring. Which criterion did I weight emotionally rather than analytically?"
Solution sketch
Postgres usually wins for traditional e-commerce. Strong learners surface why DynamoDB might fit in a different scenario.
Stretch
- Re-score for a write-heavy IoT app.
Exercise 2 — Write an ADR
Goal: produce a 1-page ADR from Exercise 1's scoring. Time: 30 minutes Level: intermediate
Steps
- Use
code-examples/python/adr_lint/adr-template.md. - Fill all sections, including Reversibility.
- Run
adr_lint(Exercise 3) to check structure.
Success criteria
- All 6 sections present.
- ≥1 negative consequence listed.
AI prompt hints
- "Critique my ADR. What weakness would a senior architect spot?"
Solution sketch
The negative-consequences section is the tell. Vague ones are weak.
Stretch
- Have another learner critique using the Reviewer/Editor persona.
Exercise 3 — Lint an ADR
Goal: run the small adr_lint script on your ADR; fix every issue.
Time: 15 minutes
Level: intermediate
Steps
cd code-examples/python/adr_lint/; install (see README).- Run
python -m adr_lint path/to/adr.md. - Fix every FAIL.
Success criteria
- Linter passes (exit 0).
AI prompt hints
- "Critique my ADR against the standard sections; suggest 3 edits."
Solution sketch
The linter checks: presence of sections, ≥1 negative consequence, a reversibility statement.
Stretch
- Extend the linter with a rule of your own.