AGENTS.md@backend/packages/harness/deerflow/persistence/migrationsA

AGENTS.md@backend/packages/harness/deerflow/persistence/migrations 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/persistence/migrations/AGENTS.md@git:20261023.cfe2bec

Pins git:20261023.cfe2bec 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/persistence/migrations/AGENTS.md
Versions recorded
34
Latest version
git:20261023.cfe2bec, committed Oct 23, 2026
First version recorded
Aug 23, 2026
Size
32,369 bytes
Repository stars
84,344
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

### Schema Migrations (`packages/harness/deerflow/persistence/migrations/`)

DeerFlow's application tables (`runs`, `threads_meta`, `feedback`, `users`, `run_events`, plus the `channel_*` tables) are owned by alembic via a **hybrid bootstrap** strategy. LangGraph's checkpointer tables (`checkpoints`, `checkpoint_blobs`, `checkpoint_writes`, `checkpoint_migrations`) live in the same database but are owned by LangGraph and excluded from alembic's view via `migrations/_env_filters.py::include_object`.

**Convention**: every ORM model change (new column, new table, new index) MUST ship as an alembic revision under `migrations/versions/`. The Gateway runs `alembic upgrade head` automatically on startup; routine production upgrades do not require manual Alembic commands. The audited offline recovery below is an exception for the out-of-tree incarnation revision. A new revision must always chain onto the current head — never insert one ahead of an already-shipped revision (re-parenting it): alembic only walks forward from a database's stamped revision, so every database already stamped at or past the insertion point treats the inserted revision as an applied ancestor and never executes…
…

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/persistence/migrations/AGENTS.md@sha256:5e82b8df19b89ede

The line at the top of this page pins the label git:20261023.cfe2bec, 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_6rmmjdx7mkgin62n.svg)](https://markdownregistry.com/a/art_6rmmjdx7mkgin62n)

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

Versions

The registry has recorded 34 versions of this file, between Aug 23, 2026 and Oct 23, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261023.cfe2bec latest2026-10-23 cfe2bec 32,369 BA view · diff
git:20261021.f39cdd62026-10-21 f39cdd6 32,155 BA view · diff
git:20261018.d1d09582026-10-18 d1d0958 31,888 BA view · diff
git:20261018.8d5f5fd2026-10-18 8d5f5fd 31,490 BA view · diff
git:20261014.268eb552026-10-14 268eb55 30,689 BA view · diff
git:20261014.e8c7df92026-10-14 e8c7df9 30,598 BA view · diff
git:20261014.cb90f5d2026-10-14 cb90f5d 29,760 BA view · diff
git:20261010.6c4c74a2026-10-10 6c4c74a 29,157 BA view · diff
git:20261009.553f85e2026-10-09 553f85e 27,647 BA view · diff
git:20261009.8b8fdf42026-10-09 8b8fdf4 27,248 BA view · diff
git:20261008.b99ac912026-10-08 b99ac91 26,401 BA view · diff
git:20261008.85796f62026-10-08 85796f6 25,228 BA view · diff
git:20261007.3182ecb2026-10-07 3182ecb 25,193 BA view · diff
git:20261007.35cdcab2026-10-07 35cdcab 24,997 BA view · diff
git:20261006.2dd2e542026-10-06 2dd2e54 23,605 BA view · diff
git:20261005.7f2c0fb2026-10-05 7f2c0fb 22,973 BA view · diff
git:20261004.d9d9ff92026-10-04 d9d9ff9 22,856 BA view · diff
git:20261001.b57fa6f2026-10-01 b57fa6f 22,786 BA view · diff
git:20260920.906c3d42026-09-20 906c3d4 22,048 BA view · diff
git:20260918.114b78d2026-09-18 114b78d 21,624 BA view · diff
git:20260918.db613082026-09-18 db61308 21,481 BA view · diff
git:20260916.f0cb67b2026-09-16 f0cb67b 20,163 BA view · diff
git:20260916.a58ab482026-09-16 a58ab48 19,455 BA view · diff
git:20260913.7513f162026-09-13 7513f16 18,799 BA view · diff
git:20260911.cd0e74e2026-09-11 cd0e74e 18,654 BA view · diff
git:20260909.06c82792026-09-09 06c8279 17,710 BA view · diff
git:20260909.0b3dadb2026-09-09 0b3dadb 16,753 BA view · diff
git:20260908.5951c892026-09-08 5951c89 16,532 BA view · diff
git:20260907.99367102026-09-07 9936710 13,909 BA view · diff
git:20260903.27cb7362026-09-03 27cb736 11,981 BA view · diff
git:20260824.ff0a6762026-08-24 ff0a676 11,195 BA view · diff
git:20260824.645ca082026-08-24 645ca08 10,992 BA view · diff
git:20260824.1aa813d2026-08-24 1aa813d 10,660 BA view · diff
git:20260823.13f0a7f2026-08-23 13f0a7f 10,546 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 (32369 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,344 stars · license MIT · pushed 2026-10-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6rmmjdx7mkgin62n
GET https://markdownregistry.com/api/v1/resolve?ref=bytedance/deer-flow/backend/packages/harness/deerflow/persistence/migrations/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/5e82b8df19b89edee7f2ac21ddfcd0a87416b4a3d2b93eed6628f12f0dfba01a

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,344 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,344 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,344 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,344 stars
AGENTS.md AGENTS.md file
bytedance/deer-flow · AGENTS.md
git:20261020.2c880a3 · audit A · 84,344 stars
CLAUDE.md CLAUDE.md file
bytedance/deer-flow · CLAUDE.md
git:20260625.ff7ecdb · audit B · 84,344 stars
AGENTS.md@backend AGENTS.md file
bytedance/deer-flow · backend/AGENTS.md
git:20261022.c0ba948 · audit A · 84,344 stars
CLAUDE.md@backend CLAUDE.md file
bytedance/deer-flow · backend/CLAUDE.md
git:20260625.ff7ecdb · audit B · 84,344 stars
AGENTS.md@backend/app/channels AGENTS.md file
bytedance/deer-flow · backend/app/channels/AGENTS.md
git:20261019.085924a · audit A · 84,344 stars
AGENTS.md@backend/app/gateway AGENTS.md file
bytedance/deer-flow · backend/app/gateway/AGENTS.md
git:20261019.085924a · audit A · 84,344 stars
AGENTS.md@backend/app/gateway/routers AGENTS.md file
bytedance/deer-flow · backend/app/gateway/routers/AGENTS.md
git:20261023.e1a7cba · audit A · 84,344 stars
AGENTS.md@backend/packages/harness/deerflow AGENTS.md file
bytedance/deer-flow · backend/packages/harness/deerflow/AGENTS.md
git:20261021.ab43439 · audit A · 84,344 stars

Every file in bytedance/deer-flow

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