OpenParable
Skip to content
← Back to skills

Farm Ready Gate

Testing & Quality
farm-ready-gate

Farm Ready Gate is an Agent Skill for testing & quality published in the farm-fe/farm repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Run Farm verification with build-first constraints. For verify/acceptance, use npm run build only for core, rust plugins, and affected examples; do not run cargo check/clippy. Use when validating changes before merge or push.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/farm-fe/farm/blob/HEAD/.claude/skills/farm-ready-gate/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/farm-ready-gate, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Run repository verification with build-first constraints. For verify/acceptance, default to npm run build only.

Verify Constraints (MANDATORY)

  1. All build verification for core and Rust plugins must use npm run build.
  2. Verify flow must not run cargo build, cargo check, or cargo clippy.
  3. For examples, verify by running npm run build in each affected example directory.
  4. Only run pnpm run ready when the user explicitly asks for full CI parity.

Tiered Verification (choose one tier before running anything)

Tier 1 — Bug Fixes & Simple/Localized Changes

Use when: fixing a bug, changing a single package/crate/plugin, adding a small localized feature.

Steps (run in order, stop at first failure):

  1. Build @farmfe/core (always required — it is the central dependency):
pnpm --filter @farmfe/core run build
  1. Build affected Rust plugin packages (from each changed plugin directory):
 npm run build
  1. Build affected examples (every example that exercises the changed feature):
cd examples/<name> && npm run build

If all three steps pass, verification is PASS.


Tier 2 — Complex / Multi-Package Changes & Pre-Release Gate

Use when: refactoring across multiple packages/plugins, changing plugin/compiler APIs, touching build infrastructure.

Default verify flow (still build-only):

pnpm --filter @farmfe/core run build
# then run npm run build in each changed rust-plugin/js-plugin/example package

Optional CI parity flow (only if explicitly requested):

pnpm run ready

Do not switch to this flow automatically.

Ready Flow Reference (from scripts/ready.mjs)

When pnpm run ready is explicitly requested, the script runs checks in this order:

  1. Install dependencies (pnpm install)
  2. Clean artifacts (node ./scripts/clean.mjs)
  3. Spell check (npx cspell "**" --gitignore)
  4. Build core/plugins/cli via runTaskQueue
  5. Cargo check (cargo check --color always --all --all-targets)
  6. Cargo clippy (cargo clippy)
  7. TypeScript checks (pnpm run --filter "@farmfe/*" type-check)
  8. Unit tests (pnpm run test)
  9. Rust tests (cargo test -j <cpu_based_jobs>)
  10. Build core CJS (buildCoreCjs)
  11. Build examples (buildExamples)
  12. E2E tests (pnpm run test-e2e)

Execution Policy

  1. Determine tier based on change scope before running any commands.
  2. For verify/acceptance, default to build-only checks using npm run build.
  3. Do not run cargo check or cargo clippy in verify flow.
  4. Run pnpm run ready only when explicitly requested by the user.
  5. Do not claim success unless all chosen-tier steps exit with code 0.

Output Format

  • Result: PASS or FAIL
  • Command: exact command executed
  • Failure Step: if failed, map to ready flow item number/name
  • Next Action: one concrete fix direction

Guardrails

  • Do not skip steps unless user explicitly requests a partial check.
  • Preserve current git changes; do not revert files automatically.
  • Keep logs summarized; include only the key failing lines.