diff --git a/AGENTS.md b/AGENTS.md
index 276d77f20..3d994b2d8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -18,6 +18,7 @@ in the change as a named, accepted deviation — never as compliance.
 | Before you… | Read |
 | --- | --- |
 | write code | [`docs/develop.md`](docs/develop.md) |
+| run project commands | [`docs/develop.md`](docs/develop.md) |
 | modify tests, test helpers, or test runner configuration | [`docs/references/develop-testing.md`](docs/references/develop-testing.md) — apply the test-boundary, observation, and harness rules before editing |
 | review or report a branch/PR, or create/update a PR or publish its branch | [`docs/develop.md#revision-scope-and-publication-binding`](docs/develop.md#revision-scope-and-publication-binding) + [`docs/pull-request.md`](docs/pull-request.md) |
 | change a process/message/service/persistence boundary or add a subsystem | [`docs/architecture.md`](docs/architecture.md) + the relevant `docs/references/architecture-*.md` |
diff --git a/docs/develop.md b/docs/develop.md
index 8b1f5040a..f5277a119 100644
--- a/docs/develop.md
+++ b/docs/develop.md
@@ -29,6 +29,12 @@ pnpm run check:i18n              # translation key parity (see docs/translation.
 pnpm run check:issue-templates   # .github/ISSUE_TEMPLATE schema, zh/en parity, issues/new prefill ids
 ```
 
+If a project command fails because a local prerequisite is missing, restore that prerequisite and retry the
+original command before reporting it blocked: use `pnpm install` for Node dependencies and
+`pnpm run test:e2e:install` for missing Playwright Chromium. If `pnpm` itself is unavailable, activate the
+repository-declared pnpm through Corepack when available. If setup cannot succeed or changes tracked files, report
+that blocker or mismatch instead of switching package managers or committing recovery changes.
+
 No standalone `format` script — formatting is part of `lint-fix` and runs through `prettier --write`. Husky
 pre-commit runs `prettier --check` and `pnpm run typecheck` plus ESLint for staged JS/TS files, runs
 `check:i18n` when locale files are staged and `check:issue-templates` when issue templates or `src/` TypeScript