From c8a34ad60e247fdf4c57d1220430cc0db046e686 Mon Sep 17 00:00:00 2001
From: Tiberiu Ichim <tiberiu.ichim@gmail.com>
Date: Sun, 22 Feb 2026 17:16:37 +0200
Subject: [PATCH] docs: add critical reminder for AI to always write artifact
 specifications

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

diff --git a/AGENTS.md b/AGENTS.md
index 2998837ff..6e58a5bb3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,7 @@
 # Audiobookshelf Development Project
 
+**CRITICAL INSTRUCTION FOR ALL AI AGENTS**: For *every* new feature, script, or development task, you **MUST ALWAYS** create an artifact specification file in `artifacts/YYYY-MM-DD/` to document your work. Never start feature development without an artifact specification. See the "Artifact Specifications" section below for details.
+
 ## Overview
 
 This is a **local development deployment** of [Audiobookshelf](https://audiobookshelf.org/) - a self-hosted audiobook and podcast server. The project is cloned from the original repository and configured for personal enhancements and development.