From 01e1ed778b186f0e67b79eb6e60ad0e12d9c3e63 Mon Sep 17 00:00:00 2001 From: Willem Jiang Date: Mon, 2 Nov 2026 15:20:54 +0800 Subject: [PATCH] docs: restore agent guidance size budgets (#7810) --- backend/AGENTS.md | 9 +++------ backend/app/gateway/AGENTS.md | 5 ----- 2 files changed, 3 insertions(+), 11 deletions(-) diff --git a/backend/AGENTS.md b/backend/AGENTS.md index dd954dba40..2c2529b432 100644 --- a/backend/AGENTS.md +++ b/backend/AGENTS.md @@ -22,12 +22,9 @@ Service roles and ports: [root service topology](../AGENTS.md#service-topology). - Gateway MCP/skill updates write `extensions_config.json` at runtime. Production Compose mounts it read-write (`config.yaml` stays `:ro`); Helm seeds a writable home-volume copy. Hold both `extensions_config_write_lock` and the sidecar advisory `extensions_config_file_lock` during read-modify-write to prevent lost updates across workers. `atomic_write_extensions_config` uses temp-file replacement; only mount-point `EBUSY` permits a non-atomic in-place overwrite (crashes can truncate). Warn about this fallback once per target; propagate other errors. `get_extensions_config()` revalidates reads by file signature; see [config caching](packages/harness/deerflow/config/AGENTS.md). Tests: `tests/test_compose_extensions_config_writable.py`, `tests/test_extensions_config_atomic_write.py`, `tests/test_helm_extensions_config_writable.py`. - MCP cache reset scope and discovery fencing: [MCP guide](packages/harness/deerflow/mcp/AGENTS.md). -**Project structure:** The [root repository map](../AGENTS.md#repository-map) -indexes the stack. Backend code lives in `app/` (Gateway and channels), -`packages/harness/deerflow/` (agent runtime), and `packages/extension-api/` -(public extension contracts). Tests, detailed docs, and standalone benchmarks -live in `tests/`, `docs/`, and `scripts/benchmark/` respectively. Module-local -`AGENTS.md` files describe their implementation boundaries. +**Layout:** [Repository map](../AGENTS.md#repository-map). Tests: `tests/`; +docs: `docs/`; benchmarks: `scripts/benchmark/`. Read module-local `AGENTS.md` +for implementation boundaries. ## Important Development Guidelines diff --git a/backend/app/gateway/AGENTS.md b/backend/app/gateway/AGENTS.md index af94fd6d16..a972b8b037 100644 --- a/backend/app/gateway/AGENTS.md +++ b/backend/app/gateway/AGENTS.md @@ -6,11 +6,6 @@ Reject external `sandbox`, `thread_data`, `viewed_images`, `goal_outcome`. Non-n Studio keeps sanitized creation metadata. -Capability Center `business` validates credentials, creates MCP connections. -MCP allows only its isolated launcher/credential environment keys; reject -arbitrary commands/manifest-policy bypasses. Keep admin checks, masked -atomic edits, cache reloads; exclude credentials from tool schemas. - HTTP and run metadata creation share `goal_thread_lock`. Lock in detached `_ensure_thread_metadata`; preserve await-free attachment and cancel/drain ownership. Its 5s budget covers admission and I/O: timeout fails strict starts;