From 8cadfc4657b99784169536ea97b51f05b6e597b2 Mon Sep 17 00:00:00 2001 From: datadunia Date: Tue, 7 Jul 2026 17:22:28 +0700 Subject: [PATCH] docs: update AGENTS.md --- AGENTS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 707ab2e..a3cd89b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -38,6 +38,19 @@ NexusGuard SD-WAN Suite: Enterprise Zero-Trust SD-WAN with WireGuard tunneling, **CRITICAL**: `apps/*` are **git submodules** — clone with `--recurse-submodules`. +## SUBMODULE KNOWLEDGE BASES + +Each submodule has its own `AGENTS.md` with detailed architecture, conventions, and anti-patterns: + +| Submodule | AGENTS.md | Scope | +|-----------|-----------|-------| +| Server Core | `apps/server-core/AGENTS.md` | API handlers, database models, firewall rules, gRPC signaling, WireGuard management | +| Dashboard UI | `apps/dashboard-ui/AGENTS.md` | Vue 3 components, Pinia stores, TailwindCSS styling, API client | +| Device Agent | `apps/device-agent/AGENTS.md` | Go daemon, system tray, memory-injected WireGuard, heartbeat, gRPC signaling | +| Android Agent | `apps/android-agent/AGENTS.md` | Kotlin VPNService, GoBackend tunnel, HTTP heartbeat, port forwarding, boot auto-start | + +**Rule**: When working on a submodule, ALWAYS read its `AGENTS.md` first for project-specific conventions. + ## WHERE TO LOOK | Task | Location | Notes | |------|----------|-------|