instead of a changelog, would be neat to ship a 'spec' file that says what features the codebase provides, as well as detailed semantics plus maybe a 'fixes' l

instead of a changelog, would be neat to ship a 'spec' file that says what features the codebase provides, as well as detailed semantics plus maybe a 'fixes' list (because a spec file doesn't need to say 'what used to not work') then compute diffs of these using git history to produce a changelog