Save ADRs, Discard Design and Implementation Docs
March 11, 2026
After adoping the obra/superpowers workflow, design docs became an important part of my coding process. They’re detailed and verbose - containing code snippets, specific tasks and implementation procedures, and tests - perfect for handing off to subagents for implementation. But after the feature is built, I couldn’t decide whether to include them as part of my git history or to discard them. 95% of their content will probably never be consumed by either me or LLMs ever again, but they do contain little snippets of historical context that may be important for future architectural decisions.
