Root Hygiene

Do not use this skill for general cleanup unrelated to test/temp/cache behavior.

Rules

1. Treat root clutter as a behavior problem first, not an ignore-file problem.
2. Do not introduce TemporaryDirectory(dir=Path.cwd()) in this repository.
3. For tests, prefer pytest's built-in tmp_path fixture — it routes temp files to a system temp directory outside the repo.
4. Use .gitignore only as a second line of defense after fixing the write location.

Workflow

1. Inspect before editing

git status --short

Also check:

• tests/conftest.py for any temp directory configuration
• pyproject.toml (or pytest.ini) for tmp_path_retention_policy settings

2. Fix the source of root clutter

Common fixes:

• replace TemporaryDirectory(dir=Path.cwd()) with the tmp_path fixture
• route analysis output to explicit analysis_runs/ (already in .gitignore)
• avoid re-enabling pytest cache provider (already disabled via addopts = "-p no:cacheprovider" if configured)

3. Update ignore rules only if needed

Expected ignored local artifacts (already in .gitignore):

• .tmp/
• tmp*/
• .pytest_cache/
• analysis_runs/
• analysis_output*/
• results/
• .worktrees/

4. Verify with focused checks

pytest tests/ -v --tb=short -x
git status --short

Confirm git status shows no new untracked clutter after running tests.

Output Expectations

When reporting the result:

• state which files were causing root clutter
• state which fixture or path policy now owns temp creation
• include the verification commands you ran
• mention any leftover historical temp directories separately from new behavior