From 8532cbf713d616bb3cf3998ff55bde6a6e45b185 Mon Sep 17 00:00:00 2001
From: Matteo <30387529+max23468@users.noreply.github.com>
Date: Mon, 1 Jun 2026 16:47:58 +0200
Subject: [PATCH] docs: document Superpowers operating rules

---
 AGENTS.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index bd2cda5..db252f9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -60,6 +60,14 @@ facciano sembrare i siti monitorati partner/prodotti di Sentinel.
   equivalente quando lavori via GitHub.
 - Dopo merge/pubblicazione controlla `git branch -vv` e `git worktree list`, poi
   pulisci branch/worktree non più necessari o dichiara cosa resta aperto.
+- Usa le skill Superpowers pertinenti per lavori non banali: pianificazione,
+  debugging sistematico, worktree, esecuzione di piani, review e verifica
+  finale. Le skill non sostituiscono robots.txt, policy dati, runtime Actions,
+  release/deploy o fonti primarie di Sentinel.
+- Usa o proponi `grill-me` quando serve stressare architetture, refactor
+  trasversali, monitor/runtime, dashboard, deploy, sicurezza, roadmap o scope
+  ambiguo. Non renderla obbligatoria per refusi, docs-only a basso rischio,
+  cleanup o modifiche meccaniche già determinate.
 
 ## Policy dati