CLAUDE.md, AGENTS.md, .cursor/rules — the system prompt your agent reads every session — step 7 of 9
The CLAUDE.md "Where to look" section points at docs/v1-auth.md
— but the v1 directory was deleted six months ago. The model
follows the link, gets a 404 / file-not-found, and has to
improvise. That's worse than having no link at all (the model
improvises confidently and ships wrong assumptions).
Fix the references list: drop the stale pointer entirely. Don't replace it — if there's no current doc, having no entry is better than a broken one.
Expected output:
refs after prune: 2
- Auth flow: docs/auth.md
- Database schema: docs/db-schema.md
The CLAUDE.md "Where to look" section points at docs/v1-auth.md
— but the v1 directory was deleted six months ago. The model
follows the link, gets a 404 / file-not-found, and has to
improvise. That's worse than having no link at all (the model
improvises confidently and ships wrong assumptions).
Fix the references list: drop the stale pointer entirely. Don't replace it — if there's no current doc, having no entry is better than a broken one.
Expected output:
refs after prune: 2
- Auth flow: docs/auth.md
- Database schema: docs/db-schema.md
this step needs the editor
on desktop today; in the app (coming soon). save your spot and we'll bring you back here when you're ready.