From 5efd80cacf24f6e167f2e866c888dc122267acea Mon Sep 17 00:00:00 2001
From: franzap <_@franzap.com>
Date: Thu, 5 Feb 2026 15:35:56 -0300
Subject: [PATCH] Move to AGENTS.md as default

---
 AGENTS.md  | 63 ++++++++++++++++++++++++++++++++++++++++++++++++------
 CONTEXT.md | 61 ----------------------------------------------------
 2 files changed, 57 insertions(+), 67 deletions(-)
 delete mode 100644 CONTEXT.md

diff --git a/AGENTS.md b/AGENTS.md
index 875e484..6a3f7a4 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,12 +1,22 @@
 # AI Agents
 
-Start here: [CONTEXT.md](CONTEXT.md)
+This document is the entry point for AI assistants.
+All behavioral authority lives in the project spec, not here.
+
+If anything in this file conflicts with files under `spec/guidelines/`,
+this file is wrong.
+
+## What This Repository Is
+
+Zapstore is a local-first, Nostr-native app store for Android.
+It discovers, downloads, verifies, and installs APKs signed by developers the user trusts.
+
+Users can support developers directly via Lightning zaps.
 
 ## 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` |
@@ -14,8 +24,49 @@ Start here: [CONTEXT.md](CONTEXT.md)
 | Feature specs | `spec/features/` |
 | Active work | `work/` |
 
-## Rules
+## Project Spec Structure
 
-1. Read `CONTEXT.md` first
-2. Never modify files in `spec/guidelines/`
-3. If a spec is unclear, report it—do not guess
+    spec/
+      guidelines/           # Permanent rules (human-owned, never AI-modified)
+        ARCHITECTURE.md     # Package boundaries, dependencies, key patterns
+        INVARIANTS.md       # Non-negotiable behavioral guarantees
+        QUALITY_BAR.md      # Standards, when to create specs
+        VISION.md           # Product goals and non-goals
+
+      features/             # Feature specs (behavioral contracts)
+        _TEMPLATE.md        # Template with example
+        FEAT-001-*.md       # Actual feature specs
+
+    work/                   # Active work packets (temporary, delete after merge)
+      _TEMPLATE.md          # Template with example
+      WORK-001-*.md         # Actual work packets
+
+## How to Work
+
+1. Before implementing, check `spec/features/` for a relevant feature spec
+2. For non-trivial work, create a work packet in `work/`
+3. Every code change must trace to a task in the work packet
+4. If a spec is unclear or incorrect, report a Spec Issue—do not guess
+
+See `spec/guidelines/QUALITY_BAR.md` for what qualifies as "non-trivial."
+
+## File Ownership
+
+**Never modify** files in `spec/guidelines/`.
+If a guideline seems wrong or incomplete, report it as a Spec Issue.
+
+| Path | Owner | AI May Modify |
+|------|-------|---------------|
+| `spec/guidelines/*` | Human | No |
+| `spec/features/*` | Human | No (unless explicitly asked) |
+| `work/*.md` | AI | Yes |
+| `lib/**` | Shared | Yes |
+| `test/**` | Shared | Yes |
+| `AGENTS.md` | Human | No |
+
+## Working Rules
+
+- Prefer small, localized changes. Avoid unrelated refactors.
+- After dependency changes, run: `fvm flutter pub get`
+- Fix any analyze/lint errors introduced by your changes.
+- Assume Android as default target unless instructed otherwise.
diff --git a/CONTEXT.md b/CONTEXT.md
deleted file mode 100644
index 8a92276..0000000
--- a/CONTEXT.md
+++ /dev/null
@@ -1,61 +0,0 @@
-# Zapstore — Project Context
-
-This document is the entry point for AI assistants.
-All behavioral authority lives in the project spec, not here.
-
-If anything in this file conflicts with files under `spec/guidelines/`,
-this file is wrong.
-
-## What This Repository Is
-
-Zapstore is a local-first, Nostr-native app store for Android.
-It discovers, downloads, verifies, and installs APKs signed by developers the user trusts.
-
-Users can support developers directly via Lightning zaps.
-
-## Project Spec Structure
-
-    spec/
-      guidelines/           # Permanent rules (human-owned, never AI-modified)
-        ARCHITECTURE.md     # Package boundaries, dependencies, key patterns
-        INVARIANTS.md       # Non-negotiable behavioral guarantees
-        QUALITY_BAR.md      # Standards, when to create specs
-        VISION.md           # Product goals and non-goals
-
-      features/             # Feature specs (behavioral contracts)
-        _TEMPLATE.md        # Template with example
-        FEAT-001-*.md       # Actual feature specs
-
-    work/                   # Active work packets (temporary, delete after merge)
-      _TEMPLATE.md          # Template with example
-      WORK-001-*.md         # Actual work packets
-
-## How to Work
-
-1. Before implementing, check `spec/features/` for a relevant feature spec
-2. For non-trivial work, create a work packet in `work/`
-3. Every code change must trace to a task in the work packet
-4. If a spec is unclear or incorrect, report a Spec Issue—do not guess
-
-See `spec/guidelines/QUALITY_BAR.md` for what qualifies as "non-trivial."
-
-## File Ownership
-
-**Never modify** files in `spec/guidelines/`.
-If a guideline seems wrong or incomplete, report it as a Spec Issue.
-
-| Path | Owner | AI May Modify |
-|------|-------|---------------|
-| `spec/guidelines/*` | Human | No |
-| `spec/features/*` | Human | No (unless explicitly asked) |
-| `work/*.md` | AI | Yes |
-| `lib/**` | Shared | Yes |
-| `test/**` | Shared | Yes |
-| `CONTEXT.md` | Human | No |
-
-## Working Rules
-
-- Prefer small, localized changes. Avoid unrelated refactors.
-- After dependency changes, run: `fvm flutter pub get`
-- Fix any analyze/lint errors introduced by your changes.
-- Assume Android as default target unless instructed otherwise.