diff --git a/.ai/ai-root-instructions.md b/.ai/ai-root-instructions.md index 938d1ea..1483f9e 100644 --- a/.ai/ai-root-instructions.md +++ b/.ai/ai-root-instructions.md @@ -58,6 +58,20 @@ No work should happen in a session where these instructions have not been loaded --- +## 🔑 Session Reset Command: `-root` + +When the user types `-root` (alone or at the start of a message), you must: + +1. Read `.ai/ai-root-instructions.md` immediately +2. Respond with: `✅ ai-root-instructions.md READ — rules active` +3. Continue with whatever the user asked in the same message (if anything) + +**This command works in any AI tool** — VS Code Copilot, Cursor, Claude.ai, or any other assistant. + +Use case: type `-root` at the start of a session, or any time you suspect the AI has forgotten the rules. + +--- + ## Purpose This document provides guidelines for AI assistants (any LLM) when working on any project. These rules are split into modular instruction files for efficiency. diff --git a/README.md b/README.md index d92863e..9a8b7db 100644 --- a/README.md +++ b/README.md @@ -61,6 +61,23 @@ The AI must be instructed to always read `.ai/ai-root-instructions.md` at the st Verify that every AI response begins with this confirmation. If it does not, the instructions have not been loaded. +### `-root` command + +Type `-root` at the start of any message to force the AI to re-read `ai-root-instructions.md` immediately: + +``` +-root +``` + +The AI will respond with `✅ ai-root-instructions.md READ — rules active` and then continue with the rest of your message. + +Use it: +- At the start of every new session +- When the AI seems to have forgotten the rules (e.g. attempts a `git commit` unprompted) +- When switching context or returning to a project after a break + +This command works in any AI tool — VS Code Copilot, Cursor, Claude.ai, or any other assistant. It requires no configuration and no tool-specific features. + ## Repository structure `ai-root-instructions.md` is the entry point — the first file the AI reads in any project. It routes to the relevant instruction files based on the task at hand.