// Use when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions). Enforces single-owner reset transaction and prevents black-screen/flicker/duplicate-row regressions.
| name | formax-surface-reset-workflow |
| description | Use when changing REPL clear/reset/resume/surface behavior (onClearTerminal, transcriptSeq remount, Ink Static paths, Ctrl+O/Ctrl+E transitions). Enforces single-owner reset transaction and prevents black-screen/flicker/duplicate-row regressions. |
Use this skill when changing REPL clear/reset/resume behavior or any transcript surface transition that can remount Static.
docs/contracts/transcript-surface-contract.mddocs/runbooks/repl-surface-debugging.mddocs/contracts/invariants.md when ownership or sequencing is unclearThese docs are canonical. If stable surface behavior changes, update them before or with code.
replaceTranscriptqueueTranscriptSurfaceReplaceresetTranscriptSurfacequeueTranscriptSurfaceResetsurfaceOpQueueRefpackages/core/src/features/repl/controller/ui/packages/core/src/features/repl/controller/session/packages/core/src/features/repl/useReplController.tspackages/core/src/screens/repl/packages/core/src/runtime/bootstrap/runLegacyCli.tsxonClearTerminalclearTerminalresetInkStaticOutputForStdouttranscriptSeq remount behavior in ReplTranscript / ExpandedReplTranscriptUse this skill whenever the change touches any of:
/resume, /clear, compact boundary transitionsonClearTerminal, clearTerminal, or resetInkStaticOutputForStdoutreplaceTranscript, queueTranscriptSurfaceReplace, resetTranscriptSurface, queueTranscriptSurfaceReset, or surfaceOpQueueRefpackages/core/src/features/repl/controller/ui/, packages/core/src/features/repl/controller/session/, packages/core/src/features/repl/useReplController.ts, packages/core/src/screens/repl/, or packages/core/src/runtime/bootstrap/runLegacyCli.tsx/resume, /clear, Ctrl+O / Ctrl+E, compact boundary, etc.).replaceTranscript / resetTranscriptSurface instead of local clear / remount sequencing.bun run test -- packages/core/src/features/repl/controller/ui/surfaceReset.test.tsbun run test -- packages/core/src/features/repl/useReplController.test.tsx -t "resume|clear|compact"bun run test -- packages/core/src/screens/repl/surfaceSmoke.test.tsxbun run type-checkbun run test:surface-screen-modelreplInstance.clear() and ANSI clear in legacy paths unless ownership is explicit and serialized.docs/pitfalls/summary.md sections covering /clear, compact + Ctrl+O, and resume black-screen regressionsdocs/pitfalls/repl-transcript-surface-handoff-pitfall.mddocs/pitfalls/repl-transcript-static-rootcause.mdUse when a Formax repository task is non-trivial and you should analyze goals, non-goals, boundaries, data/type/interface impact, contract impact, test strategy, and whether an xhigh subagent is actually needed before writing a todo or code.
Use after receiving WebGPT or another LLM review on a Formax todo and before sending the todo back for another pass. Produce a concise handoff response that says what we adopted, what we reject or question, and what the reviewer should specifically re-evaluate in `docs/todolist.md`.
Use after task analysis when a non-trivial Formax repository task needs a structured `docs/todolist.md` with [x]/[ ] items, definitions-before-UI ordering, explicit non-goals, tests, and loop-ready execution slices.
Use when the user wants a reusable rolling execution pattern (README + TODO-INDEX) like plans/web-reference-react-refactor, and wants to run delivery in small validated loops.
Use when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn.
Use for all frontend and web UI tasks by default to apply a business-agnostic desktop web visual style system with medium-strength guardrails; if an existing design system is present, follow it first and use this skill only as a style harmonizer.