Skip to content

Glossary · Codebase-aware spec

What is a codebase-aware spec?

A codebase-aware spec is a spec written with the real repository as context, so it names the files, patterns and code a change affects.

In practice

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.

In Annsa, you write one, your own agent writes one over MCP, or Ask writes one when you ask for it.

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.

Put it to work with your agents.

Begin with one agent and the work that matters next.