# EntityTier

**Kind:** Type

**Source:** [`atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts`](https://github.com/sherkety/atloria/blob/main/atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts#L163)

Entity tiers control how much context is included in AI prompts.
This is how we manage the 32K token limit.

TIER_1: User-facing code -> FULL source code included
        Examples: Controllers, React components, Pages
        Why: These define what users can do

TIER_2: Business logic -> Only signatures + JSDoc
        Examples: Services, Utilities, Helpers
        Why: Implementation details aren't needed for user docs

TIER_3: Data structures -> Names only
        Examples: Types, Interfaces, DTOs
        Why: Users don't care about data shapes

TIER_4: Infrastructure -> EXCLUDED completely
        Examples: Tests, Configs, Migrations
        Why: Not relevant to user documentation

## Definition

```ts
'TIER_1' | 'TIER_2' | 'TIER_3' | 'TIER_4'
```
