CompCode Academy

Lesson 2 of 4 · Free to read

Exercises

Exercises — Technology Selection: ADRs and weighted scoring

Watch & learn

Course video

Open on YouTube
System Design Basics: Horizontal vs Vertical Scaling — Architecture trade-offs before you pick a stack.

Course video

Open on YouTube
God-Tier Developer Roadmap — Career framing and skill sequencing.

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

  1. Read the rubric in lesson-plan.md.
  2. Open learner-artifacts/<name>/scoring.md.
  3. Score each candidate per criterion; sum.
  4. 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

  1. Use code-examples/python/adr_lint/adr-template.md.
  2. Fill all sections, including Reversibility.
  3. 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

  1. cd code-examples/python/adr_lint/; install (see README).
  2. Run python -m adr_lint path/to/adr.md.
  3. 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.

New free lessons and course updates. Unsubscribe from any email.