tomevault-io Decision-First Development Workflow
This approach describes how to systematically capture architectural decisions throughout the development lifecycle, integrating decision rationale with artifacts to preserve "why" knowledge for fut...
Instructions
This approach describes how to systematically capture architectural decisions throughout the development lifecycle, integrating decision rationale with artifacts to preserve "why" knowledge for future contributors and AI agents. It implements the traceable decision patterns established in ADR-017.
Principles
- Decision Visibility
- Flow State Respect
- Bidirectional Linking
- Progressive Fidelity
- Agent Awareness
When to Use
- Making architectural choices that will affect multiple components
- Evaluating trade-offs between alternative implementations
- Establishing conventions or patterns for the codebase
- Working with AI agents on complex features requiring context
- Onboarding new contributors who need to understand rationale
Converted and distributed by TomeVault — claim your Tome and manage your conversions.