In this section: Chapters
- Ch.1: The Day After
- Ch.2: Tribal Knowledge Is the Bottleneck
- Ch.3: Contracts Are the Answer
- Ch.4: The Capabilities Graph
- Ch.5: Extraction Over Refactoring
- Ch.6: The Contract Lifecycle
- Ch.7: The Architect
- Ch.8: The Developer
- Ch.9: The PM / PO
- Ch.10: The Designer
- Ch.11: The Leadership Team
- Ch.12: The Company That Gets There First
- Appendix
- Appendix A: Contract Schema Reference
- Appendix B: Legibility Audit Framework
- Appendix C: Extraction Priority Matrix
The Contract Lifecycle
A contract that's accurate on the day it's written and stale six months later isn't a fix. It's a trap with better packaging than a wiki page, because now everyone trusts it. Chapter 6 is about the part of this model that doesn't show up in a diagram: what keeps a contract true as the capability underneath it keeps changing.
The chapter follows a developer who's new enough to the team that she's never touched the old, undocumented version of the system. She opens a capability's contract before making a change, the way you'd check a map before a trip. What she finds isn't just a description. It's a business rule stated in one sentence, the dependencies it relies on, the things it deliberately doesn't do, and a constraint history that explains why a limit got lowered three years ago. She hands the task to an agent. It comes back with a flagged dependency the contract didn't mention yet. It was right to flag it. She updates the contract before approving the change. Eleven minutes, start to finish.
That's the lifecycle working as intended: not a document that gets written once and forgotten, but something that gets checked, used, and corrected as part of the normal flow of work. The chapter covers what makes that possible technically, what breaks it, and why a contract nobody's pipeline enforces is really just documentation wearing a costume.