From ec9d5228fde0b472613a806c47c6b6972ff57682 Mon Sep 17 00:00:00 2001
From: alltheseas <alltheseas@users.noreply.github.com>
Date: Sat, 31 Jan 2026 09:53:41 -0600
Subject: [PATCH] Add AGENTS.md entry point for AI coding assistants

Follows the spec-first documentation system introduced in #271.
Provides a minimal pointer file directing AI agents to CONTEXT.md
and the spec/guidelines/ structure.

See: https://github.com/zapstore/zapstore/pull/271

Signed-off-by: alltheseas
---
 AGENTS.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..875e484
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,21 @@
+# AI Agents
+
+Start here: [CONTEXT.md](CONTEXT.md)
+
+## Quick Reference
+
+| What | Where |
+|------|-------|
+| Project overview | `CONTEXT.md` |
+| Architecture & patterns | `spec/guidelines/ARCHITECTURE.md` |
+| Non-negotiable rules | `spec/guidelines/INVARIANTS.md` |
+| Quality standards | `spec/guidelines/QUALITY_BAR.md` |
+| Product vision | `spec/guidelines/VISION.md` |
+| Feature specs | `spec/features/` |
+| Active work | `work/` |
+
+## Rules
+
+1. Read `CONTEXT.md` first
+2. Never modify files in `spec/guidelines/`
+3. If a spec is unclear, report it—do not guess