| type | Reference | ||||||
|---|---|---|---|---|---|---|---|
| title | Validation checklist | ||||||
| description | Canonical command sequence for validating RNFB TS/JS changes, e2e, and handoff. | ||||||
| tags |
|
||||||
| timestamp | 2026-09-10 00:00:00 UTC |
Validation commands for development/handoff. Other docs/skills link here; do not restate.
Coverage acceptance: expectations + completion signal on every touched file.
Work types and tiers: change authoring workflow. Term ids: iteration vocabulary.
| Work type | Scope | Shortcuts |
|---|---|---|
gap-analysis |
compare:types, config read, SDK declarations |
n/a |
baseline-capture |
Full loaded spec(s) + e2e on every required platform | area-focused tier; area narrowing required; no .only, no :test-cover-reuse; no platform shortcuts |
implementation |
Unit-focused Jest + e2e on every required platform when native bridge, committed **/generated/**, podspec/spec/codegen wiring, or macOS TS/runtime path changed — Jest-only / yarn codegen:verify do not close implementation_gate; lib/** edits need yarn lerna:prepare + Metro restart, not platform :build for JS alone (running e2e § Rules #3) |
unit-focused tier; harness overrides + RNFBDebug before :test-cover; optional .only / sub-suite for diagnosis; platform coverage gate — no platform shortcuts |
documentation |
Promote user docs + durable OKF + AGENTS.md + CONTRIBUTING.md on the same change set before independent-review |
none — does not run the OKF bundle scan; loop: change authoring § work types |
independent-review |
Full checklist; e2e on every required platform (macOS / iOS / Android per harness); this pass is the OKF scan when okf-bundle/ reference docs, AGENTS.md, or CONTRIBUTING.md are in the frozen tree |
area-focused tier; platform coverage gate — no shortcuts; frozen tree (report-only except revert .only); never commit overrides, sub-suite .only, or temporary tests/app.js edits (fail-fast §) |
commit |
Stage after gates closed | change authoring § commit — staging only; OKF contract findings → documentation? then re-scan |
pre-merge-validation |
Full unfocused suite | full tier — running-e2e § merge; entire PR branch, once |
Repo root. Agents: agent command policy — only these invocations; never yarn workspace … prepare or package-scoped yarn run build for diagnostics.
yarn # install + postinstallDev (lerna:prepare + ruby:install)
yarn lerna:prepare # after packages/*/lib/** edits — transpiles lib → dist/module via each package prepare target
yarn tsc:compile
yarn tsc:compile:consumer
yarn tsc:compile:test-expo # when test-expo/** TS in the diff — [agent command policy](agent-command-policy.md); never `cd test-expo && tsc`
yarn attw:check # scoped attw + Expo plugin smoke; allowlisted pack stage — [Types-AD](architecture-decisions.md)yarn lerna:prepare runs each package prepare script (build then compile/bob). That is the canonical lib/**→dist/module/** path. Do not use cd packages/<pkg> && yarn compile as a substitute — compile is a step inside prepare, not a standalone agent entrypoint.
Blocking: yarn and yarn lerna:prepare must exit 0 before any other command (Jest, tsc, e2e, Metro, builds) — never parallelize. Agent command policy § prepare must finish first; e2e pre-flight: running e2e § prepare completion gate. Before native :build: install / patch / fmt gate (fmt ≥ 12.1.0).
yarn reference:api # after consumer tsc
yarn compare:types # remove stale config entries when fixedConfigs: .github/scripts/compare-types/configs/. Package workflows define ordering (e.g. pipelines).
When typedoc.json or packages/*/typedoc.json changes anything that can alter reference URL structure, also run the legacy redirect audit (verify every docs.json → redirects target; add mappings for newly orphaned legacy /reference/... paths).
For any package registered in compare:types, type parity is a review-gate requirement, not a best-effort signal. Before closing independent-review, the touched package must have:
- no undocumented differences,
- no stale config entries,
- and any intentional RN-only exports documented in that package config to the compare-types justification bar.
If yarn compare:types fails because of unrelated packages, keep the touched package's result in the handoff and add/fix a work-queue item for the unrelated drift. Do not close a review gate for a registered package when its own compare-types output is failing.
yarn tests:jest # full suite at handoffFocused example:
yarn tests:jest --watchman=false packages/firestore/__tests__/pipelines.test.tsOptional: yarn tests:jest-coverage.
Unhandled rejections: on Node 24 an unhandled promise rejection crashes the Jest process (triggerUncaughtException), aborting the file so other tests report nothing; a process.on('unhandledRejection') listener in a test cannot reliably observe it (Jest sandboxes process). Assert the handler is attached instead: spy the method returning the promise, wrap the returned promise's then to capture the derived promise, and assert that resolves (pattern: packages/app-check/__tests__/initializeAppCheck.test.ts). When proving such tests fail on old code, run them one at a time (-t) so each failure is reported.
Host-dependent test (darwin). packages/app/__tests__/iosSimulatorHelpers.test.js › "resolves slot-1 UDID on pinned runtime when present" runs live simctl on macOS and fails unless an RN E2E iOS slot-1 simulator exists on RNFB_IOS_SIM_RUNTIME (default iOS 27.0); on Linux it only static-checks the helper. On a Mac without that device the full suite exits 1 whatever the diff is. To provision it: yarn tests:e2e:setup-ios-sims 2 (creates slot-0 and slot-1; create/reuse-only — setup count, iOS slot simulators). When a reviewer cannot provision it, rerun that file alone (yarn tests:jest --watchman=false packages/app/__tests__/iosSimulatorHelpers.test.js) to show only that test fails, and record the jest row with the real exit and evidence such as N-1/N suites; 1 host-dependent failure (no slot-1 sim), unrelated to diff. This exemption does not apply when the diff touches scripts/e2e/lib/ios-simulator-helpers.sh, scripts/e2e/create-ios-simulators.sh, or that test file.
When packages/*/android/** Java bridge/state-machine logic changed (or added under src/test/java):
yarn tests:android:unit # JUnit-first — [AndroidTest-AD-1](android-architecture-decisions.md#androidtest-ad-1)Produces Jacoco *.exec that counts toward native touched-line coverage when merged. After Android e2e:
yarn tests:android:post-e2e-coverage # pull .ec → jacocoTestReport (unit + e2e merge)
# optional explicit merge:
yarn tests:android:test:jacoco-reportMerged Codecov path: jacocoTestReport.xml — coverage design. JVM unit does not replace platform coverage gate e2e.
When packages/*/ios/** Objective-C/C++ bridge logic changed (or an in-package *UnitTests.xcodeproj was added):
yarn tests:ios:unit # macOS/host-first — [IosTest-AD-1](ios-architecture-decisions.md#iostest-ad-1)Produces coverage/ios-unit/lcov.info and merges into coverage/ios-native/lcov.info. After iOS e2e, yarn tests:ios:test:process-coverage merges unit LCOV again so e2e export does not drop XCTest hits — coverage design (non-zero exit from the trailing NYC JS report can leave coverage/ios-native/lcov.info already written and usable). In-package XCTest does not replace platform coverage gate e2e.
Blocking for implementation_gate / review_gate / handoff when the diff touches any of:
packages/app/**/*.rb(production helpers such asfirebase_spm.rb,firebase_json.rb)packages/app/__tests__/*_test.rb
yarn ruby:install # root Gemfile; included in root yarn via postinstallDev; skips exit 0 when bundle not on PATH, ruby < 3.3.1, or bundle cannot run
yarn tests:ios:ruby # yarn lint:ruby (RuboCop) then all *_test.rb + SimpleCov → coverage/ios-ruby/lcov.info
yarn lint:ruby # RuboCop only (same Gemfile; not part of root yarn lint)Do not bundle install --gemfile=packages/app/__tests__/Gemfile. That vendors under packages/app/__tests__/vendor/ and yarn lint:js then fails on vendor. JS lint / Bundler vendor.
Host Ruby must be >= 3.3.1 (not 3.3.0); do not downgrade lockfile simplecov — agent command policy § iOS Ruby.
Opt-in shape/embed suites skip cleanly when cocoapods/xcodeproj are absent; exit 0 when only skips occur alongside a green unit suite. Coverage artifact and Codecov flag ios-ruby: coverage design § iOS Ruby. Touched production Ruby lines need test support in the coverage evidence package before review_gate closes — same spirit as JS/native touched-line bar. Canonical command only (agent command policy); do not use ad-hoc ruby packages/app/__tests__/…_test.rb as the gate.
Blocking before implementation handoff and on the frozen tree for independent-review. Run from repo root after prepare/compile when TS/JS changed. Owner of which script to run — change authoring hops here; do not duplicate this table there.
CI Lint job (.github/workflows/linting.yml) is yarn lint = lint:js + lint:deps + lint:android + lint:ios:check. lint:android is Java (google-java-format); it does not format Kotlin. Kotlin format is repo-root ./gradlew ktlintFormat (agent command policy), not part of yarn lint.
Run only the scripts whose trees are in the diff (exit 0). Do not run the rest.
| Tree in diff | Script | Notes |
|---|---|---|
packages/** or test-expo/** JS/TS |
yarn lint:js |
ESLint packages/* and test-expo/ (one script; do not invent a test-expo lint entrypoint). Implementation may yarn lint:js --fix then re-run until clean. Prefer that over yarn format:js. A flood under packages/app/__tests__/vendor/ is local Bundler vendor, not product lint. Do not treat it as the lint gate. Agent command policy § JS lint / Bundler vendor. |
packages/*/lib/** |
yarn lint:deps |
Blocking. dependency-cycle linting. |
Java under packages/*/android |
yarn lint:android |
Implementation only. google-java-format --set-exit-if-changed --replace on .java — mutates. Does not format .kt. Only Java entrypoint (agent command policy); never invent yarn google-java-format / npx google-java-format. Can flake; rerun once/twice if failure is not clearly in diff. Commit formatter output. |
Kotlin under packages/*/android or tests/android/**/*.kt |
repo-root ./gradlew ktlintFormat |
Implementation only. Mutates. Include tests/android/**/*.kt when those files are in the diff. Invocation and filter: agent command policy § Android Kotlin format. Frozen review: do not run. |
iOS native (packages/*/ios .h / .cpp / .m / .mm, not generated) |
yarn lint:ios:check |
clang-format check (-n -Werror). Implementation may yarn lint:ios:fix then re-check. Repo pins clang-format@1.7.0 (exact, not ^): 1.8.0 ships darwin x86_64 only (needs Rosetta); 1.7.0’s misnamed darwin_x64 path is native arm64. Intel Mac is not a supported local lint:ios host (App Store / Xcode / macOS floor). |
docs/**, or docs tooling (scripts/docs-snippets-tsc.mjs, scripts/docs-member-check.mjs, scripts/lib/mdx-fences.mjs, eslint.docs-snippets.config.mjs) |
yarn lint:markdown (yarn lint:markdown:fix for Prettier formatting) then yarn lint:spellcheck then yarn docs:tsc:check then yarn docs:member:check then yarn lint:docs-links |
Docs tree globs and the docs tooling files above (CI docs job). OKF-only diffs skip these. Gotchas below. Link-check: § docs.page link check. |
Docs lint gotchas (docs tree or docs tooling only):
yarn lint:markdown: three steps, all blocking. (1) ESLint ondocs/**/*.mdxwith the base config. (2) ESLint witheslint.docs-snippets.config.mjs(flatCodeBlocksoverjs,javascript,jsx,ts,typescriptandtsxfences): parse errors,no-undef(js/jsxfences), unused variables (@typescript-eslintrule forts/tsxfences) andreact/jsx-no-undef(ts/tsxfences). Top-level named function and arrow helper bindings are exempt from the unused-variable check (the config appends avoid (...)reference); fences marked// codeblock-ignoreare skipped. (3) Prettier--checkondocs/**/*.mdxand the docs tooling.mjsfiles (exact table column padding).yarn lint:markdown:fixruns Prettier--writeover the same set (agent command policy). Wide tables: prefix{/* prettier-ignore */}, compact single-space cells, seedocs/migrating-to-v26.mdx.- Spellcheck frontmatter:
spellchecker-cliexits 0 when frontmatter fails to parse (Failed to parse YAML frontmatter, ignoring it) and skips checking that page's frontmatter.yarn lint:spellcheckruns it throughscripts/spellcheck.mjs, which streams the output through unchanged and turns that case into exit 1 with a fix hint. Unquoted colons in values (e.g.description: v27: Imagen API removal) are the common trigger — quote the value. Keep that wrapper in place if the script is ever rewritten; a barespellcheckerinvocation restores the silent pass. yarn docs:tsc:check: blocking. Compiles thejs,javascript,jsx,ts,typescriptandtsxfences indocs/**/*.mdxagainst the consumer type surface (tsconfig.consumer.json); other fence languages are counted and listed as not compiled. Exit 1 on a failed fence, on a fence-grammar error (unclosed fence,~~~fence, or a fence inside a blockquote), or when no compilable fence is found. The fence grammar (indented fences are de-indented, CRLF is normalised) is shared withdocs:member:checkinscripts/lib/mdx-fences.mjs. Imports are hoisted with the TypeScript compiler API and the rest of the fence is wrapped in an async function, so top-levelawaitandexport defaultcompile. Unhandled forms (export const,export { ... },export =,import x = require()) need the ignore marker. Opt out of an intentionally partial fence with// codeblock-ignoreas the first non-blank line inside the fence. Limits: strict mode is off, so null misuse and implicitanyare not reported, and all fences share one type environment, so a fence can pass because another fence pulls in a global type. Failures print<mdx>:<line in the mdx file>. The console shows the first 10 failing fences followed byand M more ... not shown; setDOCS_TSC_ALL=1on the same command to print every failing fence, then filter that output by path to confirm one docs area. Generated files in gitignored.docs-snippets-tsc/are nameddocs__<path>.block<N>.<ext>. Do not re-check withyarn tsc --project tsconfig.docs-snippets.generated.json <files>(TS5042: project cannot mix with source files) or a full-projectyarn tsc -p(thetscCLI drops cross-file semantic diagnostics). For TS2307 on an@react-native-firebase/*package whosedist/typescriptis missing, the output names the prepare command from the agent command policy.yarn docs:member:check: blocking. For each.github/scripts/compare-types/configs/<pkg>.ts: (1) everyextraInRNname must be mentioned (prose or code) under that package's docs tree (perf-config→docs/perf,firestore-pipelines→docs/firestore), except names in theDEPRECATED_EXEMPTlist inscripts/docs-member-check.mjs(config basename → name → reason; each entry needs a non-empty reason, and an exempt name that docs still mention does not fail); (2) every runtime function the taught pages import by name from the package must be referenced by the matchingtest-expo/appscreen. The screen must value-import the name from the same specifier the docs use, and the local binding must appear as an identifier outside import statements (comments and strings do not count). This proves a reference, not a call. Taught pages aredocs/<docsPkg>/usage/**by default;appreadsdocs/app/**;firestore-pipelinesreadsdocs/firestore/pipelines/**and only the@react-native-firebase/firestore/pipelinesspecifier. A package that needs a screen and teaches zero names fails. Limits: namespace and default imports teach nothing;// codeblock-ignorefences still count as taught; a local that shadows an imported name is not detected. A screen control for an untaught function does not fail. Guards: everypackages/*directory with apackage.jsonneeds a compare-types config or anEXEMPT_PACKAGESentry with a reason (vertexai), and a stale exemption fails;NO_SCREENpackages (none today) fail if a screen file exists; the check verifies everyDEPRECATED_EXEMPTname is in that config'sextraInRNand that each top-level exported declaration of it underpackages/<docsPkg>/lib/**carries an@deprecatedJSDoc tag, so an exemption cannot hide a live API (only top-level declarations are seen: re-export specifiers,export { A as X }aliases, namespace members,export importand destructured exports are not, so such a name fails closed with "not found"), and a stale entry (config gone, name not inextraInRN, name not found in source, or no longer deprecated) fails. Migration guides are not packages.DOCS_MEMBER_VERBOSE=1lists the taught names and each verified deprecated exemption with its@deprecatedfile:line.
A JS-only (or docs-only) diff does not require full yarn lint. Full yarn lint is the CI equivalent when the diff spans those package trees and mutating lint:android is allowed (implementation). Full yarn lint still does not run Kotlin ktlintFormat.
Frozen review is report/check-only except revert .only. Do not run yarn lint:android, repo-root ./gradlew ktlintFormat, or full yarn lint — those formatters mutate the tree. Run the check-only by-diff scripts: lint:js (JS/TS), lint:deps (lib), lint:ios:check (ios), yarn lint:markdown/yarn lint:spellcheck/yarn lint:docs-links/docs:tsc:check/docs:member:check (docs tree or docs tooling only). There is no allowlisted check-only Kotlin ktlint task.
When docs/** is in the diff, yarn lint:docs-links exit code 0 is blocking (change authoring § validation evidence). Record it during documentation and re-confirm on frozen independent-review — change authoring § work types; missing that evidence when docs/** was touched is serious. Which failures are errors vs warnings, and the rnfirebase.io override: documentation site maintenance § Docs.page link check.
Agents must fix every error line (internal links, assets, MDX render, metadata, true external 404s). Do not hand off or close gates while errors remain.
The only acceptable non-fix is a warn on an external link where the checker reports a bot/WAF gate (common on npmjs.com, stackoverflow.com, some Google support URLs). Those URLs are often valid in a browser. Do not replace, remove, or “fix” those links to clear warnings, and do not relax check severity (flags or docs.json overrides) to hide real failures.
If an external link is a true 404 / not found at error severity, fix it like any other error. If unsure, verify in a browser; 403 from npm/SO in warn output alone is not grounds to change the link. An error that clears on re-run — a 5xx or timeout on any host, or a bot-gate status (e.g. 429) on rnfirebase.io — is a host/rate problem, not a broken link: re-run until exit 0; do not change the link or the override. One that fails on every re-run is a real breakage — fix it.
test-expo/ is a user-facing Expo example and the documented-path iOS link closer. Closer: yarn test-expo:ios:link only (build-only; does not launch) — agent command policy. Typecheck: yarn tsc:compile:test-expo. JS lint: yarn lint:js (already includes test-expo/; do not invent a second lint entrypoint). Not Detox; do not add yarn tests:ios:* or ad-hoc expo prebuild / xcodebuild / cd test-expo && … as those gates. App package: packages/app.
Workspace fixture test-rn-bare/: yarn test-rn-bare:ios:build then yarn test-rn-bare:ios:launch-smoke (iOS 27 UIScene gate; CI runs both, and again for the dynamic Firebase probe with facade-reference, framework-load, and configure assertions — probe launch smoke) — agent command policy. Not Detox; not the Expo link/launch closers; do not add yarn tests:ios:* or ad-hoc pod / xcodebuild / simctl as those closers. App package: packages/app.
Pre-flight (host-clear probes + services + checkout ownership + harness tier) before every run — agent command policy and e2e agent rule: use only yarn tests:* commands from running e2e. Match harness to work type — unit-focused/area-focused never use full app load (running e2e § harness).
Commands: Running e2e tests. Post-process: Coverage design (iOS tests:ios:test:process-coverage, Android tests:android:unit + tests:android:post-e2e-coverage → merged jacocoTestReport).
Some suites hit cloud APIs, e.g. Firestore Pipelines → pipelines-e2e Enterprise DB (pipelines.md).
When the frozen tree includes okf-bundle/ reference docs, AGENTS.md, or CONTRIBUTING.md, independent-review is this scan. Confirm every OKF update contract row: Canonical location, DRY, Efficiency, link hygiene, Durability. Report only — do not edit the frozen tree. The documentation work type promotes durable text; it does not run this scan. Close commit only after this scan when those files changed. Do not add OKF after a frozen review without another independent-review.
Goal: each iteration improves OKF and removes conflicting guidance. Check meanings live in the contract; do not treat this list as a thinner substitute.
Blocking. Before closing implementation_gate, review_gate, commit_gate, or publishing (git push / PR update), record evidence per change authoring § validation evidence. Minimum template:
| Step | Command | Exit | Evidence |
| ------------------------- | ------------------------------------ | ---- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| prepare | yarn lerna:prepare | 0 | — |
| jest | yarn tests:jest <paths> | 0 | N/N tests |
| ios Ruby unit | yarn tests:ios:ruby | 0 | when `packages/app/**/*.rb` or `packages/app/__tests__/*_test.rb` touched — coverage/ios-ruby/lcov.info ([§ iOS Ruby](#ios-ruby-unit-tests)) |
| android JVM unit | yarn tests:android:unit | 0 | when `packages/*/android/**` Java changed — [AndroidTest-AD-1](android-architecture-decisions.md#androidtest-ad-1) |
| ios XCTest unit | yarn tests:ios:unit | 0 | when `packages/*/ios/**` ObjC/C++ or `*UnitTests.xcodeproj` changed — [IosTest-AD-1](ios-architecture-decisions.md#iostest-ad-1) |
| e2e macOS | yarn tests:macos:test-cover | 0 | X passing — /tmp/...log |
| e2e iOS | yarn tests:ios:test-cover | 0 | Y passing — /tmp/...log |
| e2e Android | yarn tests:android:test-cover | 0 | Z passing — /tmp/...log |
| android merged Jacoco | yarn tests:android:post-e2e-coverage | 0 | jacocoTestReport.xml (unit + e2e) — [coverage design](coverage-design.md) |
| compare:types | yarn compare:types | 0 | <pkg> 0/0/0 |
| lint (by-tree) | [§ lint and formatting](#lint-and-formatting) | 0 | matching scripts; frozen review: check-only (no `lint:android` / `ktlintFormat` / full `yarn lint`) |
| lint:deps (lib diff) | yarn lint:deps | 0 | when `packages/*/lib/**` in diff — [dependency-cycle linting](../monorepo-tooling/prepare-and-cache.md#dependency-cycle-linting) |
| lint:markdown (CI docs) | yarn lint:markdown | 0 | when `docs/**` or docs tooling in diff (ESLint, snippet ESLint, Prettier; [§ gotchas](#docs-lint-gotchas)) |
| lint:spellcheck (CI docs) | yarn lint:spellcheck | 0 | when `docs/**` in diff |
| docs:tsc:check (CI docs) | yarn docs:tsc:check | 0 | when `docs/**` or docs tooling in diff; failed fence, fence-grammar error, or no compilable fence exits 1 |
| docs:member:check (CI docs) | yarn docs:member:check | 0 | when `docs/**`, docs tooling, compare-types configs, test-expo screens, or a new `packages/*` directory in diff |
| lint:docs-links (CI docs) | yarn lint:docs-links | 0 | when `docs/**` in diff — errors fail; bot-gate warnings do not |
| coverage | post-process + region table | — | [coverage evidence package](coverage-design.md#coverage-evidence-package); closes `coverage_evidence_gate` when lib/native bridge or `packages/app/**/*.rb` touched |Exit codes must be the real ones: the agent shell is zsh, where ${PIPESTATUS[0]} silently expands to empty — agent command policy § agent shell is zsh.
History rewrite invalidates prior rows — re-run and replace the table after amend/rebase.
-
yarn lerna:prepare(after anypackages/*/lib/**edits) -
yarn tsc:compile,yarn tsc:compile:consumer -
yarn tsc:compile:test-expowhentest-expo/**TS is in the diff (agent command policy) -
yarn attw:checkwhenpackage.jsonexports,plugin/build, or published types changed (Types-AD) -
yarn reference:api - Redirect audit when TypeDoc config changed (documentation site maintenance § redirect audit)
-
yarn tests:jest -
yarn tests:ios:rubywhenpackages/app/**/*.rborpackages/app/__tests__/*_test.rbtouched (§ iOS Ruby; coverage design) -
yarn tests:android:unitwhenpackages/*/android/**Java /src/test/javachanged (AndroidTest-AD-1) -
yarn tests:ios:unitwhenpackages/*/ios/**ObjC/C++ orpackages/*/ios/*UnitTestschanged (IosTest-AD-1) - TurboModule wrapper contract (NewArch-AD-17.1) when
packages/app/lib/internal/registry/nativeModule.ts,nativeModuleAndroidIos.ts, or TurboModule wrapper behavior changed:yarn tests:jest -- packages/app/__tests__/nativeModuleContract.test.ts -
yarn compare:types(stale config entries removed) - Lint by-tree / by-diff per § lint and formatting (frozen
independent-review: check-only — noyarn lint:android/./gradlew ktlintFormat/ fullyarn lint) - E2e green on every required platform for the changed module (platform coverage gate; harness narrowing gate; no
.only; committedRNFBDebugremainsfalse) - Android post-e2e merged Jacoco when Android native touched:
yarn tests:android:post-e2e-coverage→jacocoTestReport.xml(coverage design) - Validation evidence package recorded (exit codes, e2e counts, log paths)
- Coverage evidence package when lib/native bridge or
packages/app/**/*.rbtouched —coverage_evidence_gateclosed with verdict line; gaps investigated to fix, delete, or acceptable-exception bar - Durable OKF /
AGENTS.md/CONTRIBUTING.mdpromoted indocumentationbefore frozen review; OKF bundle scan completed inindependent-reviewwhen those files changed (contract findings →documentation?then re-scan, notcommit-pass edits)
Package workflows may add items (e.g. pipeline before/after snapshots — pipeline workflow).