From d12c5bfa027ff98087e0b8d6d55d70633e1649a6 Mon Sep 17 00:00:00 2001
From: saravanakumardb1 <saravanakumardb1@users.noreply.github.com>
Date: Sat, 21 Mar 2026 09:12:19 -0700
Subject: [PATCH] docs: add cross-repo automation playbook reference

---
 AGENTS.md | 11 +++++++++++
 CLAUDE.md |  7 +++++++
 2 files changed, 18 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 5219d89..3d14725 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -255,3 +255,14 @@ cd mobile && npm test                  # 23 Vitest tests
 | `notes.relationships.link` | Create typed relationship between notes | admin |
 | `notes.tasks.extract` | Extract tasks from note body | admin |
 | `notes.artifacts.attach` | Attach artifact to a note | admin |
+
+
+---
+
+## Cross-Repo Automation
+
+For periodic maintenance tasks that span all ByteLyst repos (test audits, coverage gaps, dependency checks, secret scans, typecheck sweeps), see the **Coding Agent Automation Playbook**:
+
+> [`../learning_ai_common_plat/docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md`](../learning_ai_common_plat/docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md)
+
+Key tasks: workspace hygiene sweep, cross-repo test suite, backend/web coverage gap analysis, TypeScript typecheck sweep, dependency health check, secret scan, code quality audit, AGENTS.md consistency check.
diff --git a/CLAUDE.md b/CLAUDE.md
index 18be9e5..20edd13 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -29,3 +29,10 @@
 ```bash
 cd backend && npm test && npm run typecheck && npm run build
 ```
+
+
+---
+
+## Cross-Repo Automation
+
+See [`../learning_ai_common_plat/docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md`](../learning_ai_common_plat/docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md) for periodic maintenance tasks: test audits, coverage gaps, dependency checks, secret scans, typecheck sweeps.