pa-10 — References

Doing architecture

  • Building Evolutionary Architectures (Ford, Parsons, Kua) — fitness functions; architecture as a continuously-tested property.
  • Michael Nygard, Documenting Architecture Decisions (the ADR origin)
  • Software Architecture: The Hard Parts (Ford/Richards) — decision records, trade-off analysis, the architect's role.
  • The Software Architect Elevator (Hohpe) — connecting strategy and engineering; influence without authority.
  • Team Topologies (Skelton/Pais) — Conway's Law, paved roads, platform teams (why an architect's leverage is org-shaped).
  • Will Larson, Staff Engineer / An Elegant Puzzle — leading technical work, building consensus, RFCs.

Fitness-function tooling (real)

  • ArchUnit (JVM), import-linter (Python), dependency-cruiser (JS/TS), go vet / depguard / go mod graph (Go) — automated architecture rules in CI.
  • ThoughtWorks Tech Radar (adopt/trial/assess/hold).
  • pa-01 / pa-02 — the analyses packaged here as CI fitness functions.
  • gw-12 — decisions recorded as ADRs, executed as migrations.
  • pa-08 — PR review as change control/consensus.
  • Every lab's docs/analysis.md — the ADR/trade-off habit in practice.