From 827b692b1562da923ad22af84d7383ab950eccd4 Mon Sep 17 00:00:00 2001
From: RainbowBird <git@luoling.moe>
Date: Sat, 12 Sep 2026 19:23:23 +0800
Subject: [PATCH] docs: keep ADRs in the main repository

---
 AGENTS.md        | 7 +++++++
 server/AGENTS.md | 5 ++---
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index a318617e0..3afdad97a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -91,6 +91,13 @@ Concise but detailed reference for contributors working across the `moeru-ai/air
 
 ## Before You Start
 
+## Architecture decisions
+
+- Put project-wide and client ADRs directly in `docs/ai/`.
+- Put hosted backend ADRs directly in `server/docs/ai/`.
+- Both paths are relative to the repository root.
+- Keep ADRs in this repository and include them in the related commits and pull requests.
+
 ## Enforced Repository Skills
 
 - For testing, Vitest, regression reproduction, mocks, or test import-boundary work, always use [`enforce-rules-for-vitest` skill](.agents/skills/enforce-rules-for-vitest/SKILL.md).
diff --git a/server/AGENTS.md b/server/AGENTS.md
index bce5e6e1d..a7971b3cb 100644
--- a/server/AGENTS.md
+++ b/server/AGENTS.md
@@ -12,9 +12,8 @@
 
 ## Architecture decisions
 
-- Put server ADRs in `../airi-docs/adr/`.
-- For an ADR task, write or update the ADR only. Do not stage, commit, push, or open a PR for ADR files.
-- The user owns ADR commits and pushes.
+- Put server ADRs directly in `server/docs/ai/`, relative to the repository root.
+- Include ADRs in the related commits and pull requests in this repository.
 - Create or update the ADR before you change a server boundary.
 - A server boundary includes an HTTP contract, provider contract, persistence model, or cross-module lifecycle.
 - Add a module dependency graph, an affected-file tree, and a sequence diagram to every implementation ADR.