# Formax Test Stability Workflow

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

- Skill: `yusifeng/formax-test-stability-workflow` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yusifeng/formax-test-stability-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yusifeng/formax-test-stability-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: yusifeng (https://skillmd.com/u/yusifeng)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yusifeng/formax-test-stability-workflow

---


# 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.