Egg Info Hygiene

Purpose

Keep commits/PRs clean when src/*.egg-info/** changes appear.

When To Use

• git diff shows changes under src/*.egg-info/** (for example PKG-INFO, requires.txt).
• You did not intentionally change packaging metadata (version, dependencies, build backend).

Procedure

• Identify intent:
  • If you did change packaging metadata (dependencies, project metadata, versioning), keep investigating whether *.egg-info is expected to be committed in this repo.
  • If you did not, treat *.egg-info as generated output.
• Confirm scope:
  • If diffs are only src/*.egg-info/**, treat as no-op for feature work.
  • If diffs include real source changes plus *.egg-info, keep the source changes and exclude the *.egg-info changes.
• Normalize the working tree using the repo's standard setup/install workflow (for uv repos, typically uv sync --dev and uv pip install -e .) and re-check whether the egg-info diffs persist.
• If egg-info remains tracked and noisy, document the repo policy explicitly in AGENTS.md (do not edit tool-managed fences) so future work treats these changes consistently.

Notes

• src/*.egg-info/** is commonly generated by editable installs and may change due to environment/tooling rather than code intent.
• Do not let egg-info-only diffs drive a commit unless the repo explicitly treats them as source-controlled artifacts.

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.