Clean Project (Hard Reset)
This skill provides a destructive but thorough way to repair a "broken" development environment by removing all cached artifacts and re-initializing from scratch.
When to Use
- •
uv syncfails repeatedly with resolution errors. - •
trunkreports internal errors that persist aftertrunk install. - •"Ghost" errors occur (failures that don't match the current code).
Workflow
- •
Clean Project Artifacts:
- •Run
make clean. This script typically removes:- •
.venv/ - •
dist/ - •
__pycache__/ - •
.pytest_cache/ - •
.mypy_cache/ - •
.ruff_cache/
- •
- •Run
- •
Clean Tooling Cache:
- •Clear Trunk cache:
trunk clean. - •Clear uv cache:
uv cache clean.
- •Clear Trunk cache:
- •
Re-initialize Environment:
- •Invoke the
setup-dev-envskill to reinstall everything (e.g.,make setup).
- •Invoke the
- •
Verify Health:
- •Invoke the
verifiersubagent (../../agents/verifier.md) to ensure the project is back to a clean, working state.
- •Invoke the
Safety Note
This process is destructive to the local environment but safe for the repository. It will require a full download of all dependencies, which may take several minutes depending on network speed.
Resources
- •Python Development Commands: Common maintenance commands.
- •Trunk CLI Reference: Commands for managing Trunk artifacts.