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
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 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.
### `-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.