SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillspre-merge-gate

pre-merge-gate

Coding & development

View repository

Updated 10-15 22:13

About this skill

Pre-merge Gate

Subagents (default)

Run gate via Task shell subagent: pre_merge_gate.py. Main chat triages FAIL lines and re-delegates fixes. See reference/subagents.md.

When to use

  • QA wants a single green/red report before approving a PR
  • Before merging to main / dev
  • After addressing review feedback: confirm all gates pass

Hard stop

The script exits 1 if any check is FAIL. Do not treat a markdown BLOCKED report with exit 0 as merge-ready — that bug is fixed. Agents must not merge (or say merge-ready) unless the process exits 0.

Instructions

  1. Run python .agents/skills/pre-merge-gate/scripts/pre_merge_gate.py --project-root <root>.
  2. Read the markdown report: each check shows PASS/FAIL/SKIP.
  3. Fix failing checks and re-run until exit code is 0.

Eval / harness turns: When the eval harness captures Playwright proof separately, run with --skip-visual-audit so the gate does not invoke contrast audit (no Playwright in agent turn).

Checks

Required when the tree exists

  • setup audit (@heyeddi-setup verify_setup --check: incomplete prefs fail)
  • npm test + production build (package.json)
  • vue-tsc --noEmit when node_modules is present (FAIL if frontend exists but toolchain missing)
  • backend pytest (backend/tests, prefers backend/.venv)
  • ruff F821 on backend/app (undefined names / dropped imports)
  • engineering audit (@engineering-excellence audit_engineering --check: errors fail; warns advisory)

Optional (SKIP allowed if skill/tool missing; FAIL still hard-stops)

  • duplicate UI scan (no-duplicate-ui)
  • prose audit (heyeddi-design verify_prose.py) — always-on for copy; skip only in emergency
  • contrast audit on product routes (visual-auditor; SKIP if Playwright missing)

Flags: --skip-duplicate-ui, --skip-prose-audit, --skip-engineering-audit, --skip-setup-audit, --skip-visual-audit. --skip-backend, --skip-engineering-audit, and --skip-setup-audit are emergency-only and must not be used for merge sign-off.

When the task is complete: suggest next skills

When you have finished the user's request for this skill (not after every tool call or subagent phase), suggest what to run next:

  1. Run:

    python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill pre-merge-gate --project-root .

    Add --route /path if you worked a specific route.

  2. Include the script's ### Next step block in your final reply. The user copies the Prompt line into chat (e.g. @heyeddi-design craft /settings).

Pass --mode shape (or craft, audit, etc.) when you know which sub-command just finished.

See @heyeddi → reference/next-skill-handoff.md.