Perform a "hard reset" of the development environment. Use when dependencies are corrupted, lockfiles are out of sync, or environment tools (Trunk/pnpm) are in an inconsistent state.
666 stars
0 votes
0 copies
1 view
Added February 8, 2026
developmentnode
Works with
cli
Security analysis
B77/100
highPerforms destructive filesystem operations
mediumInstalls packages at runtime which could introduce malicious dependencies
Installs into .claude/skills of the current project.
Are you the author of Clean Project?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/majiayu000-clean-project)
---
name: clean-project
description: Perform a "hard reset" of the development environment. Use when dependencies are corrupted, lockfiles are out of sync, or environment tools (Trunk/pnpm) are in an inconsistent state.
---
# 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
- `pnpm install` fails repeatedly with checksum or resolution errors.
- `trunk` reports internal errors that persist after `trunk install`.
- "Ghost" errors occur (failures that don't match the current code).
## Workflow
1. **Clean Dependencies**:
- Recursively delete `node_modules`: `find . -name "node_modules" -type d -prune -exec rm -rf '{}' +`.
- Remove global lockfile: `rm pnpm-lock.yaml`.
2. **Clean Tooling Cache**:
- Clear Trunk cache: `trunk clean`.
- Prune pnpm store: `pnpm store prune`.
3. **Re-initialize Environment**:
- Invoke the `setup-dev-env` skill to reinstall everything.
4. **Verify Health**:
- Invoke the `verifier` subagent ([../../agents/verifier.md](../../agents/verifier.md)) to ensure the project is back to a clean, working state.
## 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
- [pnpm Commands for Node.js](../common-references/pnpm-commands.md): Common pnpm maintenance commands.
- [Trunk CLI Reference](../common-references/trunk-commands.md): Commands for managing Trunk artifacts.
