Formax Test Stability Workflow

Use when adding or fixing Formax tests (especially Ink UI tests) and you need deterministic synchronization in test interactions.

yusifeng Updated 184 repo stars
Picture from the README

File contents

Formax Test Stability Workflow

Goal

  • Write stable UI tests with explicit state sync.

Do

  • Wait for target state before next key (example: wait ❯ 3. before typing feedback).

  • Assert final behavior, not transient cursor frames (example: assert feedback aXb, not a▏b).

  • In multi-step input flows, wait for idle state between steps (example: placeholder/queue-hint settled).

  • Extract repeated sync steps into local helpers (example: selectFeedbackRow, queueMessageWhileLoading).

Don't

  • Do not fix flakes by only increasing timeout.
  • Do not use long sleep as synchronization.
  • Do not bind assertions to fragile render glyphs/spacing.

yusifeng/formax commit 8430c9d18c

Frequently asked questions

npx get-skill add yusifeng/formax-test-stability-workflow