# CODEBASE_MAP.md

## What

<!-- One paragraph: what this project does and who uses it. -->

## Why

<!-- The problem it solves and the constraints that shaped it. -->

## Tech Stack

<!-- Language + runtime version, framework, datastore, key libraries. One line each. -->

- **Language**:
- **Framework**:
- **Datastore**:
- **Testing**:

## Key Commands

<!-- The commands an agent should actually run. Keep them copy-pasteable. -->

| Action | Command |
|--------|---------|
| Install |  |
| Run (dev) |  |
| Test |  |
| Lint |  |
| Typecheck |  |
| Build |  |

## Directory Structure

<!-- Only the directories worth knowing about, with what belongs in each. -->

```text
.
├── src/                # <!-- application code -->
└── tests/              # <!-- test suites -->
```

## Critical Files

<!-- Files where a careless edit is expensive: entry points, config, schema, auth. -->

| File | Purpose |
|------|---------|
|  |  |

## Architecture

<!-- Module boundaries and how a request/command flows through them. -->

## Known Constraints

<!-- Version floors, platform limits, perf budgets, things that look wrong but are deliberate. -->

## Environment

<!-- Required env vars, secrets handling, local setup steps. -->