TodeX

Imported from youtonghy/TodeX (AGENTS.md). Install upstream with npx skills add youtonghy/TodeX. Copyright stays with the author.

Agent Instructions

Frontend UI

• All user-facing UI must use the official HeroUI Native components from heroui-native. Prefer the existing component APIs over raw React Native controls or ad-hoc replacements.

• Before adding or changing a component, query the current HeroUI Native documentation through the Context7 MCP (resolve-library-id followed by query-docs). Use the documented API and verify the installed version in package.json.

• Use heroui-native for controls such as buttons, inputs, dialogs, menus, lists, tabs, and feedback states. React Native primitives remain appropriate for layout, platform integration, and cases where HeroUI Native has no equivalent.

• Install or update HeroUI through hpsetup from this project. The command must read its credential from the HEROUI_KEY system environment variable; never commit, log, or hard-code that key.

• If HEROUI_KEY is unavailable, stop before running an authenticated hpsetup operation and report the missing environment variable. Do not substitute a value from source files, shell history, or local config.

• After completing each task, create one or more Git commits for the changes made in that task.

• Group commits by change category or repository responsibility when the task includes unrelated changes.

• Run the relevant validation commands before committing whenever practical, and mention any validation that could not be run.

• Push the created commits to the current branch's upstream remote after committing.

• If committing or pushing is blocked, report the blocker explicitly and leave the working tree status clear in the final response.

• Do not include unrelated local changes in a task commit. Preserve user changes unless the user explicitly asks to modify or discard them.