yusifeng/formax

Analyze Task helps assess a non-trivial Formax change before coding by defining goals, boundaries, impacts, risks, and test strategy. Use it to decide whether a subagent is needed and whether the work is ready for a todo.

Approval UI Workflow keeps approval prompts and presenters visually consistent while preserving keyboard flow and safe preview rendering. Use it when adding or changing Approval prompt UI or diff previews.

Expanded Transcript Workflow covers Ctrl+O expanded transcript behavior and thinking persistence in the REPL. Use it when changing transcript projection boundaries, read-only expanded panels, or clear and remount behavior.

Formax Config Settings Workflow covers changing runtime config merge semantics, /config persistence, and settings exposed in the config dialog. Use it when adding or extending config behavior with tests and strict UI parity.

Formax Dev Loop helps you work on Formax changes with a single mainline task, targeted tests, required review before commit, and small reviewable commits. Use it when you need a tight dev loop without scope drift or partial staging.

Formax Permissions Workflow is used when changing or debugging Formax permission rules, approval prompts, workspace boundaries, and /permissions management. It covers policy preflight, matching, persistence, and UI parity with Claude Code.

Formax Repomix Handoff Workflow creates a clean code handoff package for another AI by selecting files, building a repomix bundle, and writing a constrained prompt with validation scope. Use it when preparing a Formax task for WebGPT or another coding agent.

Formax Rework Convergence cleans up code after repeated edits by removing redundancy, restoring structure, and keeping behavior unchanged. Use it for a focused cleanup pass when churn has introduced drift or tangled logic.

Formax Rolling Plan Loop Workflow creates and maintains a rolling execution plan with a README and TODO-INDEX. Use it when you want small validated loops of implementation, targeted testing, review, and commit steps.

Formax Script Output Placement guides where generator scripts should write files, keeping generated artifacts out of docs/ and near their owning app or script. Use it when adding or changing scripts with output paths and CI checks.

Formax Semantics Parity Workflow is for changing behavior that must stay consistent across TUI, app-server, and Web, including mode, input lifecycle, tool sequencing, replay, and ordering. Use it to update canonical semantics first, then adapters and renderer-specific UI.

Formax Skill Capture turns a finished Formax workflow into a repo-local Codex skill under .codex/skills. Use it to scaffold the skill, document file changes, guardrails, and the minimum regression tests.

Formax Slash Command Workflow guides changes to slash command discovery, dispatch, overlay dismissal output, and next-turn injection behavior. Use it when editing command routing or the UI/model split for command results.

Formax Surface Reset Workflow is used when changing REPL clear, reset, resume, or surface transition behavior. It helps keep transcript resets owned by one transaction and avoid black-screen, flicker, and duplicate-row regressions.

Formax System Prompt Workflow guides changes to system prompt assembly, reminder injection, and deferred tool exposure in Formax. Use it when updating prompt parity, request-scoped helper blocks, or skills presentation semantics.

Formax Test Stability Workflow helps add or fix Formax tests with deterministic synchronization. Use it for Ink UI tests that need explicit waits, stable assertions, and reusable sync helpers.

Formax Tool UI Blocks Workflow standardizes tool transcript spacing and indent rules with a centralized blocks renderer. Use it when refactoring tool presenters, migrating simple tools to blocks presenters, or adding focused Ink and Vitest tests.

Formax Web CSS Convergence Workflow locks requirements, state ownership, and acceptance checks before CSS or UI edits. Use it for layout changes, styling tweaks, and repeated visual convergence work.

Formax Web Style System applies a business-agnostic desktop web visual style to frontend and UI tasks. Use it to harmonize existing design systems or to define token-first styling, spacing, and interaction states.

Playwright Cli automates browser actions for web testing, form filling, screenshots, and data extraction. Use it when you need to navigate sites, interact with pages, or debug web apps.

WebGPT Todo Response generates a concise handoff back to WebGPT after reviewing a Formax todo. It highlights what was adopted, what needs pushback, and which parts of `docs/todolist.md` should be re-evaluated.

Write Task Todo turns a Formax task analysis into a single docs/todolist.md with ordered implementation slices, tests, explicit non-goals, and loop-ready review items. Use it after analysis is aligned for non-trivial repository work.