github/deer-flow
1
0
Fork 0
mirror of https://github.com/bytedance/deer-flow.git synced 2026-11-07 19:20:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: restore agent guidance size budgets (#7810)

Browse Source
This commit is contained in:
Willem Jiang 2026-11-02 15:20:54 +08:00 committed by GitHub
parent 3f86f071f3
commit 01e1ed778b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 3 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
backend/AGENTS.md
View File

@ -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

5
backend/app/gateway/AGENTS.md
View File

@ -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;