fix: docs: per-agent AGENTS.md files still describe cron triggers (#547)

supervisor/AGENTS.md

@@ -7,15 +7,16 @@ then runs an interactive Claude session (sonnet) that assesses health, auto-fixe
 issues, and writes a daily journal. When blocked on external
 resources or human decisions, files vault items instead of escalating directly.
 
-**Trigger**: `supervisor-run.sh` runs every 20 min via cron. Sources `lib/guard.sh`
-and calls `check_active supervisor` first — skips if
-`$FACTORY_ROOT/state/.supervisor-active` is absent. Then runs `claude -p`
-via `agent-sdk.sh`, injects `formulas/run-supervisor.toml` with
-pre-collected metrics as context, and cleans up on completion or timeout (20 min max session).
-No action issues — the supervisor runs directly from cron like the planner and predictor.
+**Trigger**: `supervisor-run.sh` is invoked by the polling loop in `docker/edge/entrypoint-edge.sh`
+every 20 minutes (line 50-53). Sources `lib/guard.sh` and calls `check_active supervisor` first
+— skips if `$FACTORY_ROOT/state/.supervisor-active` is absent. Then runs `claude -p` via
+`agent-sdk.sh`, injects `formulas/run-supervisor.toml` with pre-collected metrics as context,
+and cleans up on completion or timeout (20 min max session). Note: the supervisor runs in the
+**edge container** (`entrypoint-edge.sh`), not the agent container — this distinction matters
+for operators debugging the factory.
 
 **Key files**:
-- `supervisor/supervisor-run.sh` — Cron wrapper + orchestrator: lock, memory guard,
+- `supervisor/supervisor-run.sh` — Polling loop participant + orchestrator: lock, memory guard,
   runs preflight.sh, sources disinto project config, runs claude -p via agent-sdk.sh,
   injects formula prompt with metrics, handles crash recovery
 - `supervisor/preflight.sh` — Data collection: system resources (RAM, disk, swap,
@@ -46,6 +47,6 @@ P3 (degraded PRs, circular deps, stale deps), P4 (housekeeping).
 - Files vault items locally to `$PROJECT_REPO_ROOT/vault/pending/`
 - Logs a WARNING message at startup indicating degraded mode
 
-**Lifecycle**: supervisor-run.sh (cron */20) → lock + memory guard → run
-preflight.sh (collect metrics) → load formula + context → run claude -p via agent-sdk.sh
-→ Claude assesses health, auto-fixes, writes journal → `PHASE:done`.
+**Lifecycle**: supervisor-run.sh (invoked by polling loop every 20min, `check_active supervisor`)
+→ lock + memory guard → run preflight.sh (collect metrics) → load formula + context → run
+claude -p via agent-sdk.sh → Claude assesses health, auto-fixes, writes journal → `PHASE:done`.