AGENTS.md@backend/packages/harness/deerflowA

AGENTS.md@backend/packages/harness/deerflow from bytedance/deer-flow is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add bytedance/deer-flow/backend/packages/harness/deerflow/AGENTS.md@git:20261016.9c74b15

Pins git:20261016.9c74b15 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
bytedance/deer-flow
Path
backend/packages/harness/deerflow/AGENTS.md
Versions recorded
18
Latest version
git:20261016.9c74b15, committed Oct 16, 2026
First version recorded
Sep 1, 2026
Size
13,792 bytes
Repository stars
84,193
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

### Request Trace Context (`packages/harness/deerflow/trace_context.py`)

DeerFlow's request-level correlation id — the `X-Trace-Id` header and the `deerflow_trace_id` key. Not Langfuse's trace id, not `run_id`, not the short subagent `trace_id` log label.

**The ContextVar is the only source.** Every path that reaches a run binds one first; downstream treats the id as a plain `str`, no `if trace_id:` guards.

Entry points and binders: Gateway HTTP — `TraceMiddleware`; scheduled occurrence — `ScheduledTaskService._attempt_queued_run` → `launch_scheduled_thread_run`; MCP task notification — `launch_mcp_task_notification_run`; IM inbound — `ChannelManager._worker_loop`; embedded / TUI / CLI turn — `DeerFlowClient.stream()`.

Only the first is HTTP; the rest run outside ASGI, so the binding cannot live in middleware alone. Each scopes **one unit of work**, never a poller loop — a leaked binding on a reused worker task would tag later occurrences with the first id. `ensure_trace_context` inherits, keeping layered scheduled bindings and a manual trigger inside a Gateway request on one trace.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bytedance/deer-flow/backend/packages/harness/deerflow/AGENTS.md@sha256:95839b9301133390

The line at the top of this page pins the label git:20261016.9c74b15, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nokebitlwczpewgl.svg)](https://markdownregistry.com/a/art_nokebitlwczpewgl)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 18 versions of this file, between Sep 1, 2026 and Oct 16, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261016.9c74b15 latest2026-10-16 9c74b15 13,792 BA view · diff
git:20261015.55b1f1c2026-10-15 55b1f1c 13,775 BA view · diff
git:20261012.b346b172026-10-12 b346b17 13,553 BA view · diff
git:20261011.6103c7b2026-10-11 6103c7b 13,475 BA view · diff
git:20260930.25671532026-09-30 2567153 12,710 BA view · diff
git:20260928.5850b0d2026-09-28 5850b0d 12,782 BA view · diff
git:20260924.29dbce42026-09-24 29dbce4 12,677 BA view · diff
git:20260921.60d56592026-09-21 60d5659 12,685 BA view · diff
git:20260917.86406cf2026-09-17 86406cf 12,682 BA view · diff
git:20260916.a246c922026-09-16 a246c92 13,120 BA view · diff
git:20260909.a3848ef2026-09-09 a3848ef 12,883 BA view · diff
git:20260907.d1f1c492026-09-07 d1f1c49 12,736 BA view · diff
git:20260906.3bccd142026-09-06 3bccd14 12,959 BA view · diff
git:20260904.0f7d8702026-09-04 0f7d870 12,752 BA view · diff
git:20260903.e5977322026-09-03 e597732 12,041 BA view · diff
git:20260902.9e0fbd62026-09-02 9e0fbd6 11,525 BA view · diff
git:20260901.9146bfa2026-09-01 9146bfa 11,461 BA view · diff
git:20260901.df57f8e2026-09-01 df57f8e 10,932 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (13792 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

bytedance/deer-flow · 84,193 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nokebitlwczpewgl
GET https://markdownregistry.com/api/v1/resolve?ref=bytedance/deer-flow/backend/packages/harness/deerflow/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/95839b93011333908b9013bf5bd24cf3eaeac6a8e82fffab2057ea6e0d4eb341

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from bytedance/deer-flow

blocking-io-guard SKILL.md skill
bytedance/deer-flow · .agent/skills/blocking-io-guard/SKILL.md · Ensure async-path backend code that could block the asyncio event loop is protected by a teeth-verified runtime anchor…
git:20260612.dc2abab · audit A · 84,193 stars
deerflow-maintainer-orchestrator SKILL.md skill
bytedance/deer-flow · .agent/skills/deerflow-maintainer-orchestrator/SKILL.md · Use when a DeerFlow maintainer needs comment-only GitHub issue or PR handling: resolve issue/PR scopes with gh, analyze…
git:20260616.65fab1d · audit A · 84,193 stars
engineer-system-change SKILL.md skill
bytedance/deer-flow · .agent/skills/engineer-system-change/SKILL.md · Evaluate and carry out non-trivial software-system changes from first principles. Use when assessing RFCs, issues…
git:20260723.2af2fb5 · audit A · 84,193 stars
smoke-test SKILL.md skill
bytedance/deer-flow · .agent/skills/smoke-test/SKILL.md · End-to-end smoke test skill for DeerFlow. Guides through: 1) Pulling latest code, 2) Docker OR Local installation and…
git:20260619.525ec0a · audit A · 84,193 stars
AGENTS.md AGENTS.md file
bytedance/deer-flow · AGENTS.md
git:20261020.2c880a3 · audit A · 84,193 stars
CLAUDE.md CLAUDE.md file
bytedance/deer-flow · CLAUDE.md
git:20260625.ff7ecdb · audit B · 84,193 stars
AGENTS.md@backend AGENTS.md file
bytedance/deer-flow · backend/AGENTS.md
git:20261020.d85e0e8 · audit A · 84,193 stars
CLAUDE.md@backend CLAUDE.md file
bytedance/deer-flow · backend/CLAUDE.md
git:20260625.ff7ecdb · audit B · 84,193 stars
AGENTS.md@backend/app/channels AGENTS.md file
bytedance/deer-flow · backend/app/channels/AGENTS.md
git:20261019.085924a · audit A · 84,193 stars
AGENTS.md@backend/app/gateway AGENTS.md file
bytedance/deer-flow · backend/app/gateway/AGENTS.md
git:20261019.085924a · audit A · 84,193 stars
AGENTS.md@backend/app/gateway/routers AGENTS.md file
bytedance/deer-flow · backend/app/gateway/routers/AGENTS.md
git:20261017.169002a · audit A · 84,193 stars
AGENTS.md@backend/packages/harness/deerflow/agents AGENTS.md file
bytedance/deer-flow · backend/packages/harness/deerflow/agents/AGENTS.md
git:20261020.0d73798 · audit A · 84,193 stars

Every file in bytedance/deer-flow

Browse by kind, by grade A, or by owner.