From 81d13e7a8f5933e7f242ed65eb02f1712a14ff40 Mon Sep 17 00:00:00 2001 From: sokoliva Date: Fri, 17 Apr 2026 10:49:56 +0000 Subject: [PATCH] docs: move `ai_learnings.md` to local-only and update `GEMINI.md` --- GEMINI.md | 18 ++++++++++++------ docs/ai/ai_learnings.md | 19 ------------------- 2 files changed, 12 insertions(+), 25 deletions(-) delete mode 100644 docs/ai/ai_learnings.md diff --git a/GEMINI.md b/GEMINI.md index b801bd47d..e6bf43b65 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -26,16 +26,22 @@ ## 5. Mistake Reflection Protocol +> [!NOTE] for Users: +> `docs/ai/ai_learnings.md` is a local-only file (excluded from git) meant to be +> read by the developer to improve AI assistant behavior on this project. Use its +> findings to improve the GEMINI.md setup. + When you realise you have made a mistake — whether caught by the user, by a tool, or by your own reasoning — you MUST: 1. **Acknowledge the mistake explicitly** and explain what went wrong. -2. **Reflect on the root cause**: was it a missing check, a false - assumption, skipped verification, or a gap in the workflow? -3. **Immediately append a new entry to @./docs/ai/ai_learnings.md** - following the format defined in that file. This is not optional and - does not require user confirmation. Do it before continuing. Update user - about the changes to the workflow in the current chat. +2. **Reflect on the root cause**: was it a missing check, a false assumption, skipped verification, or a gap in the workflow? +3. **Immediately append a new entry to `docs/ai/ai_learnings.md`** — this is not optional and does not require user confirmation. Do it before continuing, then update the user about the workflow change. + + **Entry format:** + - **Mistake**: What went wrong. + - **Root cause**: Why it happened. + - **Rule**: The concrete rule added to prevent recurrence. The goal is to treat every mistake as a signal that the workflow is incomplete, and to improve it in place so the same mistake cannot diff --git a/docs/ai/ai_learnings.md b/docs/ai/ai_learnings.md deleted file mode 100644 index 9e9a37a9f..000000000 --- a/docs/ai/ai_learnings.md +++ /dev/null @@ -1,19 +0,0 @@ -> [!NOTE] for Users: -> This document is meant to be read by an AI assistant (Gemini) in order to -> learn from its mistakes and improve its behavior on this project. Use -> its findings to improve GEMINI.md setup. - -# AI Learnings - -A living record of mistakes made during this project and the rules -derived from them. Every entry must follow the format below. - ---- - -## Entry format - -**Mistake**: What went wrong. -**Root cause**: Why it happened. -**Rule**: The concrete rule added to prevent recurrence. - ----