CLAUDE.md@tests/evals/fixtures/level-5-autonomous git:20260324.130237bA

Immutable. This exact content never changes and is served at /api/v1/blob/eac1e32e14fd4cbb.

# Autonomous Project

## Commands

- `npm run build` — Compile TypeScript to `dist/`
- `npm test` — Run Jest with coverage (80% threshold)
- `npm run test:watch` — Watch mode for TDD
- `npm run lint` — ESLint check
- `npm run lint:fix` — ESLint auto-fix
- `npm run format` — Prettier format all source
- `npm run format:check` — Prettier check (CI mode)
- `npm run dev` — Dev server with hot reload
- `npm run typecheck` — TypeScript type check without emit

## Architecture

<!-- AUTO:tree -->
scripts/
├── generate-docs-helpers.js  # Helper functions for generate-docs.js.
└── generate-docs.js  # Auto-generate CLAUDE.md sections from source code.
src/
├── routes/
│   ├── health.test.ts
│   ├── health.ts
│   ├── users.test.ts
│   └── users.ts
├── app.test.ts
├── app.ts
└── index.ts
<!-- /AUTO:tree -->

## Key Modules

<!-- AUTO:modules -->
| Module | Purpose | Key Exports |
|--------|---------|-------------|
| `scripts/generate-docs-helpers.js` | Helper functions for generate-docs.js. | `name()` |
| `scripts/generate-docs.js` | Auto-generate CLAUDE.md sections from source code. | `replaceMarkers()`, `validateCrossLinks()`, `buildDocsIndex()`, `checkMarkersAreCurrent()` |
<!-- /AUTO:modules -->

## Critical Gotchas

- TypeScript strict mode is ON — no implicit `any`, null checks required
- Pre-push hook has smart test caching — uses `.test-passed` SHA file to skip redundant runs
- Secret scanning runs on every commit via pre-commit hook
- File size limit is 300 lines per source file — enforced by pre-push hook AND `.claude/rules/code-quality.md`
- Coverage threshold is 80% on branches, functions, lines, and statements

## Quality Gates

- **File size:** 300-line max for source files (enforced by `.claude/scripts/check-file-sizes.js`)
- **Function length:** 50-line max (advisory, in `.claude/rules/code-quality.md`)
- **Coverage:** 80% minimum on all metrics
- **No default exports** (enforced by eslint `import/no-default-export` rule)

## Code Review Checklist

- [ ] Tests written first (TDD)
- [ ] Coverage maintained above 80%
- [ ] No files over 300 lines
- [ ] No hardcoded secrets
- [ ] Types are strict — no `any` casts
- [ ] Named exports only