self-maintaining-claude-md

To keep CLAUDE.md current, this skill appends a reflection todo to your task backlog before work begins, prompting you to update the project instruction file upon task completion. It ensures high-level project state stays aligned without auto-editing the file.

If CLAUDE.md is missing, the skill prompts you to initialize the file rather than creating it automatically. This prevents unauthorized file generation and ensures only user-approved setup changes are recorded at the project root.

A reflection todo helps project documentation management by inserting a reminder at the end of your task list to review and update CLAUDE.md. This ensures high-level project state and instructions are evaluated after every task.

Yes, you can use this workflow across diverse repositories to keep project instructions aligned. It validates the existence of CLAUDE.md at the project root and manages reflection todos regardless of the specific repository setup.

No, the skill does not automatically modify CLAUDE.md. It satisfies prompt-only initialization and explicit reflection todo insertion, ensuring that only user-approved changes are recorded in the project instruction file.

You should trigger the CLAUDE.md validation and reflection todo workflow at project kickoff and whenever starting any new task. This ensures the project instruction file is consistently aligned with high-level state throughout the workflow.