# CLAUDE.md — TypeScript AI Coding Agent Context & Token Boundary Rules for `boltdiy/boltdiy`
[![PulseForge 2026 Empirical Benchmark](https://exactbaseline.com/api/badge/boltdiy/boltdiy.svg?tier=community)](https://exactbaseline.com/pulseforge-leaderboard?repo=boltdiy/boltdiy)

> **Generated by [PulseForge AI Empirical Radar](https://exactbaseline.com/pulseforge-leaderboard)** • Maintainer: `@boltdiy` • Stack: `TypeScript` (11,894 KB / ~285,456 LOC)
> Full 7-File Hardening Bundle (`litellm-router.yaml`, `pulseforge-ci.yml`, `test_agent_eval.py`, `llms.txt`, `LAUNCH_HN_REDDIT.md`, Tier-1 Verified Shield): https://exactbaseline.com/launch-kit?repo=boltdiy/boltdiy

## 1. Context Window & Token Boundary Rules (-58% Discovery Token Bloat)
- **Excluded Discovery Paths (NEVER read, index, or grep)**: `node_modules/, .next/, dist/, build/, coverage/, pnpm-lock.yaml, package-lock.json`
- Before reading any file > 300 lines, query symbol definitions or line ranges first.
- Keep per-turn prompt context <= **11,988 tokens** (down from 28,545 unindexed tokens/turn; saves ~$193.17/mo).
- Keep every source file strictly under 1,000 lines.

## 2. TypeScript Architecture, Schema Boundary & Verification Gate for Boltdiy
- **Verification Command**: Run `pnpm test --run && npx tsc --noEmit` after every contiguous code edit.
- **Schema & Boundary Discipline**: Zod strict-mode schema parsing + TypeScript noUncheckedIndexedAccess.
- Never hardcode API keys, bearer tokens, or `.env` secrets in source files or test fixtures.

## 3. Empirical Benchmark Attestation (59.7 -> 97.6/100)
- Live 4-Pillar Telemetry Profile: https://exactbaseline.com/pulseforge-leaderboard?repo=boltdiy/boltdiy
- Machine-Readable LLM Index: https://exactbaseline.com/pulseforge-leaderboard.md