---
harness:
  origin: generated
  generator: harness-codebase-map
  file_kind: generated_reviewable
  push_policy: full-diff-proposal
  update_policy: skip-if-local-dirty
title: Codebase Conventions
document_type: conventions
profile: <profile-or-unknown>
mapped_at: <YYYY-MM-DD HH:mm>
last_mapped_commit: <sha-or-unknown>
path_scope: <full|fast|focus|paths>
status: active
---

# Codebase Conventions

**Analysis Date:** <YYYY-MM-DD>

## Naming Conventions

- Files: <pattern>
- Classes / functions / modules: <pattern>
- Tests: <pattern>

## Code Organization

- <layering / module / package rules>

## Error Handling

- <observed pattern with path evidence>

## Logging

- <logging pattern and path evidence>

## Configuration

- <configuration pattern and path evidence>

## Database / Persistence Conventions

- <if applicable>

## API Conventions

- <if applicable>

## AI Agent Rules Derived from Conventions

- <practical rule>

## Evidence

- `<path>` — <why it supports the convention>