update-code-index

/update-code-index

Scans source files for all exported functions, classes, hooks, and components. Generates CODE_INDEX.md organized by capability — a "check before write" safety net.

⚠️ Before writing any new function, check CODE_INDEX.md for existing similar ones. Find a match? Use or extend it. Don't create formatDate2() when formatDate() exists.

---

Instructions

1. Identify source directories

ls -d src/ lib/ app/ core/ 2>/dev/null || true

2. Scan for exports

TypeScript / JavaScript:

grep -rn 'export function\|export const\|export class\|export default' \
  . --include='*.ts' --include='*.tsx' --include='*.js' --include='*.jsx' \
  --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=build --exclude-dir='.next' \
  --exclude-dir=coverage --exclude-dir='.turbo' 2>/dev/null | head -100

Python:

grep -rn '^def \|^async def \|^class ' \
  . --include='*.py' \
  --exclude-dir=__pycache__ --exclude-dir=.venv --exclude-dir=venv --exclude-dir=dist \
  2>/dev/null | head -100

3. Categorize by capability (not by file location)

Group each export by what it does:

Category	Match on name or description
Date / Time	date, time, format, parse, duration, timestamp
Validation	validate, is*, check, verify, sanitize
API clients	fetch, get, post, put, delete, request, client
Auth	auth, login, logout, session, token, permission
Database	db, query, find, create, update, delete, repo
React Hooks	use* exports in .tsx files
Components	PascalCase exports in .tsx / .jsx
Utilities	helper, util, common (catch-all)

4. Write CODE_INDEX.md

Create or overwrite CODE_INDEX.md at the project root:

# Code Index
*Auto-generated by /update-code-index — [TIMESTAMP]*
> Check this before writing new code. Find a match? Use or extend it instead.

## [Category]
- `functionName()` — src/path/to/file.ts:LINE — what it does in one line