Health-check and repair your project

CRAFT Tutorials · Advanced

CRAFT can give your project a quick checkup — confirming the framework is intact and your work is safe — and fix the small, safe things on the spot. It’s the reassuring “is everything okay?” button, handy after an upgrade or any time something feels off.

What the health-check looks at

The check makes sure the two halves of your project are in good order:

  • The framework is whole and unchanged. Confirms the CRAFT Core Files are complete and haven’t been altered.
  • Your work and the framework haven’t gotten mixed up. Catches files that have wandered into the wrong folder.
  • Everything is labelled correctly. Confirms the version and layout are what they should be, so sessions start cleanly.

It’s read-only by default — looking, not changing — so running a check is always safe.

Run a check

Just ask Claude:

›Run a health check on my CRAFT project.

Claude runs through the checks and gives you a plain-English report: what’s healthy, and anything that needs attention.

✓ You’ll know it worked when Claude reports back a clean bill of health — or a short, specific list of anything it found.

Let Claude repair what’s safe

If the check turns something up, you can have Claude fix it — and it handles repairs by how risky they are:

›Run a health check and repair anything that’s safe to fix.
  • Safe fixes happen automatically. Small, clearly-correct repairs are just done.
  • Bigger changes get your okay first. Anything more involved, Claude explains and asks before doing.
  • Risky or destructive changes are refused. Claude won’t do anything that could lose your work — it’ll tell you what it found and leave the decision to you.

✓ You’ll know it worked when Claude confirms what it fixed, lists anything it left for you to decide, and a re-check comes back clean.

When to run it

  • Right after an upgrade — a quick confirmation that the new release settled in cleanly.
  • If a session flags something — when Claude mentions the project looks off at startup.
  • After moving files by hand — if you’ve reorganized folders yourself and want to be sure nothing’s out of place.
  • Every so often — an occasional checkup for peace of mind, like backing up.

That’s the health-check: a safe, read-by-default look at your project, with repairs scaled to how risky they are — automatic for the small stuff, your-call for anything bigger. A good next step: if a check ever points to the framework itself, see Update an existing CRAFT project to reinstall a clean release.

Similar Posts