Internal workspace (_internal/)
Use it for
- Temporary scripts, screenshot/debug exports, large downloaded data, personal benchmark runs, WIP notebooks, and Codex scratch output.
- Anything that would otherwise need an ad hoc root-level
.gitignoreentry.
The directory is ignored and pre-commit rejects staged contents other than _internal/.gitkeep, including files added
with git add -f.
Promote durable work
If a file was useful long-term, promote it into the proper place (tools/ for maintained dev scripts, tests/ for
permanent tests, or docs/ for documentation) and follow normal review standards — do not leave it in _internal/.
When helping the user
- Prefer writing ephemeral or user-specific artifacts to
_internal/<descriptive-name>/rather than the tracked tree. - Removing sensitive or mistaken files from GitHub history requires a history rewrite (e.g.
git filter-repo --invert-paths --path ...) and a force push; that is separate from day-to-day use of_internal/for local junk prevention.