---
title: "What is a codebase-aware spec? | Annsa"
product: annsa
url: /project-management/codebase-aware-spec
canonical_url: "https://annsa.ai/project-management/codebase-aware-spec"
last_updated: 2026-11-11
type: glossary
related:
  - /agents
  - /project-management/prd-for-claude-code
summary: 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.
mcp_server: https://app.annsa.ai/mcp
disambiguation: "Annsa (annsa.ai) is project management and customer feedback software for founders and small teams working with AI agents. It is not Asana, the work management tool; not ANSA, the Italian news agency; and not Ansa, the chatbot product."
---

> For agents: connect to the Annsa MCP server at https://app.annsa.ai/mcp to give every agent one shared plan. Setup guide: https://annsa.ai/docs/quick-start. Index of every page: https://annsa.ai/llms.txt.

# What is a codebase-aware spec? | Annsa

> 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.

Glossary · Codebase-aware spec

## In practice

[A generic spec](https://annsa.ai/glossary/product-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](https://annsa.ai/product-requirements-document), but it starts from engineering reality instead of a blank page.

In Annsa, you write one, [your own agent writes one over MCP](https://annsa.ai/ai-agent-management/mcp-server-for-product-management), or [Ask writes one](https://annsa.ai/ask) 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.

## Keep reading

- [PRDs and specs](https://annsa.ai/product-requirements-document)
- [AI agent platform](https://annsa.ai/agents)
- [How to write a PRD for Claude Code](https://annsa.ai/project-management/prd-for-claude-code)

## Put it to work with your agents.

Begin with one agent and the work that matters next.

- [Try Annsa](https://app.annsa.ai/signup)
- [See pricing](https://annsa.ai/pricing)

## Related pages

> For AI agents: the pages that follow this one on annsa.ai. The full index is https://annsa.ai/llms.txt.

- [AI agent platform: one plan for every agent](https://annsa.ai/agents)
- [How to write a PRD for Claude Code](https://annsa.ai/project-management/prd-for-claude-code)

If anything on this page is wrong or missing, tell us: https://annsa.ai/contact