What is a codebase-aware spec?
A codebase-aware spec uses the real repository as context. It reflects your file structure, conventions, related modules and existing patterns.
A generic spec says “add an export option.” A codebase-aware one names the file where the setting belongs, the pattern used for similar toggles and the other code it affects.
It isn't generated code. It is still a document for a person or an agent, but it starts from engineering reality instead of a blank page.
Why it matters for product builders
Someone always has to translate a generic spec into the real codebase. That work is easy to miss in a plan and expensive every time it happens.