niko/ai-superpower
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix: remove -root command, add cold-start instruction to README

Browse Source 
-root relied on AI already having read the instructions — useless for
session start. Replaced with a direct read instruction at the top of
README that works regardless of prior context.
This commit is contained in:
moilanik 2026-03-12 11:34:46 +02:00
parent 0e6c748374
commit 213265098f
2 changed files with 2 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
.ai/ai-root-instructions.md
View File

@ -58,20 +58,6 @@ 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 ## 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. This document provides guidelines for AI assistants (any LLM) when working on any project. These rules are split into modular instruction files for efficiency.

19
README.md
View File

@ -1,3 +1,5 @@
> read .ai/ai-root-instructions.md and confirm you've read it before continuing
# ai-superpower # ai-superpower
AI instructions scatter across a large number of projects. Maintaining them inside each project individually is not practical — a single change requires manual updates everywhere. AI instructions scatter across a large number of projects. Maintaining them inside each project individually is not practical — a single change requires manual updates everywhere.
@ -61,23 +63,6 @@ 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. 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 ## 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. `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.