# Design Spec: <topic>

## Goal

Describe the user-visible goal and why it matters.

## Non-Goals

List what this change intentionally will not do.

## Context

Summarize the CodeMap tools used and the relevant files, symbols, or feature areas found.

## Chosen Approach

Describe the selected design and why it fits the existing codebase.

## Affected Interfaces

List public APIs, schemas, commands, resources, routes, or user-visible behavior that changes.

## Risks and Edge Cases

Describe failure modes, compatibility concerns, and high-risk areas.

## Verification

List the build/test/manual checks that must pass.

## Open Questions

List questions that must be answered before implementation.

