just-init

Use __init__.py docstrings as the single source of truth for navigating and documenting Python packages.

Read Rule

When navigating to a new directory in the codebase, read its __init__.py to understand the package. The docstring tree tells you what's inside and where.

Subdirectory entries include [start:end] — the line range of that directory's __init__.py docstring. Use these as offset and limit to read only the docstring, not the entire file. This eliminates extra tool calls.

Docstring Format

Every __init__.py must start with a triple-quoted docstring: