From cdf6392f14e40f5594b1223d18e7b31f6befd054 Mon Sep 17 00:00:00 2001
From: BREW <81044362+b-re-w@users.noreply.github.com>
Date: Sat, 3 Oct 2026 08:16:36 +0900
Subject: [PATCH] Docs: Subagents do not run heavy local builds

Subagents write code, design, investigate and document; builds, the gate and
model runs are the session's, one at a time, or CI's. Several sessions share
one machine.
---
 AGENTS.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index aa8cfe5..36e2223 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -135,6 +135,10 @@ to implement", say what you counted against.
   counts, lifetimes, class loaders) gets the strongest tier; work a test will catch can use a
   cheaper one.
 - Give every agent prompt the absolute paths it may write to, and repeat rule 2 in it.
+- **Subagents do not run heavy local builds.** Subagents write code, design, investigate, review
+  and document. Gradle builds, cargo builds, the test gate and model runs are done by the session
+  itself — one at a time on this machine — or by CI (GitHub Actions) on a pushed branch. Several
+  sessions share one machine; parallel local builds slow every one of them.
 
 ---