Stop Documentation Debt: Industrialize Your ADRs and READMEs with Spec-kit
summary
This live Tools-in-Action session demonstrates using GitHub Spec-kit to industrialize architecture decision records (ADRs) and README/document structure. It shows bootstrapping a standardized docs/ layout tied to code (Clean Architecture + docs/), configuring CI to enforce ADR presence and doc structure (blocking PRs without ADRs), and automating developer experience to reduce cognitive load and protect product value.
AI-written summary · about
chapters (14)
- 0:00Documentation debt
- 1:07Documentation debt issues
- 3:13Spec Driven Development
- 5:18Project architecture
- 6:00Automated validation
- 7:46PR validation scenario
- 10:35PR without ADR
- 12:45Consistency scenario
- 15:13Technical agent ops
- 17:22Full validation workflow
- 18:46Benefits and cycle
- 19:51AI role in intent
- 20:56Emerging tools
- 21:39Q&A
related talks
37mArchitecture Decision Records - How not to get lost in the past
39mDeveloper’s Torment: The Documentation
14mArchitecture Decision Records: Make Peace with Your Docs
37mSpec Driven Development: AI Assisted Coding With Doc at the Core
43mWorking Efficiently with Architecture Decision Records (ADRs)
35mThe Art of Documentation and Readme.md for Open Source Projects
44mPushing documentation (so it doesn't hurt anymore)
35mThe practical implementation of Documentation as Code